SuperAPI AI 工具集

plan

编程与开发

查看项目

更新于 10-16 03:48

技能介绍

用途:这是 agent-toolkit 流水线的第三个脊柱阶段(spine phase 3)。用于在 specify 审批通过后,把已确认的 architecture.md 与 decisions.md 拆解成完整、可追溯的实施清单,写入 plan.md,确保进入 implement 前不存在未解决的重要歧义。

主要能力:按组件、功能或层级划分子节,每个子节可独立执行并以测试通过为基线;每个子节先写测试任务,再写实施任务;每个子节包含验证任务;所有实施子节之后有一个评审子节和一个文档核对子节。计划作为功能规格,描述外部相关的输入、输出、状态转移、校验、错误、不变量、顺序保证和验收证据,而不规定私有控制流或内部实现细节。

使用方式:脚本位于技能自身 scripts/ 目录,需先设置 SKILL_DIR 为技能的绝对路径,例如 SKILL_DIR="<absolute path to this skill's directory>",再从项目根目录运行脚本(脚本操作项目的 .changes/ 和 CONTEXT.md)。加载 manifest.yaml 并检查前置条件:phase 为 plan、approvals.plan 为 pending、architecture.md 与 decisions.md 均存在。先读 change-brief.md,再按需读取 architecture.md 与 decisions.md,并阅读 references/engineering-fundamentals.md。按阶段执行:分节、写 plan.md、可追溯性检查、回退检查、写文件到 .changes/active/<id>/plan.md、请求审批。

审批与回退:展示子节数、任务总数、firm-seam 测试数与可追溯性结果,询问是否批准 plan 审批,批准后运行 node "$SKILL_DIR/scripts/manifest-approval.mjs" --id <id> --approval plan --approve,然后提示运行 implement。若发现 specify 应解决却缺失的重要决策,批量记录并停止,提示运行 specify,使用 node "$SKILL_DIR/scripts/kickback-log.mjs" --id <id> --type defect --phase plan --impact specify --missed "<description>"。

适用场景:面向遵循 agent-toolkit 流水线、需要将已确认架构与决策转成可执行实施清单的开发者。

限制:此阶段不做架构决策,不编造答案;不规定私有实现机制;遇到材料性歧义需回退 specify;平台、费用、效果等信息资料中暂未提供。