SuperAPI AI 工具集

create-plan

编程与开发

查看项目

更新于 10-16 09:31

技能介绍

用途:该技能用于规划一项变更。它把决策写成 ADR(架构决策记录),并生成属于该决策的实施计划。规则是只规划、不实现。适合用户要求规划某个功能或改动时使用。

文件组织:决策与其计划放在项目的 adrs/ 文件夹中;若项目已采用其他 ADR 布局,则沿用原有布局。ADR 文件命名为 adrs/NNNN-<slug>.md,使用下一个空闲编号且永不重编号;对应的计划文件为 adrs/NNNN-<slug>.plan.md。若变更很小、不涉及真正的决策,则两者都不需要,直接做或在对话中商定方案即可。

ADR 内容:保持简短,通常不超过一页,包含状态(Proposed、Accepted 或 Superseded by NNNN)、上下文(问题与约束)、决策(将要做什么)、备选方案(始终包含最简单的可行选项并说明取舍原因)、后果(我们接受的权衡)。新 ADR 写作 Proposed,只有用户批准后才标为 Accepted。决策改变时,写一个新 ADR 取代旧 ADR,而不改写已接受的历史。

计划内容:包含状态(Draft、Ready、In progress 或 Done)、目标(完成时什么算做完、什么不在范围内)、任务(按顺序;每个任务说明改什么、从哪开始、如何验证、是否完成;验证指要新增或运行的高价值测试,以及在重要处进行的人工检查,例如用 agent-browser 检查 UI)、待决问题(需要用户决定的事项)。

简单性原则:只做规划所需的代码与文档调研,不多做;选择满足目标的最简设计;不添加推测性的选项、回退、抽象或“以后再做”的任务;保存前删除所有无助于目标的任务。当范围、行为或架构上的选择确实有歧义时,应询问用户而非猜测。对计划的每条反馈都要质疑:它是在解决真实且可能发生的问题,还是只是增加复杂度?不确定时询问用户。

限制:该技能不包含价格、平台支持等信息,资料未提供;使用时应遵守只规划不实现的约束。