规格生成器

问题：想法聊清楚了，但规格还散落在对话里

团队花了一个下午讨论"周报摘要"功能，群里有七八条消息说"能不能自动汇总"，产品同学口头答应了"管理员要能配摘要源"，但没人把这些零散共识整理成一份能让开发直接上手的规格。传统做法是让产品经理再约一轮评审会，或者自己翻聊天记录整理——前者耗时，后者容易漏掉关键决策。

核心能力：不访谈，只综合

这个技能扮演产品经理代理的角色，它不会反问你"你确定要这样做吗"，而是把当前对话上下文和仓库现状拼在一起，直接产出一份可交付、可拆单的规格文档。它的输入是你已经聊出来的内容（可能是聊天记录、语音转文字、或刚结束的讨论），加上对代码库的理解，输出是一个结构化的 Spec 工件。

这个 Spec 包含以下字段：

• problem_statement：问题陈述
• solution：方案概述
• user_stories：极长编号列表，每个故事格式为"作为 X，我要 Y，以便 Z"
• implementation_decisions：将建/改的模块、接口、Schema 变更、API 契约等
• testing_decisions：测试策略与参考实践
• out_of_scope：明确排除的范围

关键步骤

1. 探索仓库理解现状

技能会先扫一遍代码库，理解项目当前的架构、模块边界和领域词汇。如果仓库里有 ADR（架构决策记录），它会尊重这些决策，不会提出与之冲突的方案。

2. 勾画测试接缝

这是最关键的一步。技能会识别或建议在哪个位置测试新功能，优先使用已有的测试接缝（比如已有的服务层接口），如果需要新建接缝，它会建议在"最高处"（即最靠近用户交互的层）提，这样能用最少的测试覆盖最多的行为。理想情况下，整个规格只跨一个代码库边界。

接缝确定后，技能会与你确认是否符合预期，避免后续返工。

3. 用模板写规格并发布

确认接缝后，技能按模板生成规格文档，直接发布到 issue 跟踪器，并打上 ready-for-agent 标签，这意味着规格已经过审，可以直接被下游技能消费（比如 to-tickets 拆工单，或 implement 直接开始写代码）。

适用边界

不适用的场景：

• 需求还模糊，需要大量澄清——先回 /grill-with-docs 把需求聊清楚
• 需要写具体的文件路径或代码片段——这些信息容易过时，规格应该描述决策而非实现细节

重要约束：

• 用户故事必须极详尽，覆盖功能的各个方面，不能只是"用户能查看周报"这种粗粒度描述
• 实现决策聚焦在架构层面（模块、接口、Schema），不写文件路径或代码片段，除非某些决策用原型表达更准确（比如状态机、reducer、类型形状），这种情况下可以内联并注明来源
• 规格是决策密集的文档，不是技术手册，读者是开发者和后续的 Agent，不是终端用户