给真正工程师用的 Skills（简体中文版）
Matt Pocock 的 mattpocock/skills：第三方简体中文本地化，非官方仓库。这些 agent skills 是他每天用于真实工程工作的，不是 vibe coding：小、易改、可组合，适用于任何模型。
本仓库定期同步上游，并额外支持 DeepSeek Harness（dsh）插件安装，安装后以 /zh-<name> 调用任意技能（上游没有的能力，详见 dsh-plugin/README.md）。
30 秒安装
npx skills@latest add vinvcn/mattpocock-skills-zh-CN
选择你想安装的 skills，以及要安装到哪些 coding agents。首次安装时请确保选择 /setup-matt-pocock-skills，然后在 agent 中运行它来完成 issue tracker、labels 和 docs 目录配置。
skills.sh 与 plugin 方式每个 agent 只选其一：两种都装会让每个 skill 被安装两次。
或者在 Claude Code 中运行：
/plugin marketplace add vinvcn/mattpocock-skills-zh-CN
/plugin install mattpocock-skills@mattpocock
或者在 DeepSeek Harness（dsh） 中安装为插件（上游没有的安装路线）：
dsh plugin --profile web add @vinvcn/dsh-mattpocock-skills-zh
安装后以 /zh-<name> 调用任意技能，例如 /zh-grilling。详见 dsh-plugin/README.md。
关于这个中文版
文档和技能说明已翻译；目录名、技能名、命令、代码块、路径和工具标识保持不变，以免破坏安装和运行行为。
中文版本不只是为了阅读方便。对中文母语用户来说，中文说明能减少概念转换成本；对以中文为主要交互语言或中文语料优化的模型来说，中文 prompt 和 skill instructions 也更容易贴合中文上下文，减少中英混杂带来的歧义。
本仓库按内容刷新方式同步上游，不同步上游 Git 历史或仓库管理状态。同步翻译由 Codex 执行，人工审核每一次更新后由维护者通过 PR 纳入 main；维护规则见 .skills/translate-skill/SKILL.md。
翻译策略是 skill-guided content localization：把上游 mattpocock/skills 当作英文内容来源，只翻译自然语言说明，保留目录名、skill name、frontmatter key、命令、代码块、路径、URL、package/tool/API identifiers 和行为关键 labels。用户可见的安装路径统一保持为 vinvcn/mattpocock-skills-zh-CN。
最新同步与验证
想请求翻译仓库里的英文术语，或认领翻译 PR？先读贡献指南；已请求与已决定的译法记录在翻译术语表。
原版 README 翻译
我每天用于真实工程工作的 agent skills，不是 vibe coding。
开发真实应用很难。GSD、BMAD、Spec-Kit 这类方法试图通过接管流程来帮你。但它们在接管流程的同时，也拿走了你的控制权，并让流程里的 bug 更难解决。
这些 skills 被设计得小、易改、可组合。它们适用于任何模型，背后是数十年的工程经验。你可以 hack 它们，让它们变成自己的东西。
如果你想跟进这些 skills 的更新，以及我后续创建的新 skill，可以加入大约 60,000 名开发者订阅的 newsletter：
订阅 Newsletter
安装（30 秒 setup）
Plugin 会自我更新；skills.sh 把可编辑文件复制进你的项目，更新由你手动完成。每个 agent 只选一种方式：两种都装会让每个 skill 被安装两次。
1. 获取 skills
claude plugin marketplace add vinvcn/mattpocock-skills-zh-CN
claude plugin install mattpocock-skills@mattpocock
默认自动更新。上游英文原版位于官方 marketplace（claude plugin install mattpocock-skills@claude-plugins-official）；中文版通过本仓库自己的 marketplace 安装。
codex plugin marketplace add vinvcn/mattpocock-skills-zh-CN
codex plugin add mattpocock-skills@mattpocock
启动时自动更新。
copilot plugin marketplace add vinvcn/mattpocock-skills-zh-CN
copilot plugin install mattpocock-skills@mattpocock
然后一次性地把下面内容加进 ~/.copilot/settings.json：
{
"extraKnownMarketplaces": {
"mattpocock": { "source": { "source": "github", "repo": "vinvcn/mattpocock-skills-zh-CN" }, "autoUpdate": true }
}
}
在 VS Code 中运行 Chat: Install Plugin From Source，输入 https://github.com/vinvcn/mattpocock-skills-zh-CN。它会每日更新。
gemini skills install https://github.com/vinvcn/mattpocock-skills-zh-CN.git --path skills/engineering
gemini skills install https://github.com/vinvcn/mattpocock-skills-zh-CN.git --path skills/productivity
更新时重新运行这两条命令。
npx skills@latest add vinvcn/mattpocock-skills-zh-CN -a <agent> # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose
安装器询问要取哪些 skills 时，确保包含 setup-matt-pocock-skills。更新：运行 npx skills@latest update，并重新运行 add 以获取新增的 skills。
2. 运行 /setup-matt-pocock-skills
在你的 agent 中，每个 repo 运行一次。它会：
- 询问你要使用哪个 issue tracker（GitHub、GitLab、local files，或任何你描述的其他方式）
- 询问你 triage issues 时使用哪些 labels（
/triage 会使用这些 labels）
- 询问要把创建的 docs 保存到哪里
3. 完成，即可开始使用。
为什么这些 Skills 存在
我创建这些 skills，是为了解决我在 Claude Code、Codex 和其他 coding agents 中反复看到的常见失败模式。
#1: Agent 没有做我想要的东西
"No-one knows exactly what they want"
David Thomas & Andrew Hunt, The Pragmatic Programmer
问题：软件开发中最常见的失败模式是 misalignment。你以为开发者理解了你想要什么；等看到做出来的东西，才发现对方完全没理解。
AI 时代也是一样。你和 agent 之间存在沟通缺口。修复方式是一次 grilling session，让 agent 针对你要构建的东西提出详细问题。
解决方式是使用：
这些是我最常用的 skills。它们帮助你在开始前和 agent 对齐，并深入思考你要做的变更。每次想做变更时都值得使用。
#2: Agent 太啰嗦
With a ubiquitous language, conversations among developers and expressions of the code are all derived from the same domain model.
Eric Evans, Domain-Driven-Design
问题：项目开始时，开发者和真正使用软件的人（domain experts）通常说着不同语言。
我在 agents 身上也感受到同样张力。Agents 往往被丢进一个项目，然后被要求边做边弄懂术语。于是它们用 20 个词解释本来 1 个词就够的东西。
解决方式是 shared language。它是一份帮助 agents 解码项目术语的文档。
这是我 course-video-manager repo 中的一个 glossary 示例（文件在该 pinned commit 中仍名为 CONTEXT.md，出自这些 skills 重命名这一约定之前）。哪一个更容易读？
This is the beginning of the README. Read the rest at the original. Read the full README ↗
