SuperAPI AI 工具集

outcome-shaped-specs

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:在采用智能体循环(如 Ralph、Claude Code 等)的项目中,让每个新功能都从一份智能体可机械核验的规格文件开始,而非 TODO 列表或聊天片段。规格放在 specs/NNN-feature-slug.md,按顺序编号(如 001-foundation.md),编号保留历史顺序,重组时不要重编号。

主要章节及作用:Outcome 用 2-3 句写用户可感知的收益;Acceptance tests 用复选框列出外部可观察行为及性能、覆盖率要求,作为“完成”信号;Out of scope 显式列出不做的事,防范围蔓延;Decisions 对每个非平凡设计选择列出选项与推荐理由;Known limitations 说明 v1 不做什么及为何可延后;Memory pointers 记录实现者需要的文件路径。

使用方式:在 CLAUDE.md 或等价规则文件中写入硬性规则——“无规格不开工;若 Issue 缺少 ## Outcome 与 ## Acceptance tests 章节则拒绝启动,转而开子 Issue 请求澄清”。这样只有规格完整,智能体才被允许动手。

限制与注意事项:验收测试必须可外部观察,不能写成“重构了代码”或“函数返回 X”;决策不能写“以后再说”;规格避免臃肿,超过约三页就没人读;小功能也建议写规格,因为常隐藏非显而易见的行为;实现偏离规格时应更新规格本身。资料未提供具体的分步使用流程与依赖安装方式。