6f233a6586
- 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
124 lines
3.5 KiB
Markdown
124 lines
3.5 KiB
Markdown
# 多层嵌套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 需要修复的问题
|
||
|
||
1. **StrictSpec被注释** - `builtInAgents.ts` 第9行和第67行
|
||
2. **深度控制缺失** - 没有实现深度守卫机制
|
||
3. **TDD流程不完整** - TDD Agent未正确集成到StrictPlan/SubCoding流程
|
||
|
||
## 二、实施步骤
|
||
|
||
### 步骤1: 启用StrictSpec Agent
|
||
|
||
**文件**: `src/tools/AgentTool/builtInAgents.ts`
|
||
|
||
```diff
|
||
// 第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`
|
||
|
||
```typescript
|
||
// 深度守卫 - 防止无限嵌套
|
||
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
|
||
```
|
||
|
||
## 五、实施优先级
|
||
|
||
1. **P0 - 立即修复**: 启用StrictSpec Agent
|
||
2. **P1 - 核心功能**: 实现深度守卫
|
||
3. **P2 - 增强功能**: TDD集成
|
||
4. **P3 - 优化**: 完善错误处理和日志
|