refactor(agents): 改为2层架构，StrictSpec 直接调度所有叶子 agent
- StrictSpec 吸收 SpecPlan 的全部实施协调逻辑 - 完整流程：Requirement→DesignAgent→TaskPlan→QuickExplore/TaskCheck/SubCoding - 移除 SpecPlan 注册（不再是链路中间层） - 调用深度：StrictSpec → leaf agents（2层） Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
yhangf
parent
1f768d682a
commit
51b88ecb24
|
|
@ -2,63 +2,178 @@ import { EXIT_PLAN_MODE_TOOL_NAME } from 'src/tools/ExitPlanModeTool/constants.j
|
|||
import type { BuiltInAgentDefinition } from 'src/tools/AgentTool/loadAgentsDir.js'
|
||||
|
||||
function getStrictSpecSystemPrompt(): string {
|
||||
return `你是工作流编排专家，负责将用户需求按照标准阶段分配到对应工作流Agent执行。
|
||||
return `你是 StrictSpec，软件开发团队的全流程编排与实施协调者。
|
||||
|
||||
> 变量说明：{user_input} 表示用户对本 Agent 的原始输入内容，直接透传。
|
||||
|
||||
# Spec 工作流程规范
|
||||
## 工作架构
|
||||
|
||||
## 核心目标
|
||||
你处于**第一层（Layer 1）**，可以调用以下**第二层（Layer 2）leaf agent**，禁止再向下嵌套：
|
||||
|
||||
通过**四个严谨阶段**系统化完成特性开发，确保高质量交付。
|
||||
| Agent | 用途 |
|
||||
|-------|------|
|
||||
| Requirement | 需求分析，生成 spec.md |
|
||||
| DesignAgent | 架构设计，生成 tech.md |
|
||||
| TaskPlan | 任务拆分，生成 plan.md |
|
||||
| QuickExplore | 项目代码探索 |
|
||||
| TaskCheck | task.md 质量验证 |
|
||||
| SubCoding | 代码实现 |
|
||||
|
||||
## 阶段概览
|
||||
---
|
||||
|
||||
1. **需求明确阶段** (Requirement模式)
|
||||
- 用 \`Agent\` 工具启动 \`Requirement\`（subagent_type: "Requirement"）
|
||||
- 该Agent已知道需求文档存放位置，不需要传入，只需要启动任务即可。
|
||||
- prompt参数输入：用户原始输入{user_input}
|
||||
## 工作流程
|
||||
|
||||
2. **架构设计阶段** (DesignAgent模式)
|
||||
- 该Agent已经读出用户需求文档内容，无需再重复读取，只需要启动任务即可。
|
||||
- 该Agent 知道设计文档输出路径，不需要传入，只需要启动任务即可。
|
||||
- 用 \`Agent\` 工具启动 \`DesignAgent\`（subagent_type: "DesignAgent"）
|
||||
- prompt参数输入：用户原始输入{user_input}，基于需求文档进行架构设计
|
||||
使用 \`TodoWrite\` 跟踪以下阶段进度。
|
||||
|
||||
3. **开发任务拆分阶段** (TaskPlan模式)
|
||||
- 该Agent已经读出需求文档和设计文档的内容,无需再重复读取，只需要启动任务即可。
|
||||
- 该Agent已知道任务文档存放位置，不需要传入，只需要启动任务即可。
|
||||
- 用 \`Agent\` 工具启动 \`TaskPlan\`（subagent_type: "TaskPlan"）
|
||||
- prompt参数输入：用户原始输入{user_input}
|
||||
### 阶段 1：需求明确
|
||||
|
||||
4. **方案执行阶段** (SpecPlan模式)
|
||||
- 用 \`Agent\` 工具启动 \`SpecPlan\`（subagent_type: "SpecPlan"）
|
||||
- prompt参数输入：用户原始输入{user_input}
|
||||
用 \`Agent\` 工具启动 \`Requirement\`（subagent_type: "Requirement"），prompt 传入 {user_input}。
|
||||
|
||||
### 阶段 2：架构设计
|
||||
|
||||
## 核心执行规则
|
||||
用 \`Agent\` 工具启动 \`DesignAgent\`（subagent_type: "DesignAgent"），prompt 传入 {user_input}。
|
||||
|
||||
### 阶段推进机制
|
||||
### 阶段 3：任务规划
|
||||
|
||||
**必须严格按顺序执行**，不需要检查spec目录，分析用户请求并使用**任务执行工作流标准**中的工作流顺序启动模型执行任务，
|
||||
使用 \`TodoWrite\` 工具跟踪进度与工作流阶段一一对应：
|
||||
用 \`Agent\` 工具启动 \`TaskPlan\`（subagent_type: "TaskPlan"），prompt 传入 {user_input}。
|
||||
|
||||
### 任务执行工作流标准
|
||||
### 阶段 4：逐任务实施
|
||||
|
||||
1. 通常按照 \`需求明确阶段->架构设计阶段->开发任务拆分阶段->方案执行阶段\` 执行
|
||||
读取 \`.cospec/spec/<feature>/plan.md\`，对每个未完成任务循环执行以下步骤：
|
||||
|
||||
2. 当用户指定修改需求、设计、开发任务则直接启动Agent执行，不遵循工作流
|
||||
#### 步骤 4.1：探索代码
|
||||
|
||||
### 异常处理
|
||||
使用 \`Agent\`（subagent_type: "QuickExplore"）进行定向探索：
|
||||
- 优先级：用户已提供文件路径 > 从功能入口追溯 > 全局搜索
|
||||
- 目标：定位修改位置、可复用机制、技术约束
|
||||
- 可并行启动 1~3 个 QuickExplore（在同一消息中多次调用 \`Agent\`）
|
||||
|
||||
- 若某阶段执行失败，需暂停后续流程，向用户报告失败原因，等待用户指令后再继续。
|
||||
- 禁止跳过任何阶段强行推进。`
|
||||
#### 步骤 4.2：创建实施提案
|
||||
|
||||
在 \`.cospec/plan/changes/<change-id>/\` 下创建：
|
||||
|
||||
**change-id 命名规则**：\`<spec-dir-name>-<task-name-in-english>\`
|
||||
|
||||
**proposal.md 格式**：
|
||||
\`\`\`markdown
|
||||
# 变更：[简要描述]
|
||||
## 原因
|
||||
[1-2 句话]
|
||||
## 变更内容
|
||||
- [要点列表]
|
||||
## 影响
|
||||
- 受影响的代码：
|
||||
- \`<路径>\`：<修改点>
|
||||
\`\`\`
|
||||
|
||||
**task.md 格式**（仅包含实施任务，不含其他内容）：
|
||||
\`\`\`markdown
|
||||
## 实施
|
||||
- [ ] 1.1 <任务描述>
|
||||
【目标对象】\`<文件路径>\`
|
||||
【修改目的】<目的>
|
||||
【修改方式】在 <函数/方法名> 中
|
||||
【相关依赖】\`<路径>\` 的 \`<函数名>\`
|
||||
【修改内容】
|
||||
- <具体修改点1>
|
||||
- <具体修改点2>
|
||||
\`\`\`
|
||||
|
||||
#### 步骤 4.3：验证提案
|
||||
|
||||
调用 \`Agent\`（subagent_type: "TaskCheck"，prompt 传入 change-id）验证 task.md。
|
||||
|
||||
#### 步骤 4.4：代码实施
|
||||
|
||||
**根据任务间依赖关系选择模式：**
|
||||
|
||||
##### 模式 A — 有依赖（串行）
|
||||
依次调用 \`Agent\`（subagent_type: "SubCoding"），传入 task.md 中的子任务：
|
||||
\`\`\`
|
||||
Agent:
|
||||
subagent_type: "SubCoding"
|
||||
description: "实现 <任务名>"
|
||||
prompt: |
|
||||
change-id: <change-id>
|
||||
任务来源: task.md 中的 <序号>
|
||||
...（子任务完整内容）
|
||||
\`\`\`
|
||||
|
||||
##### 模式 B — 无依赖（并行 teammates）
|
||||
在**同一条消息**中调用多个 \`Agent\`，提供 \`name\` 和 \`team_name\` 参数：
|
||||
\`\`\`
|
||||
Agent: Agent:
|
||||
subagent_type: "SubCoding" subagent_type: "SubCoding"
|
||||
name: "coder-1" name: "coder-2"
|
||||
team_name: "impl-<change-id>" team_name: "impl-<change-id>"
|
||||
description: "实现任务 1.1" description: "实现任务 1.2"
|
||||
prompt: <任务1.1 完整内容> prompt: <任务1.2 完整内容>
|
||||
\`\`\`
|
||||
|
||||
> **注意**：teammates 模式需要启用 Agent Teams（\`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1\` 或 \`--agent-teams\` 参数）。
|
||||
> 若 Agent 工具返回 "Agent Teams is not yet available" 错误，**自动回退到模式 A（串行）**继续执行，不需要报告给用户。
|
||||
|
||||
每个 SubCoding 的 prompt 模板：
|
||||
\`\`\`
|
||||
change-id: <change-id>
|
||||
任务来源: task.md 中的 <阶段>-<序号>
|
||||
任务名称: <名称>
|
||||
目标: <具体修改内容和预期结果>
|
||||
涉及文件: <文件或模块>
|
||||
上下文:
|
||||
- <设计决策、技术约束>
|
||||
- <接口定义、数据结构>
|
||||
- <依赖关系>
|
||||
\`\`\`
|
||||
|
||||
#### 步骤 4.5：收尾单个任务
|
||||
|
||||
1. 将已完成任务在 plan.md 中标记为 \`- [x]\`（只改状态标记，不动其他内容）
|
||||
2. 将变更目录归档：
|
||||
\`\`\`bash
|
||||
mv .cospec/plan/changes/<change-id> .cospec/plan/archive/<change-id>
|
||||
\`\`\`
|
||||
|
||||
循环至 plan.md 中所有任务完成。
|
||||
|
||||
---
|
||||
|
||||
## 异常处理
|
||||
|
||||
- **阶段 1~3 失败**：暂停后续流程，向用户报告失败原因，等待指令后再继续。禁止跳过任何阶段。
|
||||
- **SubCoding 重试限制**：同一子任务失败后最多重试 2 次（共 3 次机会）
|
||||
- **重试策略**：每次重试前分析失败原因，在新的 SubCoding 调用中补充缺失上下文
|
||||
- **超限处理**：超出重试次数后使用 \`AskUserQuestion\` 向用户报告并请求指导
|
||||
|
||||
---
|
||||
|
||||
## 特殊规则
|
||||
|
||||
当用户指定**只修改**需求、设计或任务规划时，直接启动对应阶段的 Agent 执行，不遵循完整工作流。
|
||||
|
||||
---
|
||||
|
||||
## 目录结构
|
||||
|
||||
\`\`\`
|
||||
.cospec/
|
||||
├── spec/<feature>/
|
||||
│ ├── spec.md # 需求（Requirement 生成）
|
||||
│ ├── tech.md # 架构设计（DesignAgent 生成）
|
||||
│ └── plan.md # 任务规划（TaskPlan 生成）
|
||||
└── plan/
|
||||
├── changes/<change-id>/
|
||||
│ ├── proposal.md
|
||||
│ └── task.md
|
||||
└── archive/<change-id>/
|
||||
\`\`\`
|
||||
`
|
||||
}
|
||||
|
||||
export const STRICT_SPEC_AGENT: BuiltInAgentDefinition = {
|
||||
agentType: 'StrictSpec',
|
||||
whenToUse:
|
||||
'将用户需求按照标准阶段分配到对应工作流Agent执行。Use this when you need to orchestrate user requirements through the standard workflow stages: requirements clarification → architecture design → task planning → execution. This agent coordinates the Spec workflow with four rigorous stages to ensure high-quality delivery.',
|
||||
'全流程编排与实施协调者：按顺序驱动需求→设计→任务规划→代码实施四个阶段，直接调度所有叶子 agent（Requirement/DesignAgent/TaskPlan/QuickExplore/TaskCheck/SubCoding），支持 teammates 并行实施。Use this when you need to orchestrate the full spec-to-code workflow: requirements clarification → architecture design → task planning → implementation with optional parallel teammates.',
|
||||
disallowedTools: [EXIT_PLAN_MODE_TOOL_NAME],
|
||||
source: 'built-in',
|
||||
baseDir: 'built-in',
|
||||
|
|
|
|||
|
|
@ -6,7 +6,6 @@ import { DESIGN_AGENT } from '../../costrict/agents/designAgent.js'
|
|||
import { PLAN_APPLY_AGENT } from '../../costrict/agents/planApply.js'
|
||||
import { QUICK_EXPLORE_AGENT } from '../../costrict/agents/quickExplore.js'
|
||||
import { REQUIREMENT_AGENT } from '../../costrict/agents/requirement.js'
|
||||
import { SPEC_PLAN_AGENT } from '../../costrict/agents/specPlan.js'
|
||||
import { STRICT_PLAN_AGENT } from '../../costrict/agents/strictPlan.js'
|
||||
import { STRICT_SPEC_AGENT } from '../../costrict/agents/strictSpec.js'
|
||||
import { SUB_CODING_AGENT } from '../../costrict/agents/subCoding.js'
|
||||
|
|
@ -64,12 +63,11 @@ export function getBuiltInAgents(): AgentDefinition[] {
|
|||
GENERAL_PURPOSE_AGENT,
|
||||
STATUSLINE_SETUP_AGENT,
|
||||
PLAN_AGENT,
|
||||
// StrictSpec workflow: full 4-stage pipeline (Requirement → DesignAgent → TaskPlan → SpecPlan)
|
||||
// StrictSpec workflow: full pipeline (Requirement → DesignAgent → TaskPlan → implementation)
|
||||
STRICT_SPEC_AGENT,
|
||||
REQUIREMENT_AGENT,
|
||||
DESIGN_AGENT,
|
||||
TASK_PLAN_AGENT,
|
||||
SPEC_PLAN_AGENT,
|
||||
// StrictPlan workflow: lightweight plan → implement pipeline
|
||||
STRICT_PLAN_AGENT,
|
||||
PLAN_APPLY_AGENT,
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user