to-spec
把当前对话变成一份规格(spec),并将其发布到项目的 issue tracker——不做访谈,只对你们已经讨论过的内容进行综合。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Menu
把当前对话变成一份规格(spec),并将其发布到项目的 issue tracker——不做访谈,只对你们已经讨论过的内容进行综合。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
从两个维度审查自某个固定基点(提交、分支、标签或 merge-base)以来的改动 —— 规范(代码是否遵循本仓库有文档记录的编码规范?)与 需求(代码是否符合最初发起的 issue/PRD 的要求?)。以并行子代理运行两项审查并并排汇报。当用户想要审查某个分支、PR、进行中的改动,或要求“审查自 X 以来的改动”时使用。
基于一份规格或一组工单来实现一部分工作。
设计深模块的共享术语体系。当用户想要设计或改进某个模块的接口、寻找加深(deepening)的机会、决定接缝(seam)放在哪里、让代码更易测试或更利于 AI 导航时,或当其他技能需要用到深模块术语时使用。
构建并打磨项目的领域模型。当用户想要确定领域术语或统一语言(ubiquitous language)、记录架构决策,或当其他技能需要维护领域模型时使用。
通过一场刨根问底的访谈来打磨一份计划或设计。
通过一场刨根问底的访谈来打磨一份计划或设计,并在过程中同时产出文档(ADR 和词汇表)。
Basé sur la classification professionnelle SOC
| name | to-spec |
| description | 把当前对话变成一份规格(spec),并将其发布到项目的 issue tracker——不做访谈,只对你们已经讨论过的内容进行综合。 |
| disable-model-invocation | true |
这个技能获取当前对话上下文以及对代码库的理解,产出一份规格(你可能把这类文档称为 PRD)。不要访谈用户——只综合你已经知道的东西。
issue tracker 与分诊(triage)标签词汇应当已经提供给你——如果没有,运行 /setup-matt-pocock-skills。
探索仓库以理解代码库当前的状态(如果你还没这么做)。在整份规格中使用项目的领域词汇表词汇,并尊重你所触及区域内的任何 ADR。
勾画出你打算在其上测试该功能的接缝(seam)。应优先选用现有接缝而非新接缝。使用尽可能高的接缝。如果需要新接缝,就在你能达到的最高点提出。代码库中接缝越少越好——理想数量是一个。
与用户核对这些接缝是否符合他们的预期。
ready-for-agent 分诊标签——无需额外分诊。同时打上一个 spec 标签,以便与普通工单区分开来。用户正面临的问题,从用户的视角出发。
针对该问题的解决方案,从用户的视角出发。
一份很长的、带编号的用户故事列表。每条用户故事应采用如下格式:
这份用户故事列表应当极其详尽,覆盖该功能的所有方面。
一份已做出的实现决策列表。可以包括:
不要包含具体的文件路径或代码片段。它们可能很快就会过时。
例外:如果某个原型产出了一段比散文能更精确地编码某项决策的代码片段(状态机、reducer、schema、类型形状),就把它内联进相关决策,并简要注明它来自一个原型。裁剪到富含决策的部分——不是一个能运行的演示,只保留重要的片段。
一份已做出的测试决策列表。包括:
对本规格范围之外的事项的描述。
关于该功能的任何补充说明。