用途:把当前对话上下文与对代码库的理解综合成一份 spec,发布到项目的 issue tracker。它不盘问用户,只整理已知内容。
主要能力:先探索仓库了解代码库现状;使用项目领域词汇表术语,并尊重相关区域的 ADR;勾勒测试该功能的接缝,优先复用已有接缝、尽量用最高接缝,接缝数量越少越好(理想为一个);与用户确认接缝符合预期;按模板撰写 spec 并发布,打上 ready-for-agent 分类标签。
spec 模板包含:问题陈述(从用户视角描述问题)、解决方案(从用户视角描述)、详尽的编号用户故事(格式为“作为一个<角色>,我想要<功能>,以便<收益>”)、实现决策(模块、接口、技术澄清、架构决策、Schema 变更、API 契约、具体交互;不含具体文件路径或代码片段,例外是原型中比散文更精确的片段如状态机、reducer、schema、类型形态,可内联并注明来自原型)、测试决策(好测试的定义、被测模块、测试先例)、范围外、补充说明。
使用方式:issue 跟踪器和分类标签词汇应已提供,若没有则提示用户运行 /setup-matt-pocock-skills。
限制:不进行用户访谈;不包含具体文件路径或代码片段(原型片段例外);分类标签固定为 ready-for-agent,无需再做分类。