to-spec
将当前对话整理成规格并发布到项目的 Issue 跟踪器中。不要重新访谈用户,只综合已经讨论过的内容。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
将当前对话整理成规格并发布到项目的 Issue 跟踪器中。不要重新访谈用户,只综合已经讨论过的内容。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
使用并行 sub-agents 为一个 module 生成多套差异显著的 interface 设计。适用于用户希望设计 API、探索 interface 选项、比较 module 形态,或提到“design it twice”的场景。
运行交互式 QA session:用户通过对话报告 bugs 或 issues,agent 随后创建 GitHub issues;同时在后台探索 codebase,获取上下文和 domain language。适用于用户希望报告 bugs、开展 QA、通过对话创建 issues,或提到“QA session”的场景。
通过用户访谈创建一份由微小 commits 组成的详细 refactor plan,并将其提交为 GitHub issue。适用于用户希望规划 refactor、创建 refactoring RFC,或将 refactor 拆分为安全的增量步骤。
从当前对话中提取一份 DDD 风格的 ubiquitous language glossary,标出歧义并提出规范术语,保存到 UBIQUITOUS_LANGUAGE.md。适用于用户希望定义 domain terms、建立 glossary、收紧术语、创建 ubiquitous language,或提到“domain model”或“DDD”的场景。
询问当前情境适合使用哪个 Skill 或工作流。本 Skill 是仓库内其他 Skills 的路由入口。
从用户指定的固定点(commit、branch、tag 或 merge-base)开始,从两个维度审查代码变更:Standards 检查代码是否遵守仓库记录的编码规范,Spec 检查实现是否符合原始 Issue、PRD 或规格。两个审查由并行子 Agent 分别完成,再并列汇报。适用于用户希望审查分支、PR、开发中的改动,或要求“审查自 X 以来的变更”时。
| name | to-spec |
| description | 将当前对话整理成规格并发布到项目的 Issue 跟踪器中。不要重新访谈用户,只综合已经讨论过的内容。 |
| disable-model-invocation | true |
本 Skill 根据当前对话上下文和对代码库的理解生成一份规格文档(也可以把它称为 PRD)。不要访谈用户;只整理和综合已经掌握的信息。
Issue 跟踪器及分诊标签词汇应当已经配置。如果尚未提供,请先运行 /setup-matt-pocock-skills。
如果此前尚未完成探索,先阅读仓库,了解代码库当前状态。整份规格都应使用项目领域术语表中的词汇,并遵守所涉及区域已有的 ADR。
初步确定用于测试该功能的 seams。优先复用现有 seam,并尽量选择层级最高的 seam。确实需要新 seam 时,也应在可行范围内放到最高层。整个代码库中的 seams 越少越好;理想数量是一个。
向用户确认这些 seams 是否符合预期。
ready-for-agent 分诊标签,无需再进行额外分诊。从用户视角描述他们面对的问题。
从用户视角描述问题的解决方案。
编写一份很长的编号用户故事列表。每条用户故事使用以下格式:
用户故事列表必须足够全面,覆盖该功能的所有方面。
列出已经确定的实现决策,可以包括:
不要写入具体文件路径或代码片段。这些内容很可能迅速过时。
例外:原型产出的某段代码能够比文字更准确地表达一项决策时,例如状态机、reducer、schema 或类型结构,可以把它嵌入对应决策,并简短注明它来自原型。只保留承载决策的部分;不要放入一份可运行的演示。
列出已经确定的测试决策,其中包括:
说明哪些事项不属于本规格的范围。
记录与该功能有关的其他说明。