SuperAPI AI 工具集

aw-create-plan

智能体与模型

查看项目

更新于 10-16 09:33

技能介绍

用途:该技能生成 .agent/{branch-name}/plan.md 规划交接文档,并配套生成 checks.yaml——由验收标准派生的可执行验收检查。目标是让新的会话仅凭 plan.md 即可执行,无需原始对话。plan.md 不是详尽知识库,应保持精简(分为 Core 与 Extended 两层);checks.yaml 是活动契约,每次迭代重新派生(状态重置为 pending),并在执行循环中对照现实自校验。

前提条件:需完成 Phase 0(验证,需求已与用户确认)与 Phase 1(规划,代码库已分析、决策已定);置信度门应通过;必须存在 worktree,plan.md 创建于 worktree 内而非 main。

主要能力:一是解析模式参数——当裁剪后的参数恰好为 snapshot 或 --snapshot(不区分大小写、单个裸标记)时启用快照模式,其他任何参数(空或多行 plan.md 正文)均为默认模式;二是计算目标路径,使用 git branch --show-current 得到 BRANCH,目录为 .agent/${BRANCH},写入 plan.md 与 checks.yaml;快照模式下额外计算 next 版本并写入不可变的 plan.vN.md;三是按两层模板渲染 plan.md:Core 层(TL;DR、Requirements、Decisions、Acceptance Criteria、Implementation Order、File Changes、Verification、Progress Log)始终输出,Extended 层(Background & Context、Technical Approach、Patterns to Follow、Edge Cases、API / Interfaces、Existing Code Survey、Tests、Dependencies、Risks)仅在触发条件成立时输出,否则整节省略,不写空标题或 N/A;四是依据 Acceptance Criteria 派生 checks.yaml,每个 AC-{n} 对应一条记录,包含 id、requirement、ears、kind(command | grep | judge)、setup、run、expect、status 等字段;五是追写 Progress Log 条目并引用当前版本;六是写完后按检查清单验证完整性,快照模式下 plan.md 与 plan.vN.md 需保持字节一致,checks.yaml 的 ID 与验收标准保持同步。

使用方式:通过 Skill("aw-create-plan", "snapshot") 启用快照模式;默认模式仅写入 plan.md(原地覆盖,version 前置字段作迭代计数)。

限制:快照模式为可选择加入,.agent/ 按开发者加入 gitignore,属于临时草稿;judge 类型检查不单独作为门禁;run 中禁止使用占位花括号;当调用方在 Full 层之外显式撰写计划(如 /fix-bug 快速通道,其 CEGIS 重现已填补该角色)时可跳过 checks.yaml。其余细节以原文为准。