用途:to-spec 用于把当前对话的上下文与对代码库的理解综合成一份规格说明(spec),并发布到项目的 issue 跟踪器。其明确要求是不对用户进行访谈,只综合已经讨论过的内容。
主要能力:读取配置文档(docs/agents/issue-tracker.md 及配置好的 triage 词汇表)后发布规格,遵循其中的归属、Project 映射和最终 PR 策略;若缺少跟踪器配置,会提示用户运行 /setup-matt-pocock-skills。过程中会探索仓库以了解代码现状,沿用项目领域词汇表,并遵守相关 ADR。规格按固定模板撰写,涵盖问题陈述、解决方案、用户故事、实现决策、测试决策、范围外事项和补充说明。测试方面要求先勾画测试接缝,优先复用已有接缝、尽量取最高层接缝、接缝越少越好(理想为一个),并与用户确认接缝是否符合预期。发布时会打上配置好的 ready-for-agent 标签。
GitHub 相关行为:为新的 PRD 指派驱动本次会话的开发者(默认取 gh api user --jq .login,用户可指定他人);在提供或恢复已有 idea/PRD issue 时复用它并保留指派人及当前进度,除非用户要求变更。按跟踪器文档确保加入所选 Project,并把新工作项初始化为 todo,重试时保留既有状态;仅当配置了 Project 时才更新,并使用其 Status 字段而非生命周期标签。发布后会获取 issue 及其 Project 项,核验 URL、正文、就绪标签、指派人、成员关系和预期 Status;发布或跟踪失败会单独报告并附已有 URL,以便重试时更新该 issue 而非重复创建。issue 保持开启,发布只代表预留工作,不启动实现。
使用方式:在对话已充分展开、且项目已配置 issue 跟踪器的情况下调用该技能;技能会直接综合生成规格并发布,无需额外访谈。
适用场景:适合需求讨论已成熟、希望把对话结论快速固化为可跟踪 issue 并带有测试接缝考量的开发流程。
限制:依赖 issue-tracker 配置与 triage 词汇;缺少配置时无法发布,只能提示先运行 setup 命令。实现决策部分明确不包含具体文件路径或代码片段(原型中能更精确表达决策的片段除外)。发布不启动实现。