to-spec

用途：将当前对话上下文与对代码库的理解综合为一份规格文档（可理解为 PRD），不访谈用户，只整理已知信息。\n\n主要能力：探索仓库以了解代码现状；使用项目领域词汇表，并遵守相关 ADR；规划测试接缝（seam），优先复用已有接缝、使用尽可能高的接缝，新接缝越少越好（理想为一个），并与用户确认接缝是否符合预期；按模板撰写规格并发布。\n\n模板结构：问题陈述（从用户视角描述问题）、解决方案（从用户视角描述方案）、用户故事（长编号列表，格式为 As an , I want a , so that ）、实现决策（模块、接口、技术澄清、架构决策、schema 变更、API 契约、具体交互；不写具体文件路径或代码片段，除非原型片段比文字更精确地编码了决策，可内联并注明来自原型）、测试决策（好测试的定义、被测模块、测试先例）、范围外、进一步说明。\n\n发布方式：默认写入当前项目 docs/<feature-slug>/spec.md 的本地 Markdown，不触碰外部跟踪器，并在顶部附近记录 Status: ready-for-agent。仅当用户明确指定时才覆盖：jira 通过 Atlassian MCP 创建 issue（写入前先询问，使用仓库默认项目，应用 ready-for-agent 标签）；gh 通过 gh CLI 在仓库 GitHub Issues 创建 issue，应用 ready-for-agent 标签。\n\n限制：不进行用户访谈；默认不写外部跟踪器；实现决策中不包含具体文件路径或代码片段；状态直接记为 ready-for-agent，无需额外分诊。其他细节暂未提供。