用途:将当前对话上下文与对代码库的理解综合为一份规格说明,并发布到项目 issue tracker。资料明确要求不要访谈用户,只综合已知信息。
主要能力与流程:先探索仓库以了解代码库现状;在规格中沿用项目领域术语表词汇,并遵守相关 ADR。随后勾勒测试接缝(seam),优先复用已有接缝,尽量使用最高层接缝;若需新接缝,应在尽可能高的位置提出,接缝越少越好,理想数量为一个。需与用户确认这些接缝符合预期。之后按模板撰写规格并发布到 issue tracker,打上 ready-for-agent 分类标签,无需额外分类。
规格模板包含:问题陈述(从用户视角描述用户面临的问题)、解决方案(从用户视角)、用户故事(很长的编号列表,格式为 As an…, I want a…, so that…,需覆盖功能各方面)、实现决策(涉及模块、接口、技术澄清、架构决策、schema 变更、API 契约、具体交互;不要写具体文件路径或代码片段,除非原型片段比文字更精确地编码了某项决策,可内联并注明来自原型)、测试决策(好测试的定义、被测模块、代码库中的类似测试先例)、范围外内容、进一步说明。
使用方式:issue tracker 与分类标签词汇应已提供;若未提供,需提示用户运行 /setup-matt-pocock-skills。发布语言:规格正文用英文;对于个人仓库(远程 owner 与 gh api user --jq .login 匹配;无法确认时视为外部仓库),在规格 issue 上单独发一条评论作为主要内容,包含 ## Chinese Summary (non-authoritative) 部分总结要点。该摘要仅属于规格 issue,绝不添加到子 issue 或后续跟进中。
限制:不进行用户访谈;不包含具体文件路径或代码片段(原型决策片段除外);摘要仅限规格 issue。其他细节资料未提供。