To-Spec 技能
把已认可决定整理成项目规格,并发布到配置的任务系统。
社区 · Matt Pocock| 作者 | Matt Pocock |
|---|---|
| 许可证 | MIT |
| 来源 | mattpocock/skills · GitHub 上的 SKILL.md |
| 项目官网 | www.aihero.dev/skills-to-spec |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
to-spec 技能将已作出决定的对话整理成规格,结合代码库、项目词汇表及架构决策,不重新开展需求访谈。
它确认测试边界,记录用户故事及范围,再通过配置的任务系统发布一份规格。仓库采用本地任务配置时支持 Markdown。
摘自该技能的 SKILL.md: ## Out of Scope
功能
- 阅读现有对话及相关项目决定。
- 确认测试边界,整理规格。
- 将规格发布至配置的任务系统,并使用配置的分类标签。
产出内容
- 一份包含问题、方案、用户故事、实现决定、测试及排除项的规格。
适用场景
- 为跨多个代理会话的工作保存已定决定。
不适用的场景
- 需求未定,或一次实现会话就能完成的小改动。
所需条件
- 具备项目上下文的编码代理及 setup-matt-pocock-skills 任务系统配置。
- 远程任务系统需要已认证工具及发布权限;本地 Markdown 无需远程服务。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 规格模板、测试边界确认和任务系统发布。 |
2026-11-19 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- /to-spec — 整理已确认的账号导出设计,不新增需求。
- /to-spec — 保留范围外决定,先确认测试边界。
- /to-spec #42 — 将这份已定决策图转成可实现规格。
如何安装 to-spec
安装与权限
安装技能,用 setup-matt-pocock-skills 配置仓库任务系统及分类标签。使用前检查生成的项目配置。
这是手动调用技能,disable-model-invocation 为 true。请确认目标及发布权限;本网站不会创建任务系统条目。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p ~/.claude/skills
cp -R skills/skills/engineering/to-spec ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /to-spec,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/mattpocock/skills.git
mkdir -p .agents/skills
cp -R skills/skills/engineering/to-spec .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
记录已作出的决定
规格应保留项目词汇和真实排除项,不应为填满章节而编造决定。
跨会话工作可将规格交给 to-tickets。两步保持在同一上下文可避免重新获取超大任务正文。
关于 to-spec 的常见问题
它会访谈我吗?
不会重新开展需求访谈,但会确认建议的测试边界是否符合预期。
必须使用 GitHub 吗?
不必。使用配置的任务系统,可以是本地 Markdown 或支持的远程系统。
to-prd 是同一命令吗?
作者已将流程更名为 to-spec,请使用当前安装的技能名。
ready-for-agent 会触发不想要的工作吗?
会,轮询代理可能把父规格当作工作项。请明确将其排除在该代理的工单选择范围之外。
更多 AI 技能
相关技能
To-Tickets 技能
社区 · Matt Pocock把规格拆成可演示的纵向切片,并明确阻塞依赖。Writing Plans 技能
社区 · Jesse Vincent / Prime Radiant把已认可的设计转成可审阅的工程任务,明确接口与验证方式。Brainstorming 技能
社区 · Jesse Vincent / Prime Radiant在编写实现代码前,把初步想法整理为双方认可的设计。Subagent-Driven Development 技能
社区 · Jesse Vincent / Prime Radiant通过全新执行者、限定范围的审阅及任务记录执行已认可计划。n8n 自托管技能
社区 · Romuald Członkowski用 Docker 部署和维护 n8n,配置 Caddy HTTPS、私有服务并验证备份。n8n Code JavaScript 技能
社区 · Romuald Członkowski按执行模式编写或调试 n8n JavaScript Code 节点的数据读取与返回值。