用途:把当前对话上下文与对代码库的理解综合成一份规格(spec),不访谈用户,直接整合已知信息,然后发布到项目问题跟踪器。
使用前提:问题跟踪器与分诊标签词汇应已提供;若没有,提示用户运行 /setup-issue-tracker。
流程:先探索仓库了解代码库现状(如尚未做);规格中全程使用项目领域词汇表,并遵守相关 ADR。规划测试接缝(seam),优先复用现有接缝,使用尽可能高的接缝;若需新接缝,在能提出的最高点提出,接缝越少越好,理想为一条。与用户确认这些接缝符合预期。按模板撰写规格并发布到问题跟踪器,打上 ready-for-agent 分诊标签,无需额外分诊。
规格模板包含:问题陈述(从用户视角描述面临的问题)、解决方案(从用户视角)、用户故事(长编号列表,格式为“作为……,我想要……,以便……”)、实现决策(将要构建/修改的模块、其接口变更、开发者的技术澄清、架构决策、模式变更、API 契约、具体交互;不要写具体文件路径或代码片段,例外是原型中比文字更精确编码决策的片段,可内联并注明来自原型)、测试决策(好测试的定义、被测模块、测试先例)、范围外事项、补充说明。
限制:不访谈用户;不写具体文件路径与代码片段;需要预先配置问题跟踪器与分诊标签词汇。