用 Matt Pocock 的 Skills 工具包驯服 AI Agent
当开发者开始频繁使用 Claude Code 或 Codex 时，会迅速遭遇同样的问题。Agent 会愉快地接受任务，花五分钟写代码，然后返回五百行乱成一团的代码。听起来很熟悉？Total TypeScript 的作者 Matt Pocock 决定用工程化的方法来解决这个问题，整理了一套实用的 AI Agent 指令（skills）仓库。vinvcn/mattpocock-skills-zh-CN 项目则将这套工具包适配到中文语言模型和混合场景中。
这不是关于开发未来的抽象讨论，而是一套具体的命令和场景，能让语言模型表现得像一个整洁的中级或高级开发者，而不是随机的函数生成器。
Agent 容易出错的四个场景
Matt 总结了开发者在向 AI 交接任务时遇到的典型陷阱，并为每种情况编写了单独的工作协议。
Agent 做的事与请求完全不同
最常见的开发头疼问题是需求偏差。一个人想到一种架构，模型却按自己的口味填充细节。为了弥合这个差距，作者设计了一个 /grill-me 命令（及其工程变体 /grill-with-docs）。
在触碰任何代码之前，Agent 会进行正式的询问。它会问一系列关于边界情况、数据结构和接口需求的问题。在决策树收敛之前，模型不会写一行代码。这能节省数小时的代码重写时间。
模型在不必要的闲聊上浪费上下文
当 Agent 进入一个陌生的项目时，它会开始自创术语，花费数十个 token 解释显而易见的事情。解决方案是创建一个统一领域词汇表文档（在项目中称为 CONTEXT.md）。
/grill-with-docs 命令不只是进行调研，而是立即记录项目术语和架构决策（ADR）。一旦你和 Agent 有了共同语言，对话会大幅缩减，代码中的变量命名也会在所有模块中保持一致。
生成的代码无法运行
当模型在没有反馈的情况下写代码时，它就像在黑暗中工作。它需要测试。/tdd 技能强制 Agent 严格遵循红-绿-重构循环。首先模型写一个失败的单元测试，然后实现恰好足够的代码来通过测试，最后才进行清理。
对于复杂的 bug，有一个单独的 /diagnosing-bugs 场景。它引导模型遵循严格的协议：用测试复现错误、缩小搜索范围、形成假设、添加日志、修复代码，然后运行回归测试。
架构变成一团乱麻
代码生成的速度助长了熵增。为了防止项目变成一团乱麻的意大利面，使用 /improve-codebase-architecture 命令。
它扫描项目，寻找深度模块的候选者（具有简单公共接口和隐藏复杂逻辑的模块）并生成报告。从本质上讲，它是一个直接在终端中进行的常规代码质量审计。
为什么要本地化为中文
原始仓库是用英文编写的，但 vinvcn 的本地化有一个有趣的技术目的。这不仅仅是为了方便中文开发者。
在使用 Qwen 或 DeepSeek 等亚洲 LLM 时，中文的系统提示和指令能减少上下文丢失。模型不会因为表述细节而感到困惑。同时，所有标识符、命令名、文件路径和配置键都保留英文。运行脚本时不会出现问题。
Skills 架构是如何运作的
仓库中的所有 skills 分为两类：
- 用户触发的命令。只有人类通过斜杠手动触发这些。例如，
/ask-matt帮助为当前任务选择合适的 skill，/to-spec将讨论整理成工单，/wayfinder规划多个会话后的重大功能。 - 模型触发的技能。用户和 Agent 都可以主动触发这些，当它发现合适的子任务时。包括 TDD 循环、不强制中止的 git 冲突解决、代码审查和起草。
Skills 以简单的 Markdown 文件形式编写指令。它们易于阅读，可以根据团队的规则进行编辑。
几分钟内完成设置
你可以使用 skills.sh 安装程序将 skills 添加到项目中：
npx skills@latest add vinvcn/mattpocock-skills-zh-CN
该工具会询问你想复制哪些 skills 以及要将其注册到哪些 Agent 目录中。确保选择 /setup-matt-pocock-skills。
安装后，直接在 Agent 对话中运行初始设置：
/setup-matt-pocock-skills
Agent 会确认你在哪里跟踪任务（GitHub Issues、Linear 或本地文件）、使用什么标签进行分类，以及将架构文档存储在哪个文件夹中。
如果你在 Claude Code 中工作，不想在每个仓库中存储文件副本，可以将 skills 作为插件连接：
claude plugin marketplace add vinvcn/mattpocock-skills-zh-CN
claude plugin install mattpocock-skills@mattpocock
在此模式下，skills 会在新版本发布时集中更新。
谁适合使用
两类工程师应该关注这个仓库。
第一类是那些积极使用 Claude Code、Codex 或 OpenCodeInterpreter、受够了与模型幻觉作斗争的人。Matt Pocock 的方法通过严格的约束和短反馈循环将可预测性带回开发中。
第二类是学习如何为 AI 助手编写系统指令的优秀范例。即使你不需要中文翻译，这个仓库中的文件结构也是设计 Agent skills 的清晰课程。试着将几个命令如 /grill-me 融入你的日常工作流程，到晚上你就会注意到差异。
相关项目