Skills For Real Engineers
面向真实工程师的技能
My agent skills that I use every day to do real engineering - not vibe coding.
我每天用来做真实工程——而不是“氛围编程”的智能体技能。
Developing real applications is hard. Approaches like GSD, BMAD, and Spec-Kit try to help by owning the process. But while doing so, they take away your control and make bugs in the process hard to resolve.
开发真实应用很难。像 GSD、BMAD 和 Spec-Kit 这样的方法试图通过掌控流程来提供帮助。但这样做时，它们夺走了你的控制权，并且让流程中的错误难以解决。
These skills are designed to be small, easy to adapt, and composable. They work with any model. They’re based on decades of engineering experience. Hack around with them. Make them your own. Enjoy.
这些技能被设计得小巧、易于调整且可组合。它们适用于任何模型。它们基于数十年的工程经验。随意折腾它们。把它们变成你自己的。享受吧。
If you want to keep up with changes to these skills, and any new ones I create, you can join ~60,000 other devs on my newsletter:
如果你想跟上这些技能的更新，以及我创建的任何新技能，你可以加入我通讯邮件中约 60,000 名其他开发者：
Installation (30-second setup)
安装（30 秒设置）
Two ways in, two philosophies. The Claude Code plugin installs the whole set as a managed, read-only bundle that updates when I ship, so you subscribe rather than fork. skills.sh copies editable skill files into your project, so you can hack on them and make them your own. Pick one: installing both leaves you with every skill twice.
两种安装方式，两种理念。Claude Code 插件 将整套技能作为受管理的只读捆绑包安装，并在我发布时更新，因此你是订阅而不是复刻。skills.sh 将可编辑的技能文件复制到你的项目中，因此你可以随意修改它们，把它们变成你自己的。选一个：两者都安装会让每个技能出现两次。
1. Get the skills
1. 获取技能
Claude Code
claude plugins install mattpocock-skillsOr, from inside a session:
/plugin install mattpocock-skills
It’s in Claude Code’s official marketplace, so there’s nothing to add first, and updates arrive automatically.
Claude Code
claude plugins install mattpocock-skills或者，在会话内部：
/plugin install mattpocock-skills
它在 Claude Code 的官方市场中，因此无需先添加任何内容，更新会自动到达。
Codex, and other agents
npx skills@latest add mattpocock/skillsPick the skills you want, and which coding agents to install them on. The installer lets you choose which skills to take, so make sure setup-matt-pocock-skills is one of them.
A native Codex plugin is on the roadmap (see .agents/adr/0002-ship-as-a-claude-code-plugin.md).
Codex 和其他智能体
npx skills@latest add mattpocock/skills选择你想要的技能，以及要安装到哪些编码智能体上。安装程序让你选择要采用哪些技能，因此请确保 setup-matt-pocock-skills 是其中之一。
原生的 Codex 插件已在路线图上（参见 .agents/adr/0002-ship-as-a-claude-code-plugin.md）。
For tinkerers
Use the same installer, on any agent, including Claude Code:
npx skills@latest add mattpocock/skillsIt writes the skills into your repo as ordinary files you own and can edit. Nothing updates behind your back; pull my latest changes when you want them with npx skills update.
对于喜欢折腾的人
在任何智能体上使用相同的安装程序，包括 Claude Code：
npx skills@latest add mattpocock/skills它将这些技能作为你拥有且可以编辑的普通文件写入你的仓库。不会在背后更新；当你想要时，用 npx skills update 拉取我的最新更改。
2. Run /setup-matt-pocock-skills
2. 运行 /setup-matt-pocock-skills
In your agent, run it once per repo. It will:
在你的智能体中，每个仓库运行一次。它会：
-
Ask you which issue tracker you want to use (GitHub, Linear, or local files)
-
Ask you what labels you apply to tickets when you triage them (
/triageuses labels) -
Ask you where you want to save any docs we create
-
询问你想使用哪个问题跟踪器（GitHub、Linear 或本地文件）
-
询问你在分诊工单时应用哪些标签（
/triage使用标签） -
询问你想把创建的任何文档保存在哪里
3. Bam - you’re ready to go.
3. 搞定——你可以开始了。
Why These Skills Exist
这些技能为什么存在
I built these skills as a way to fix common failure modes I see with Claude Code, Codex, and other coding agents.
我构建这些技能是为了修复我在 Claude Code、Codex 和其他编码智能体中看到的常见失败模式。
#1: The Agent Didn’t Do What I Want
#1：智能体没有做我想要的事
“No-one knows exactly what they want”
David Thomas & Andrew Hunt, The Pragmatic Programmer
“没有人确切知道自己想要什么”
David Thomas 和 Andrew Hunt，《程序员修炼之道》
The Problem. The most common failure mode in software development is misalignment. You think the dev knows what you want. Then you see what they’ve built - and you realize it didn’t understand you at all.
问题。软件开发中最常见的失败模式是错位。你以为开发者知道你想要什么。然后你看到他们构建的东西——你意识到它根本没理解你。
This is just the same in the AI age. There is a communication gap between you and the a
在 AI 时代也是如此。你和智能体之间存在沟通鸿沟。