用途:该技能负责 write_spec 路由中的产品规格部分,为已关联的 issue 生成编号的 product.md 规格文件。
主要能力:确认关联 issue 编号(未提供时先搜索);读取 workflow.yaml、states.yaml、labels.yaml 以及 templates/<locale>/product_spec.md 或 templates/product_spec.md 中对应的产品规格模板;在可用时运行本地门禁检查;写出 specs/GH<issue-number>/product.md。产品内容聚焦可观察行为,包括目标、非目标、行为不变量、验收标准、边界情况与待解决问题,并以编号、可测试的不变量形式描述行为,不涉及实现细节。实现方案、文件归属、测试命令与发布机制留给技术规格或任务计划。
使用方式:先确认 issue 编号,再读取相关配置与模板,必要时运行:python3 checks/route_gate.py --repo . --route write_spec --issue <issue-number> --state ready_to_spec --json,然后写入 product.md。
限制:没有关联 issue 时不得编写编号规格,除非人工明确选择非 GitHub 工作流;不得翻译稳定 ID、路径、命令、JSON 键、状态或路由名称;面向人的产品文本需保持所选语言环境。