前言让我从定义开始因为这里存在不少混淆。Skill 这个词现在到处都在用含义却越来越模糊。有人把它当「给 AI 的一小段提示词」有人把它当「一个插件」还有人干脆把它当成 buzzword碰都不想碰。这种语义扩散我很熟悉我看过太多好概念在流行过程中失去准头。这一课不急着夸它先把它是什么、不是什么、解决什么、不解决什么划清楚。边界画明白了后面的课程才好用。一、先定义Skill 到底是什么mattpocock/skills 是 TypeScript 专家 Matt Pocock 公开的个人 AI 技能集。他创办了 Total TypeScript一个很有名的 TypeScript 学习平台也在 Vercel 工作过。2026 年 2 月他把仓库公开很快冲到近 20 万星。它为什么受欢迎我的理解是他公开的不是又一个 AI 框架而是他自己每天都在用的工作流文件。这是从真实项目里长出来的东西不是演示用的玩具。每个技能就是一个SKILL.md文件定义了一套结构化的工作流。AI 一旦加载它就按这套流程走而不是凭感觉自由发挥。关键区分在这prompt一次性指令你说这次做什么skill 可复用工作流规定每次该怎么做prompt 是对话说完就散skill 是流程装进去就持续生效。这个区别很重要因为它决定了你在跟 AI 的每一次对话中是「碰运气」还是「走流程」。这里有个比喻我用了很多年跟 AI 时代也说得通你不必是电气工程师才能用电但你至少得知道开关在哪。Skill 就是流程里的那个开关你知道什么时候打开它/grill-me什么时候它会自己亮起来写代码时自动启用tdd就够了。二、它解决什么问题AI 编码的四个常见失败Matt 把 AI 编码里最常见的失败归纳成四类。注意我的用词是「常见」不是「全部」。这四类是他的观察用我习惯的说法是 anecdotal evidence来自他自己的实战经验不是严谨的行业统计。这不妨碍它有用但你要知道它的来源。失败一AI 没做你想要的事你脑补了一个订单系统的需求让 AI 开工。结果它做出来的东西跟你想的差了十万八千里。解法是grill-me这类追问式访谈技能让 AI 在动手前不停问你问题直到把需求彻底问清楚。失败二AI 太啰嗦你让它改一行代码它给你写三百字解释还自创一堆术语。解法是建立共享语言项目里维护一个CONTEXT.md把术语、概念、模块关系写清楚AI 一进来就能说人话。失败三AI 写出来的代码不工作AI 写得飞快但没有反馈回路它根本不知道自己写错了。解法是tdd和diagnosing-bugs先写会失败的测试再写实现让 AI 随时知道自己的代码能不能跑。失败四项目被改成一坨浆糊AI 提速了编码也加速了软件熵代码库以史无前例的速度变复杂。解法是codebase-design和improve-codebase-architecture强迫 AI 在设计上花心思。这四大失败模式就是全系列的骨架。本系列后续课程会逐个拆解对应的技能。三、它不是什么划清边界定义一件事最好同时说清它不是什么。这一节很重要因为我看过太多工具死于「什么都想要」的自我膨胀。它不是一个能力插件包。仓库里没有「让 AI 会调浏览器」「让 AI 能查数据库」这类技能。它不扩展 AI 的能力边界只约束 AI 的工作方式。它不是银弹。装了它AI 不会自动变聪明也不会保证代码零 bug。它改变的是流程动手前先问、写码前先测、提交前先审。流程能降低出错的概率不能消灭出错的可能。它不是「替你做决定」。这套东西的哲学是给你可组合的纪律而不是接管整个项目替你拍板。要不要用某个技能、用多严决定权还是在你。一句话总结边界它约束 AI 怎么干活不决定 AI 干什么活。四、安装两种选择一种权衡安装方式有两条代表两种不同的权衡不是优劣之分。二选一别都装都装会让每个技能出现两次。方式一Claude Code 插件订阅派Claude Code 里直接装官方市场插件claude plugins install mattpocock-skills或者在 Claude Code 会话里输入/plugin install mattpocock-skills它的特点只读捆绑。技能以管理包形式装好Matt 每次更新你自动收到。你订阅而不是 fork。方式二skills.sh拥有派想自己改、自己 hack 的用这个npx skillslatest add mattpocock/skills它会问你选哪些技能、装到哪些 agent 上然后把技能文件复制成你项目里普通可编辑的文件。装完你完全拥有这些文件想怎么改怎么改。之后想同步作者的更新npx skills update对大多数读者我的建议先走方式一插件用起来等用熟了、想定制了再换方式二文件版。这跟我看软件许可证的立场很像订阅还是拥有取决于你想要便利还是要控制权没有哪个绝对正确。对多数人先用起来比先折腾重要。注意无论做哪种选择记得把setup-matt-pocock-skills装进去它是整个系列的初始化入口。五、初始化跑一次 setup装完后在每个仓库里运行一次初始化就一次/setup-matt-pocock-skills它会问你三个问题用哪个 issue tracker GitHub、Linear还是本地文件triage 时用什么标签/triage技能要用标签来管理 issue文档存哪里 生成的 spec、ADR 等放哪个目录回答完你的仓库就配置好了技能系统开始生效。对 EShop 项目来说建议issue tracker本地文件个人项目不需要 GitHub 的完整流程triage 标签bug / feature / refactor文档目录docs/六、跑通第一个技能让 AI 先问再做装好之后来试最有代表性的一个grill-me。它的作用是让 AI 在动手前追着你问问题。在会话里输入/grill-me然后告诉它你想做的事比如我想给 EShop 加一个下单功能用户把商品加入购物车后统一结算。接下来会发生什么AI 开始不停问你问题比如订单金额怎么算、优惠券叠加规则、库存不足怎么办、并发下单怎么处理。它会追着你问直到把决策树的每个分支都问清楚。这正是解决「失败一」的关键动手之前先对齐。你可能会觉得烦。第一次被问十个问题确实比「AI 直接甩代码」慢。但慢在这里是为了不慢在后面。需求没对齐时写出来的代码返工的成本远超这十分钟。七、技能系统怎么运转两种触发方式整个技能集分两类触发方式理解了这一点你就掌握了它的骨架。user-invoked用户触发必须由你显式输入比如/grill-me、/to-spec。它们负责编排启动一个流程。model-invoked模型触发模型自己判断「这个任务该用这个技能」自动调用。比如你在写代码模型自动启用tdd的纪律。它们承载可复用纪律。规则只有一条user-invoked 可以调用 model-invoked但 user-invoked 绝不调用另一个 user-invoked。这条规则防止了「流程套流程」的无限循环。编排类技能负责启动纪律类技能负责执行层次清晰。八、这套东西和 Trellis 有什么区别如果你看过本仓库的 Trellis 系列这里有个关键对比Trellis 完整的编码工程化框架harness框架接管流程通过 workflow.md 定制主要绑特定平台mattpocock/skills 一组可组合的小技能文件小而灵活完全自控直接改 SKILL.md声明任何模型都能用一句话总结Trellis 是「给你一套完整的流程框架」mattpocock/skills 是「给你一堆可以自由拼装的纪律积木」。没有谁更好取决于你想要框架的省心还是积木的灵活。我个人的倾向是后者因为我从来不相信「一个框架接管一切」的叙事。但这是口味问题不是真理问题。九、何时不要用这一节可能是本课最值得你记住的。mattpocock/skills 设计得很聪明但它不是万灵药。我列出几个场景你大概不需要它你的 AI 编码只是偶尔玩一下。如果你一周才让 AI 写一次代码还不写正式项目那这套技能集的管理成本可能超过收益。它对有持续开发的项目才划算。你的需求极其简单且稳定。一个「把 CSV 转成 JSON」的一次性脚本不值得开一轮 grill 访谈。需求简单到没有决策树可问时直接写更快。你的团队根本不想要流程。这一点我要强调你永远不该把流程强加给不想试的团队。这套技能集再好也是靠纪律吃饭的团队不认同纪律装上了也是摆设。我的经验是先让愿意试的几个人用起来用结果说服而不是用指令强推。你想要的是「AI 替我把一切都搞定」。如果你期待的是输入一句话、拿回一个完整交付物的魔法这套东西会给你相反的东西更多的流程、更多的问题、更多的门禁。它是约束不是解放。如果你不属于以上任何场景那这工具值得一试。这也是我说「it depends」之后的真实内容它适合有持续开发、愿意接受纪律的团队不适合追求「少做点事」的人。