用途:把当前对话上下文与对代码库的理解综合成一份规格说明(spec),并发布到项目工单跟踪器。它明确要求不要访谈用户,只综合已知信息。
前置条件:工单跟踪器与分诊标签词表应已提供;若没有,需先运行 /setup-formsg-ai-skills。
主要流程:先探索仓库了解代码库现状;规格中全程使用项目领域词汇表,并遵守相关 ADR。随后勾勒测试接缝(seam),优先复用现有接缝,使用尽可能高的接缝;若需新接缝,在尽可能高的位置提出,接缝越少越好,理想数量为一个。与用户确认接缝符合预期后,按模板撰写规格并发布到工单跟踪器,打上 ready-for-agent 分诊标签,无需额外分诊。
规格模板包含:问题陈述(从用户视角描述用户面临的问题)、解决方案(从用户视角描述)、用户故事(很长的编号列表,格式为“作为……,我想要……,以便……”)、实现决策(列出已做出的决策并标记固定决策,可含模块、接口、技术澄清、架构决策、模式变更、API 契约、具体交互;不要包含具体文件路径或代码片段,例外是原型中比文字更精确表达决策的片段,可内联并注明来自原型)、测试决策(好测试的标准、被测模块、代码库中的类似测试先例)、范围外内容、进一步说明。
限制:不进行用户访谈;不写具体文件路径或代码片段(原型决策片段除外);需依赖已配置的工单跟踪器与标签词表。