SuperAPI AI 工具集

spec-writing

写作与研究

查看项目

更新于 10-16 03:42

技能介绍

用途:为功能、项目或需求编写规格说明,采用 Jobs to Be Done(JTBD)方法,把需求拆分为范围明确、可测试的规格文件,驱动后续自主实现。核心规则是规格只定义软件“做什么”,绝不写“怎么做”,禁止出现代码片段、变量名、函数签名、技术选型、算法建议、架构模式或库引用,只允许行为描述、可观察结果、能力需求与成功标准。

主要能力:按阶段推进。第一阶段用“When [situation], I want to [motivation], so I can [expected outcome]”格式识别用户或系统的 job,识别后须经用户确认。第二阶段把每个 job 拆成独立主题,用“去掉 and 的一句话”测试判断是否需拆分,每个主题对应一个规格文件,命名格式为 <int>-<descriptive-name>.md。第三阶段按模板编写规格,包含 Job to Be Done、Given/When/Then 验收标准、边界情况、数据契约(输入输出形状与约束)和非功能需求(性能、可访问性、安全)。第四阶段用故事地图组织规格,按能力横向切片规划发布,每个切片须满足 Simple、Lovable、Complete 三项标准。第五阶段为审计模式,可检查已有规格是否符合规则,大规模规格集可用 Agent 工具并行处理。

使用方式:按阶段执行,每阶段结束需停下确认;编写完成后运行审计清单,验证无实现细节、单一主题、Given/When/Then 格式、可测试性、至少两个边界情况、数据契约与命名一致。

适用场景:功能规格、需求文档、验收标准编写,以及从现有代码反向生成规格、与 PRD、规划、测试驱动开发等流程衔接。

限制:该技能为刚性技能,各阶段、门禁与格式规则必须严格遵守,不得跳过或改写;规格须在实现之前编写。资料未提供具体安装命令、收费或平台信息。