SuperAPI AI 工具集

implement_plan

通用与其它

查看项目

更新于 10-16 09:49

技能介绍

用途:实施 thoughts/shared/plans/ 中已批准的技术方案。方案包含阶段、具体变更与成功标准。

主要能力与执行模式:

  1. 直接实施(默认):适合 3 个及以下任务或用户要求直接实施,由执行者逐阶段完成,上下文累积在主对话中。
  2. 智能体编排(较大方案推荐):适合 4 个及以上任务或需保留上下文时,作为轻量编排者,智能体执行每个任务并生成 handoff,handoff 落盘因此抗上下文压缩。使用该模式需声明“I'll use agent orchestration for this plan”。

使用方式:给定时读取完整方案并检查已有勾选(- [x]),阅读原始工单及方案中提到的所有文件(完整读取,不用 limit/offset),建立待办列表。实施前运行深层预检: /premortem deep <plan-path> 若出现 HIGH 级风险,预检会通过 AskUserQuestion 阻断,用户须明确接受、补充缓解措施或研究方案;补充缓解后先更新方案。若方案已有“## Risks (Pre-Mortem)”及缓解措施,或用 --skip-premortem 明确跳过,则可略过预检。未提供方案路径时需先询问。

实施与验证:按阶段完整实施并更新方案中的勾选框;每阶段后运行成功标准检查(通常为 make check test),修复后再继续;自动验证通过后暂停,通知人工按方案手动验证,人工确认前不勾选手动测试项。方案与实际不符时应停下说明“Issue in Phase [N]:Expected/Found/Why this matters”并询问如何继续。若方案由 plan-agent 创建,可读取 .claude/cache/agents/agent-log.jsonl 中的 agentId,用 Task(resume=...) 恢复上下文;可恢复的智能体包括 plan-agent、oracle、debug-agent。若方案已有勾选,信任已完成项,从首个未勾选项继续。

编排模式:创建 handoff 目录 mkdir -p thoughts/handoffs/<session-name>/,读取 .claude/skills/implement_task/SKILL.md。前置条件是方案已由 validate-agent 验证并生成状态为 VALIDATED 的 handoff(检查 thoughts/handoffs/<session>/validation-*.md);缺失时建议先运行验证,状态为 NEEDS REVIEW 时先呈现问题。随后对每个任务读取连续性账本、方案与上一个 handoff,按 Task 模板派发智能体(含完整上下文与 handoff 文件名),处理结果并更新账本与方案勾选。智能体失败时读取状态为 blocked 的 handoff 并向用户呈现。上下文压缩后可读取账本、列出 handoff 目录、读取最近 handoff 并从下一个未完成任务继续。

适用场景:按阶段实施已批准方案、多阶段大功能、需要跨压缩保留实施上下文的任务。

限制:需已存在方案文件与相关工单;智能体编排需先完成验证;并行执行未在资料中说明,建议顺序执行;每任务一个智能体,不批量合并。具体模型与命令示例以资料为准。