to-spec
将当前对话整理成规格并发布到项目的 Issue 跟踪器中。不要重新访谈用户,只综合已经讨论过的内容。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
将当前对话整理成规格并发布到项目的 Issue 跟踪器中。不要重新访谈用户,只综合已经讨论过的内容。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
使用并行 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 或类型结构,可以把它嵌入对应决策,并简短注明它来自原型。只保留承载决策的部分;不要放入一份可运行的演示。
列出已经确定的测试决策,其中包括:
说明哪些事项不属于本规格的范围。
记录与该功能有关的其他说明。