用途:指导编写实现规格,把用户故事和业务需求转化为技术规格,包含清晰的验收标准、供执行代理参考的模式引用,以及可测试的成功验证命令。
适用场景:创建实现规格、拆分用户故事、定义验收标准、为执行添加模式引用、创建用于验证的演示脚本、将业务需求翻译为技术规格。
主要能力与要求:技能使用 {{PLACEHOLDER}} 占位符,使用前需替换为项目实际值。每个规格必须包含:摘要、用户故事、验收标准、模式引用、成功验证命令、演示脚本、逻辑提交。验收标准需可测试(可判定通过/失败),模式引用需指向已存在的模式,验证命令需可运行,演示脚本需可逐步复现,逻辑提交遵循 SAFe 格式并引用工单。
禁止模式:缺少验收标准、没有模式引用、没有成功验证。正确模式示例:验收标准写成“用户可点击按钮 -> 弹出模态框”等可验证条目;模式引用指向 patterns_library 下的 UI、API、数据库、安全等模式文件;成功验证使用 {{CI_VALIDATE_COMMAND}}。
使用方式:写规格前先发现现有模式,可运行 ls patterns_library/、grep -r "similar feature" app/ lib/、ls specs/。提交前用质量清单自检。输出位置:实现规格放在 specs/SPEC-{{TICKET_PREFIX}}-{number}-{description}.md,需求放在 docs/agent-outputs/requirements/{{TICKET_PREFIX}}-*.md,ADR 放在 docs/adr/ADR-{number}-{description}.md。规格批准后可在工单系统中记录证据。
限制:资料未提供该技能的具体安装方式、收费、平台支持或实际效果;模板中的占位符和命令需按项目替换后才能使用。