SuperAPI AI 工具集

spec-writing

写作与研究

查看项目

更新于 10-15 17:20

技能介绍

用途:将自然语言的功能描述转化为清晰、完整、可测试的规格说明,侧重用户价值与业务需求,不涉及实现细节。适合在启动新功能、规划之前先产出规格时使用。

主要能力:支持创建新功能规格、细化已有规格、编写用户故事与验收标准、定义成功标准。规格结构包含必选部分:概述/背景(解决什么问题)、用户场景(谁如何使用)、功能需求(必须做什么)、成功标准(如何判断有效);可选部分:成功标准(性能/安全关键时)、边界情况、依赖项、假设。

使用方式:按核心原则撰写——聚焦用户价值而非实现细节,除非严格必要,不在需求中指定技术选型;每条需求须可测试、可验证并带可度量标准;减少澄清标记,基于行业标准做合理假设并明确记录。可参考 modules/specification-structure.md 的模板与指南、modules/success-criteria-patterns.md 的成功标准示例与转换方法。

适用场景:需要一份先于规划的规格;需要把模糊想法变为可验收需求;性能与安全关键时定义度量标准。

限制与注意:不用于生成实现任务,那应使用 task-planning。质量清单要求:无实现细节、需求可测试且无歧义、成功标准可度量、用户场景覆盖主流程、识别边界情况、范围清晰有界。成功标准应面向用户且可度量,例如“用户在 3 分钟内完成结账”,而非实现指标如“API 响应低于 200ms”。退出标准:规格含全部四个必选部分;成功标准面向用户可度量;质量清单通过;需求中不出现技术选型,除非明确标注为严格必要约束;每条功能需求至少有一个可从系统外部验证的可测试验收标准。相关技能:speckit-orchestrator 负责工作流协调,task-planning 负责将规格转为任务。若规格过于模糊,用 success-criteria-patterns 模块强制可度量结果;若实现细节渗入规格,对照核心原则重构,聚焦用户行为。安装命令、价格、平台支持等信息暂未提供。