to-spec
把当前对话整理成一份规格并发布到项目的 issue 跟踪器:不做访谈,只综合你们已经讨论过的内容。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- to-spec
- description
- 把当前对话整理成一份规格并发布到项目的 issue 跟踪器:不做访谈,只综合你们已经讨论过的内容。
- commit_version
- 5c89081d4bbeb3d039a42093653f90bb698d780e
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml128 B
03 SKILL.md 正文
本技能利用当前对话上下文和对代码库的理解产出一份规格。不要访谈用户;只综合你已经知道的东西。
issue 跟踪器和 triage 标签词汇表应该已经提供给你了。如果没有,告诉用户运行 /setup-matt-pocock-skills。
流程
-
探索仓库以了解代码库的现状(如果还没做过)。在整个规格中贯穿使用项目领域术语表的词汇,并尊重你触及区域内的任何 ADR。
-
勾画出你将在哪些 seam 上测试这个功能。已有 seam 优先于新 seam。使用尽可能高的 seam。如果需要新 seam,在你能达到的最高点提出它们。整个代码库中 seam 越少越好——理想数量是一个。
与用户确认这些 seam 符合他们的预期。
- 使用下面的模板撰写规格,然后发布到项目的 issue 跟踪器。应用
ready-for-agenttriage 标签——不需要额外的 triage。
<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
本规格范围之外事项的说明。
Further Notes
关于该功能的任何补充说明。
</spec-template>
04 同仓库更多 Skills
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。