to-spec
将当前对话转化为规格并发布到项目问题跟踪器——不进行访谈,只综合已经讨论过的内容。
- License 许可
- MIT
- 最近更新
- 2026-07-23
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- to-spec
- description
- 将当前对话转化为规格并发布到项目问题跟踪器——不进行访谈,只综合已经讨论过的内容。
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml133 B
03 SKILL.md 正文
本技能利用当前对话上下文和对代码库的理解产出规格(你也可能将这类文档称为 PRD)。不得访谈用户——只需综合你已经知道的内容。
问题跟踪器和分诊标签词汇应当已经提供给你——如果没有,请运行 /setup-matt-pocock-skills。
流程
-
如果尚未探索仓库,请进行探索以了解代码库当前状态。整份规格都使用项目领域术语表中的词汇,并遵守所涉及区域的所有 ADR。
-
勾勒出将用于测试该功能的接缝。应当优先选择现有接缝,而不是创建新接缝。尽可能使用最高层级的接缝。如果需要新接缝,请在尽可能高的位置提出。整个代码库中的接缝越少越好——理想数量是一个。
向用户确认这些接缝是否符合预期。
- 使用下方模板编写规格,然后发布到项目问题跟踪器。应用
ready-for-agent分诊标签——无需进一步分诊。
<spec-template>
问题陈述
从用户角度描述用户面临的问题。
解决方案
从用户角度描述问题的解决方案。
用户故事
一份很长的用户故事编号列表。每个用户故事都应使用以下格式:
- 作为 <actor>,我希望 <feature>,从而 <benefit>
<user-story-example>
- 作为移动银行客户,我希望查看账户余额,从而能够对消费作出信息更充分的决策 </user-story-example>
这份用户故事列表应当极其详尽,并覆盖功能的所有方面。
实现决策
列出已经作出的实现决策。可以包括:
- 将构建/修改的模块
- 将修改的这些模块的接口
- 开发者给出的技术澄清
- 架构决策
- Schema 变更
- API 契约
- 具体交互
不得包含具体文件路径或代码片段。它们可能很快过时。
例外:如果原型产出的片段能比文字更精确地编码某项决策(状态机、reducer、schema、类型形态),则将其内联到相关决策中,并简短注明它来自原型。只保留决策信息丰富的部分——不是可运行演示,只是重要片段。
测试决策
列出已经作出的测试决策。包括:
- 描述什么是好测试(仅测试外部行为,而不是实现细节)
- 将测试哪些模块
- 测试的既有范例(即代码库中的类似测试类型)
超出范围
描述本规格范围之外的内容。
补充说明
有关该功能的任何补充说明。
</spec-template>
04 同仓库更多 Skills
writing-great-skills
出色编写和编辑技能的参考资料——让技能具备可预测性的词汇与原则。
teach
在此工作区内向用户教授新的技能或概念。
handoff
将当前对话压缩成交接文档,以便另一个智能体接手。
grilling
围绕计划、决策或想法对用户进行不留情面的深度追问。当用户想对自己的思路进行压力测试,或使用任何“深度追问”触发措辞时使用。
grill-me
通过不留情面的深度追问打磨计划或设计。
obsidian-vault
使用 wikilink 和索引笔记搜索、创建和管理 Obsidian 仓库中的笔记。当用户想要在 Obsidian 中查找、创建或整理笔记时使用。