SuperAPI AI 工具集

create-plan

编程与开发

查看项目

更新于 10-16 01:29

技能介绍

用途:create-plan 是一个技能,用于依据当前对话上下文,在 .agent/{branch}/ 目录下生成综合的实施计划文档 plan.md。该文档被定位为自主执行的唯一事实来源,要求新的会话在不接触原始对话的情况下仅凭此计划即可执行。

使用前提:调用该技能前,阶段 0(验证,需求已与用户确认)与阶段 1(计划,已完成代码库分析并做出决策)必须完成;信心门应已通过(计划模式下达 90% 以上);必须已存在 worktree,plan.md 要创建在 worktree 内,绝不在 main 上创建。

主要流程:第一步确定文件位置,运行 BRANCH=$(git branch --show-current) && mkdir -p ".agent/${BRANCH}" && echo ".agent/${BRANCH}/plan.md",使用输出作为路径,不得硬编码或猜测分支名;第二步按给定模板结构写入 plan.md,每个章节均为必填,内容取自阶段 0-1 的对话上下文;第三步按技能底部清单校验完整性,任一项不通过立即修正。

模板要点:所有时间戳必须使用带时间的完整 ISO 8601 格式 YYYY-MM-DDTHH:MM:SSZ。文档包含 frontmatter(created、branch、task、complexity、status、approved)以及 Summary、Background & Context、Requirements(每条标注 [user-stated] 或 [inferred])、Out of Scope、Decisions(含被否决的替代方案与理由)、Technical Approach(含 Patterns to Follow、Edge Cases、API/Interfaces)、Acceptance Criteria、Implementation Order、File Changes、Tests、Dependencies、Risks、Verification、Progress Log(仅追加)等章节。

验证清单要求:路径来自 git branch --show-current 且在 worktree 内;frontmatter 完整;时间戳含时间;Summary 简洁说明 what/why/done;Background 使陌生人理解 why;Requirements 全部标注;Out of Scope 至少经过考虑;Decisions 含被否决方案与理由;技术方法具体到无需对话上下文即可实施;Patterns 引用真实文件;验收标准至少一条具体可测;实施步骤编号且原子可验证;文件变更逐项列明;测试为具体用例;给出编辑后与提 PR 前的验证命令;Progress Log 初始化含阶段 1 条目;整体自包含。

常见失败与修正:章节稀疏(如 TBD)需从上下文填充;缺决策理由需补替代方案与理由;实施步骤含糊需原子化;Patterns 缺具体文件路径需补充;需求未标注需补标签;时间戳缺时间部分需补全。

限制:未提供该技能的收费、平台、价格或效果信息。