y574444354 6f233a6586 feat(costrict): add depthGuard agent and refine strictPlan/strictSpec workflow

- Add depthGuard agent for depth-limiting sub-agent orchestration
- Update strictPlan/strictSpec agents with improved task handling
- Refresh builtin skill registry
- Update builtInAgents with depthGuard integration
- Add nested-agent design docs and user guide
- Update README_EN with project documentation

2026-04-10 21:42:53 +08:00

3.5 KiB

Raw Blame History

多层嵌套Agent系统 - 实施计划

一、当前状态分析

1.1 已实现的Agent

Agent	文件路径	状态	说明
StrictPlan	`src/costrict/agents/strictPlan.ts`	✅ 正常	计划执行入口
StrictSpec	`src/costrict/agents/strictSpec.ts`	❌ 被注释	工作流编排（需启用）
Requirement	`src/costrict/agents/requirement.ts`	✅ 正常	需求分析
DesignAgent	`src/costrict/agents/designAgent.ts`	✅ 正常	架构设计
TaskPlan	`src/costrict/agents/taskPlan.ts`	✅ 正常	任务规划
SubCoding	`src/costrict/agents/subCoding.ts`	✅ 正常	编码实施
QuickExplore	`src/costrict/agents/quickExplore.ts`	✅ 正常	代码探索

1.2 需要修复的问题

StrictSpec被注释 - builtInAgents.ts 第9行和第67行
深度控制缺失 - 没有实现深度守卫机制
TDD流程不完整 - TDD Agent未正确集成到StrictPlan/SubCoding流程

二、实施步骤

步骤1: 启用StrictSpec Agent

文件: src/tools/AgentTool/builtInAgents.ts

// 第9行 - 取消注释导入
- // import { STRICT_SPEC_AGENT } from '../../costrict/agents/strictSpec.js'
+ import { STRICT_SPEC_AGENT } from '../../costrict/agents/strictSpec.js'

// 第67行 - 取消注释注册
- // STRICT_SPEC_AGENT,
+ STRICT_SPEC_AGENT,

步骤2: 实现深度守卫机制

新建文件: src/costrict/agents/depthGuard.ts

// 深度守卫 - 防止无限嵌套
export interface DepthContext {
  depth: number
  maxDepth: number
  currentAgent: string
}

// 检查是否可以继续spawn
export function canSpawn(context: DepthContext): boolean {
  return context.depth < context.maxDepth
}

// 获取当前深度状态
export function getDepthStatus(context: DepthContext): string {
  if (context.depth >= context.maxDepth) {
    return 'LEAF_NODE'
  }
  return `DEPTH_${context.depth}`
}

步骤3: 更新SubCoding以支持深度传递

文件: src/costrict/agents/subCoding.ts

需要添加：

接收深度参数
在spawn子Agent时传递深度+1
禁止在深度达到上限时spawn

步骤4: 集成TDD到Coding流程

文件: src/costrict/agents/subCoding.ts

在Coding流程中嵌入TDD调用：

检测任务是否需要TDD
如果需要，spawn TDD相关Agent

三、深度控制设计

3.1 深度层级定义

L0: StrictPlan / StrictSpec (入口)
L1: Requirement, DesignAgent, TaskPlan, SubCoding
L2: QuickExplore, TDD Agents (叶子节点)

3.2 深度传递规则

父Agent	子Agent	深度变化	允许spawn
StrictPlan	QuickExplore	0→1	✅
StrictPlan	SubCoding	0→1	✅
SubCoding	QuickExplore	1→2	❌ (叶子)
SubCoding	TDD	1→2	✅
StrictSpec	Requirement	0→1	✅
Requirement	-	1	❌ (无spawn)
DesignAgent	-	1	❌ (无spawn)
TaskPlan	-	1	❌ (无spawn)

四、文件清单

src/costrict/agents/
├── depthGuard.ts           # [新建] 深度守卫
├── strictSpec.ts          # [修改] 启用
├── subCoding.ts          # [修改] 添加深度传递
└── ...

src/tools/AgentTool/
└── builtInAgents.ts       # [修改] 启用StrictSpec

五、实施优先级

P0 - 立即修复: 启用StrictSpec Agent
P1 - 核心功能: 实现深度守卫
P2 - 增强功能: TDD集成
P3 - 优化: 完善错误处理和日志

3.5 KiB Raw Blame History Unescape Escape