to-spec
把当前对话变成一份 spec,并发布到项目的 issue tracker——不访谈,只综合你们已经讨论过的内容。
- License 许可
- MIT
- 最近更新
- 2026-08-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- to-spec
- description
- 把当前对话变成一份 spec,并发布到项目的 issue tracker——不访谈,只综合你们已经讨论过的内容。
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml134 B
03 SKILL.md 正文
本 skill 取当前对话上下文和对代码库的理解,产出一份 spec。不要访谈用户——只综合你已经知道的。
Issue tracker 和分诊标签词汇本应已提供给你——若没有,运行 /setup-matt-pocock-skills。
流程
-
若尚未探索,先探索仓库以了解代码库当前状态。Spec 通篇使用项目领域词汇表中的用语,并尊重你所触及区域的任何 ADRs。
-
草拟你将用来测试该功能的 seams。已有 seams 优先于新 seams。用尽可能高的 seam。若需要新 seams,在你能提出的最高点提出。代码库里 seams 越少越好——理想数量是一个。
与用户确认这些 seams 符合他们的预期。
- 用下面的模板写 spec,然后发布到项目的 issue tracker。打上
ready-for-agent分诊标签——无需额外分诊。
<spec-template>
Problem Statement
用户面临的问题,从用户视角描述。
Solution
对该问题的解决方案,从用户视角描述。
User Stories
一份长的、编号的用户故事列表。每条用户故事应采用如下格式:
- As an <actor>, I want a <feature>, so that <benefit>
<user-story-example>
- As a mobile bank customer, I want to see balance on my accounts, so that I can make better informed decisions about my spending </user-story-example>
这份用户故事列表应极其详尽,覆盖该功能的所有方面。
Implementation Decisions
已做出的实现决策列表。可以包括:
- 将构建/修改的模块
- 那些模块将被修改的接口
- 开发者给出的技术澄清
- 架构决策
- Schema 变更
- API 契约
- 具体交互
不要包含具体文件路径或代码片段。它们很快就会过时。
例外:若某个原型产出的片段比散文更能精确编码一项决策(状态机、reducer、schema、类型形态),把它内联到相关决策中,并简短注明来自原型。裁到决策含量高的部分——不是可运行的 demo,只是重要片段。
Testing Decisions
已做出的测试决策列表。包括:
- 对什么是好测试的描述(只测外部行为,不测实现细节)
- 将测试哪些模块
- 测试的先例(即代码库里类似类型的测试)
Out of Scope
对本 spec 而言超出范围的事项描述。
Further Notes
关于该功能的任何进一步说明。
</spec-template>
04 同仓库更多 Skills
writing-for-agents
为 agent 写文档。在创建或编辑 skill,或修改 AGENTS.md 或 CLAUDE.md 时使用。
wait-what
停。上一条消息没落地——重新讲一遍。
to-questionnaire
把你无法独自完全回答的决策变成一份问卷,交给别人填。
teach
在本工作区内教用户一项新技能或概念。
handoff
把当前对话压缩成交接文档,供另一个 agent 接手。
grilling
就计划、决策或想法对用户毫不放松地 grilling。在用户想压力测试自己的思考,或使用任何 'grill' 触发短语时使用。