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
126 lines
6.0 KiB
Markdown
126 lines
6.0 KiB
Markdown
# 多层嵌套Agent设计文档
|
||
|
||
## 文档结构
|
||
|
||
```
|
||
docs/design/nested-agent/
|
||
├── README.md # 本文件 - 文档索引
|
||
├── nested-agent-design.md # 核心设计文档
|
||
└── prompts/ # Agent Prompt模板
|
||
├── strictPlan.md # StrictPlan (L0)
|
||
├── strictSpec.md # StrictSpec (L0)
|
||
├── requirement.md # Requirement (L1)
|
||
├── design.md # DesignAgent (L1)
|
||
├── task.md # TaskPlan (L1)
|
||
├── coding.md # SubCoding (L1)
|
||
├── explore.md # QuickExplore (L2)
|
||
├── tdd.md # TDD流程
|
||
└── writeTask.md # WriteTask
|
||
```
|
||
|
||
## 快速导航
|
||
|
||
### 核心设计
|
||
- [nested-agent-design.md](./nested-agent-design.md) - 整体架构、Agent定义、深度控制矩阵
|
||
|
||
### Agent Prompts (基于现有实现)
|
||
| Agent | 层级 | Prompt文件 |
|
||
|-------|------|-----------|
|
||
| StrictPlan | L0 | [strictPlan.md](./prompts/strictPlan.md) |
|
||
| StrictSpec | L0 | [strictSpec.md](./prompts/strictSpec.md) |
|
||
| Requirement | L1 | [requirement.md](./prompts/requirement.md) |
|
||
| DesignAgent | L1 | [design.md](./prompts/design.md) |
|
||
| TaskPlan | L1 | [task.md](./prompts/task.md) |
|
||
| SubCoding | L1 | [coding.md](./prompts/coding.md) |
|
||
| QuickExplore | L2 | [explore.md](./prompts/explore.md) |
|
||
|
||
## 架构总览
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────────┐
|
||
│ 用户请求 │
|
||
└─────────────────────────────────────────────────────────────────────────────┘
|
||
│
|
||
┌───────────────┴───────────────┐
|
||
▼ ▼
|
||
┌───────────────────────┐ ┌───────────────────────┐
|
||
│ StrictSpec (L0) │ │ StrictPlan (L0) │
|
||
│ 工作流编排Agent │ │ 计划执行Agent │
|
||
└───────────────────────┘ └───────────────────────┘
|
||
│ │
|
||
▼ │
|
||
┌───────────────────────┐ │
|
||
│ Requirement (L1) │ │
|
||
└───────────────────────┘ │
|
||
▼ │
|
||
┌───────────────────────┐ │
|
||
│ DesignAgent (L1) │ │
|
||
└───────────────────────┘ │
|
||
▼ │
|
||
┌───────────────────────┐ │
|
||
│ TaskPlan (L1) │ │
|
||
└───────────────────────┘ │
|
||
▼ │
|
||
┌───────────────────────┐ │
|
||
│ SubCoding (L1) │ ──────────────────┘
|
||
└───────────────────────┘
|
||
│
|
||
┌───────────┼───────────┐
|
||
▼ ▼ ▼
|
||
┌─────────┐ ┌─────────┐ ┌─────────┐
|
||
│ Quick │ │ Sub │ │ TDD │
|
||
│Explore │ │ Coding │ │ Agents │
|
||
│ (L2) │ │ (L2) │ │ │
|
||
└─────────┘ └─────────┘ └─────────┘
|
||
```
|
||
|
||
## Agent定义（现有实现）
|
||
|
||
| Agent | 文件路径 | 层级 | 职责 |
|
||
|-------|---------|------|------|
|
||
| StrictPlan | `src/costrict/agents/strictPlan.ts` | L0 | 需求→探索→澄清→提案→实施 |
|
||
| StrictSpec | `src/costrict/agents/strictSpec.ts` | L0 | 工作流编排 |
|
||
| Requirement | `src/costrict/agents/requirement.ts` | L1 | 需求分析 |
|
||
| DesignAgent | `src/costrict/agents/designAgent.ts` | L1 | 架构设计 |
|
||
| TaskPlan | `src/costrict/agents/taskPlan.ts` | L1 | 任务规划 |
|
||
| SubCoding | `src/costrict/agents/subCoding.ts` | L1 | 编码实施 |
|
||
| QuickExplore | `src/costrict/agents/quickExplore.ts` | L2 | 代码探索 |
|
||
|
||
## TDD集成
|
||
|
||
### TDD相关Agent
|
||
|
||
| Agent | 文件路径 | 职责 |
|
||
|-------|---------|------|
|
||
| tddRunAndFix | `src/costrict/agents/tddRunAndFix.ts` | 执行测试并修复 |
|
||
| tddTestDesign | `src/costrict/agents/tddTestDesign.ts` | 测试用例设计 |
|
||
| tddTestAndFix | `src/costrict/agents/tddTestAndFix.ts` | 测试设计与修复 |
|
||
| tddTestPrepare | `src/costrict/agents/tddTestPrepare.ts` | 测试准备 |
|
||
|
||
### TDD Skill
|
||
|
||
- 文件: `src/costrict/skill/tdd.ts`
|
||
- 命令: `/test`
|
||
|
||
## 深度控制
|
||
|
||
| Agent | 可spawn | 叶子节点 |
|
||
|-------|---------|----------|
|
||
| StrictPlan | QuickExplore, SubCoding | - |
|
||
| StrictSpec | Requirement, DesignAgent, TaskPlan, SubCoding | - |
|
||
| SubCoding | QuickExplore, TDD | - |
|
||
| QuickExplore | - | ✓ |
|
||
|
||
## 使用示例
|
||
|
||
```
|
||
# 使用StrictPlan
|
||
/strict-plan 实现一个计算器
|
||
|
||
# 使用StrictSpec完整流程
|
||
/strict-spec 实现一个用户登录系统
|
||
|
||
# 使用TDD
|
||
/test
|
||
```
|