| name | ac-execute |
| description | 按已确认计划实施改动并完成最小验证。 |
| disable-model-invocation | true |
Execute - 主线程实施 + Subagents 辅助
$ARGUMENTS
核心协议
- 语言协议:与工具交互用英语,与用户交互用中文
- 实施主权:所有产品代码修改由 Claude 主线程直接执行
- 按需使用 subagents:仅在上下文检索范围大、实现涉及多个模块、或交付前需要额外只读自审时,使用
Agent 工具启动 subagents 辅助
- 只读辅助:subagents 只负责检索、分析、自审,不直接编辑代码、不写计划文件、不替代主线程交付
- 最小变更:只修改计划范围内的必要代码
- 前置条件:优先基于
/ac-plan 生成且已批准的计划执行;若缺失计划或计划信息不全,先向用户确认
执行约束
工作目录:
{{WORKDIR}}:使用当前工作目录的绝对路径作为上下文检索与代码修改根目录
- 如果用户通过
/add-dir 添加了多个工作区,先用 Glob/Grep 确定任务相关的工作区
- 如果无法确定,用
AskUserQuestion 询问用户选择目标工作区
subagents 使用条件:
- 适用:关键路径不明确、需要并行摸排多个模块、改动完成后需要额外只读审查
- 优先:
Explore 用于上下文检索;交付前的附加审查也应优先使用只读 subagent
- 不适用:单文件小改动、路径明确、主线程一次阅读即可完成的简单任务
重要:
- 不允许使用 Bash 调用外部模型、生成原型或执行额外编排
- 不允许保存、引用或交接任何外部会话标识
- subagents 不得直接实施代码修改,禁止多代理并行写同一任务
- 已委托给 subagents 的检索或审查内容,主线程不要重复执行
- 仅在本地验证时,按需运行最小相关范围的 lint / typecheck / tests
- 若信息不足,必须先提问再继续执行
执行工作流
执行任务:$ARGUMENTS
📖 Phase 0:读取计划
[模式:准备]
- 识别输入类型:
- 计划文件路径(如
.claude/plan/xxx.md)
- 直接的任务描述
- 读取计划内容:
- 若提供了计划文件路径,读取并解析
- 提取:任务类型、实施步骤、关键文件、风险与验证要求
- 执行前确认:
- 若输入为直接任务描述:先确认是否已有已批准的计划
- 若计划中缺失关键文件、验收标准或范围边界:先向用户补充确认
- 若无法确认用户是否已同意执行:必须先询问,再进入下一阶段
🔎 Phase 1:上下文检索
[模式:检索]
- 优先读取计划中列出的关键文件
- 若计划未给出完整路径或实现涉及多个模块:
- 由主线程按需使用
Agent 工具并行启动 subagents
- 可按文件组、模块或关注点拆分检索任务
- 补充读取实施所需的入口文件、依赖模块、相关类型定义
- 若发现计划与当前代码明显不一致,暂停并向用户确认
检索完成后:
- 整理关键上下文
- 确认已具备实施所需信息
- 进入 Phase 2
⚡ Phase 2:主线程实施
[模式:实施]
- 基于计划与上下文直接实施
- 先读取目标文件,理解现有实现方式
- 由主线程使用 Edit / Write 工具执行实际修改
- 遵循项目现有代码风格与结构
- 仅修改必要代码,避免顺手重构和超范围变更
- 若实施过程中发现计划需要变更,先暂停并向用户确认
✅ Phase 3:验证
[模式:验证]
- 优先运行最小相关范围的 lint / typecheck / tests
- 若验证失败:先修复回归问题,再继续交付
- 若项目缺少自动化检查:给出最小手动验证步骤
- 未验证通过前,不进入最终交付
🧪 Phase 4:主线程自审与交付
[模式:审查]
4.1 自审
- 检查逻辑正确性
- 检查边界条件与副作用
- 检查安全性与输入边界
- 检查是否存在超范围修改
- 检查是否与计划目标一致
4.2 subagents 附加审查(复杂场景按需启用)
当改动跨多个模块、验证成本高、或存在集成风险时:
- 使用只读 subagents 并行审查不同关注点
- 典型拆分方式:
- 主线程汇总审查结果,决定是否补充修复
4.3 整合修复
- 根据主线程与 subagents 审查结果执行必要修复
- 修复后重复最小验证
- 风险可接受后再交付
4.4 交付确认
向用户报告:
## ✅ 执行完成
### 变更摘要
| 文件 | 操作 | 说明 |
|------|------|------|
| path/to/file.ts | 修改 | 描述 |
### 验证结果
- 已执行:<lint / typecheck / tests / 手动验证>
- 结果:<通过 / 失败后已修复 / 无自动化检查>
### 后续建议
1. [ ] <建议的测试步骤>
2. [ ] <建议的验证步骤>
关键规则
- 主线程实施 – 产品代码只由当前会话主线程修改
- subagents 只做辅助检索/审查 – 按需使用,不默认开启,不直接改代码
- 最小变更 – 仅修改必要代码,不引入额外副作用
- 先验证后交付 – 能运行检查就先运行检查
- 信息不全先确认 – 缺少计划、关键文件或验收标准时必须先问用户