Skills For Real Engineers

# Skills For Real Engineers：安装说明

这个工具包里只有安装说明，由 Mindket 编写。技能、插件和安装方式都来自 Matt Pocock 的仓库：https://github.com/mattpocock/skills

这些说明不是 Matt Pocock 写的，也没有得到他的认可。他的 README 把这个仓库叫作“Skills For Real Engineers”，并说：“My agent skills that I use every day to do real engineering - not vibe coding.”，意思是：这是他每天用来做真正工程的 agent 技能，不是凭感觉写代码。这里没有复制仓库里的任何技能文件。

许可证：MIT。LICENSE 文件（https://github.com/mattpocock/skills/blob/main/LICENSE）写的是“Copyright (c) 2026 Matt Pocock”。

这些说明参考的页面：README（https://github.com/mattpocock/skills/blob/main/README.md）、作者的安装说明（https://github.com/mattpocock/skills/blob/main/.agents/install-block.md）、SCOPE.md（https://github.com/mattpocock/skills/blob/main/SCOPE.md）、CONTRIBUTING.md（https://github.com/mattpocock/skills/blob/main/CONTRIBUTING.md）、https://github.com/mattpocock/skills/tree/main/skills 下每个技能的 SKILL.md，以及 https://github.com/mattpocock/skills/tree/main/docs 下的文档页，比如 setup-matt-pocock-skills、grill-me 和 grill-with-docs。关于 skills.sh 安装器的内容来自它自己的 README（https://github.com/vercel-labs/skills）。命令都是从这些页面照抄的，Mindket 没有运行过。

## README 说它是什么

这些技能“small, easy to adapt, and composable”（小巧、容易改、能组合），而且“They work with any model.”（适用于任何模型）。README 把它们和那些包办整个流程的做法对照：它说那些做法会拿走你的控制权，让流程里的 bug 难以排查。它点出这些技能针对的四种失败：agent 没做你想要的，agent 太啰嗦，代码跑不通，代码库变成一团泥球。

## 会装进什么

会安装的技能放在仓库的两个分类文件夹里：engineering 和 productivity。misc/、in-progress/ 和 deprecated/ 没有被推荐，也不会随插件发布。README 又把每个文件夹分成两类：

- 用户触发的技能，只在你输入时运行，负责编排。
- 模型触发的技能，你可以输入，agent 也会在任务合适时自己调用。它们装着可复用的做法。

用户触发的技能可以调用模型触发的技能，但不能调用另一个用户触发的技能。

Engineering，用户触发：

- ask-matt：你问它哪个技能或流程适合你的情况，它是这个仓库里用户触发技能的路由器。
- grill-with-docs：一轮轮访谈，同时建立项目的领域模型，并更新 GLOSSARY.md 和 ADR。
- triage：让问题在一组分诊角色的状态机里流转。
- improve-codebase-architecture：扫描代码库里值得加深的地方，用可视化的 HTML 报告呈现。
- setup-matt-pocock-skills：给仓库配置工程类技能，每个仓库运行一次。
- to-spec：把当前对话变成规格，发布到问题跟踪器。
- to-tickets：把计划或规格拆成曳光弹式的任务单，每张写明它被什么阻塞。
- implement：做出规格或任务单描述的工作，用 tdd 驱动，最后用 code-review 收尾。
- implement-spec：在一个集成分支上实现整份规格，由实现子 agent 处理就绪的任务单。
- wayfinder：把一个会话装不下的大工作，画成问题跟踪器上的一张决策任务单地图。
- retro：一次会话之后，建议改进编码 agent 的环境。

Engineering，模型触发：prototype、diagnosing-bugs、research、tdd、domain-modeling、codebase-design、code-review、pr 和 wizard。

Productivity，用户触发：grill-me、handoff、teach、to-questionnaire 和 wait-what。

Productivity，模型触发：grilling 和 writing-for-agents。

来源：https://github.com/mattpocock/skills/blob/main/README.md（“Reference”一节）

## 先准备好什么

- 一个编码 agent：Claude Code、Codex、GitHub Copilot（命令行或 VS Code）、Gemini CLI，或 skills.sh 安装器支持的其他 agent。
- Node.js 22.20 或更高，只有 skills.sh 这条路需要，因为它运行 `npx skills`。npm 上的 `skills` 包在 engines 字段里写了这个要求（https://registry.npmjs.org/skills/latest）。
- 一个记问题的地方。设置技能可以选 GitHub（`gh` 命令行）、GitLab（`glab` 命令行）、本地 Markdown 文件，或你自己描述的另一种。GitHub 或 GitLab 跟踪器需要一个能访问的仓库。没有指向该站点的远程仓库时，设置技能会向你要地址并替你添加（需要时先 `git init`）。

## 按 agent 安装

README 说每个 agent 只选一种方式，因为插件和 skills.sh 一起装，每个技能会出现两份。

- setup/claude-code.md
- setup/codex.md
- setup/github-copilot.md
- setup/gemini-cli.md
- setup/other-agents.md：Cursor、OpenCode、Devin、Windsurf、Amp、Pi 等，通过 skills.sh
- setup/first-run.md：在仓库里运行 /setup-matt-pocock-skills，以及这些技能遵循的流程

## 更新和卸载

每种安装方式的更新规则写在对应 agent 的文件里。README 没有给出卸载步骤。skills.sh 这条路可以用 skills 命令行工具的 `npx skills remove`（https://github.com/vercel-labs/skills）。

## 数据

读过的这些页面（README、安装说明、SCOPE.md 和 CONTRIBUTING.md）没有说技能本身有服务器或数据收集。技能是你的 agent 照着做的说明，所以技能让 agent 读到的内容，会发给你的模型提供商。skills.sh 安装器是另一个工具，它说自己会收集匿名使用数据，见 setup/other-agents.md。

## 跟进变化

README 链接了一份简报，用来跟进这些技能的变化和新技能：https://www.aihero.dev/s/skills-newsletter

## 参与贡献

CONTRIBUTING.md 说拉取请求只对协作者开放。SCOPE.md 说新技能的提议和贡献已经关闭。如 SCOPE.md 所说，skills.sh 这条路会给你可编辑的副本，用来做你自己的改动。

README.md  6 KB
setup/claude-code.md  2 KB
setup/codex.md  2 KB
setup/first-run.md  5 KB
setup/gemini-cli.md  1 KB
setup/github-copilot.md  2 KB
setup/other-agents.md  3 KB