AI · 技能库拆解

27.5万人Star的“AI带徒手册”：他把自己的独门手艺全开源了

💡 核心摘要

程序员 Matt Pocock 把自己天天在用的 AI 技能文件全放上了网——不是教程，不是博客，是他干活时真在用的那套“作业指导书”。几个月拿下 27.5 万 star，一半人叫好，一半人骂“AI玄学”。这篇文章用人话讲清楚：技能文件到底是什么、凭什么这么火、争议到底在吵什么，以及你怎么今天就写出自己的第一份。

01 // 狗哥的AI同事，每天上班都失忆

先介绍咱这篇文章的两位主角：狗哥，互联网公司打工五年，最近重度用 AI 写代码；小七，狗哥的 AI 智能体，技术逆天，但有一个人尽皆知的毛病——每天上班都失忆。

周一，狗哥花了半个多小时，跟小七掰扯明白了他们组的规矩：改代码不许动别人的模块、提交前必须跑测试、命名要按组里的前缀来。小七学得飞快，句句“收到”。周二早上，小七把规矩忘得干干净净——因为它压根不记得昨天聊过什么。

狗哥的办法也很朴素：把这些规矩存在手机备忘录里，每天开工前翻出来，复制，粘贴，回车。三个月下来，备忘录攒了四十多条，长短不一，找个东西得划半天。更气人的还在后头：有一次狗哥让小七“把按钮改成蓝色”，小七好心肠大发，顺手把登录模块整个重写了一遍，测试崩了一地。那是周五晚上九点，版本第二天上线，狗哥加班到凌晨一点，一边改一边想骂人。

这里头有个问题，不知道你发现了没有：**狗哥带的这个“徒弟”，武功盖世，却从来没有一份《员工手册》。**现实世界里，哪家工厂敢让新工人靠“师傅口头聊过一次”就上岗？酒店后厨都有作业指导书，冰箱贴一份、案板贴一份，照着做就行。可到了 AI 这个世界，大家却默认“聊天记录就是培训”——聊过就等于教会了，这次说了就等于永远记住了。

后来，狗哥学了一个新招：把那四十多条备忘录，整理成几个文件夹，放进 AI 的技能目录。文件里写清楚“什么时候用、按什么步骤干、干成什么样算完”。现在小七开工时自己会去翻，不用狗哥天天贴了。那句“把按钮改成蓝色”的悲剧，再也没有重演——因为手册里白纸黑字写着：改样式，只许动样式。

狗哥这才反应过来：不是 AI 笨，是我们从没把它当“正式员工”培训过。师傅带徒弟都知道要给作业指导书，我们却指望徒弟靠聊天记录悟道。

狗哥悟出来的这点事，有个人不但早就悟了，还把自己压箱底的“作业指导书”全套晒了出来——然后整个行业都炸了。

02 // 27.5万star：一次“教会徒弟”的社会实验

晒文件的人叫 Matt Pocock，程序员圈子里有名有姓的人物，早年靠讲 TypeScript 教程攒下大批粉丝，这两年转型研究 AI 编程。他干的事说白了特别朴素：**把自己每天干活真实在用的那套技能文件和提示词，原样开成了一个开源仓库。**注意，不是“我教你怎么写提示词”的博客，也不是“建议你这样那样”的教程——是他自己饭碗里的东西。

这个仓库的 star 数冲到了 27.5 万。什么概念？绝大多数开源项目终其一生也就几百个 star，这个数字已经摸到了开源世界的天花板。仓库里大部分是 Shell 脚本和 JavaScript，没有框架、没有依赖、没有“配置两小时才能跑通”的门槛——把文件夹拷进你的 AI 技能目录，就能用。

中国有句老话，叫“教会徒弟，饿死师傅”。手艺人历来有个默契：三分手艺说出口，七分绝活带走。Matt 干的事，等于把七分绝活写成文档贴在了店门口。开源社区里确实有人阴阳怪气：“不就是常识吗？至于封神？”但马上有人回了句大实话，我觉得说得特别好：

** “这是经过社区检验过的常识——而我不需要花时间自己去写、自己去踩坑验证。这就足够有价值了。” 你品品这句话。菜谱白纸黑字写在那里，人人都能买到，但没人会说“菜谱不过是常识”就否认它的价值。**常识不值钱，验证过、整理过、能照着做的常识才值钱。**这 27.5 万个 star，与其说是给 Matt 的，不如说是给“把经验写成文件”这件事本身的。

03 // 原理：技能文件到底是个啥？

好，进入正题。技能文件（Skill）到底是个什么东西？咱们一步步来。

**第一步，先看它长什么样。**说白了，就是个文件夹，里面放一个说明文件，内容是纯文本。大概长这样：

技能名称：改代码前先过一遍需求（grill-me 思路）

什么时候用：用户让你改代码或做新功能的时候

怎么干：

1. 先别动手写代码

2. 把你理解的需求复述一遍，列成清单

3. 对每个模糊的地方，向用户提问确认

4. 用户确认完毕，才开始动手

干成什么样算好：动手之前，用户对你复述的需求说了“对”

就这么个东西，没有魔法。这里你只需要知道它是“写给 AI 看的说明书”就够了，至于 AI 平台内部怎么识别、怎么按需加载，各家实现不一样，咱不展开——反正你记住一句话：它是一份持久存在的文件，不是一句聊完就没的提示词。

第二步，看它和“聊天里说的 prompt”有啥区别。这个区别是整个事情的核心。你平时在对话框里打的那段“请你扮演……注意……”，是一次性的：这个会话结束后，它就烟消云散了，明天还得重新打一遍。而技能文件是躺在硬盘上的，今天用、明天用、明年用，还能拷给同事用。打个比方：聊天 prompt 是你口头嘱咐实习生的话，技能文件是你发到群里、置顶、打印出来贴墙上的部门制度。口头的话第二天就变卦了，制度不会。

**第三步，看 Matt 的仓库里到底装了啥。**大头是工程实战类的东西：代码审查怎么查、重构按什么顺序来、调试怎么一层层追。但真正让他出圈的，是一个叫 grill-me（“来拷问我”）的技能——这名字起得跟它的功能一样凶。

grill-me 干的事，就是上面那份说明书写的事：AI 接到任务不许直接动手，先反过来“拷问”你，把你脑子里模糊的想法一条条逼问清楚，确认完毕才开工。你可能会问了：这不就是把 AI 搞得更啰嗦了吗？还真不是。你回想一下装修的经历就懂了：靠谱的装修队开工前，会上门量房、问清哪里留插座、柜子做多深——问得越细，后面返工越少。不靠谱的师傅呢？你一句“给我装修下”，他上来就砌墙，砌完你才发现电视没地方挂。AI 默认是后一种师傅，grill-me 把它掰成了前一种。一个用了这套东西的工程师说，这个技能帮他揪出了好几个“想破头都没想到的边角情况”。

看到这儿，你可能觉得这事儿稳了：抄作业呗。先别急——评论区里吵得最凶的，恰恰是“这作业到底能不能抄”。

04 // 争议：是黄金，还是“AI玄学”？

论坛里这场架打得相当热闹，两边阵容还特别有意思——我先给你还原一下双方火力。

质疑派的炮火主要集中在三点。第一，“这不都是常识吗？”——一位干了多年的工程师直言，里面的东西都是“事后看显而易见的道理”。第二，“star 数毫无意义”。第三，也是最狠的一刀，有人给这类技能起了个外号，叫**“AI 玄学”（AI Astrology）**——意思是：除了写技能的作者本人，没人说得清这些文字到底怎么影响模型的输出。你 overlay 一层自定义规则上去，把模型原生的行为盖掉了，效果可能变好，也可能变差，而你没有对照实验，全凭感觉——“感觉变好了”，跟星座运势的验证方式没区别。更麻烦的是保质期问题：三个月前写的技能，配上三个月后升级的模型，可能不但没用，还有害。

支持派也不是嘴上功夫。一位二十多年工龄的老工程师说，他天天用，“不是词藻堆砌”；另一条评论补上了关键一刀：**在企业环境里，能被接受的东西只有一种——可重复、可度量、确实提效。**技能文件恰好是可重复的：同一个技能跑一百次，动作是一致的，效果是可以量的。

那到底谁对？我的看法是：都对，但他们吵的根本不是同一件事。

质疑派吵的其实是“内容”—— Matt 那些具体条文，是给他自己的工作流量身定制的，你全盘照搬，大概率水土不服。这一点连支持派都承认，Matt 自己也没打算做一个人人通用的东西。而支持派说的其实是“形式”——把经验写成文件、让 AI 照章办事、每次都按同一套流程走，这个形式本身是扎实的、可度量的。

还有一个身份差异藏在水面下：给好评的多是真拿它干活的人，开喷的不少是“看不上别人被封神”的同行。有条评论说得很刻薄但很真实：一部分狂热追捧它的，恰恰是没读过几本软件工程书的门外汉——对他们来说这是神迹，对老手来说这是常识。**同一份文件，在会看的人手里是杠杆，在不会看的人手里是拐杖。**杠杆用久了肌肉更发达，拐杖拄久了就离不开了。

别人的技能文件是别人的地图，照着走能到地方，但路要自己修才算本事。

05 // 三步搞定，今天就写出你的第一份技能文件

来，咱们实际操作一下。假设你从没玩过这套东西，手头也不写代码，跟着走就行。

第一步：找到你AI的“员工柜”

主流 AI 编程工具（Claude Code、Cursor 这些）都有技能目录，一般在项目根目录下的一个隐藏文件夹里，比如 .claude/skills 或者 .agents。你只需要在这个文件夹下建一个新文件夹、放一个文本文件，就完成注册了。想用 Matt 的现成货，去搜 mattpocock/skills 这个仓库，挑一个文件夹拷进去就行。

**小贴士：**拿不准目录位置？最省事的办法是直接问你的 AI：“你的技能目录在哪？”它会自己告诉你，还能顺手帮你把文件建好——这算不算让 AI 培训它自己，咱不敢深想。

第二步：照着“三问”写内容

一份合格的技能文件，只要回答清楚三个问题：**什么时候用（触发条件）、怎么干（步骤）、干成什么样算好（验收标准）。**写的时候用你自己的大白话，别端着，AI 读得懂人话。

第三步：说句话触发，验证它生效了

重新开一个会话，说一句跟技能相关的话，看它的反应有没有变。比如你写了“改代码前先过需求”的技能，就输入“帮我加个搜索框”——如果它先给你复述需求、列问题清单，而不是直接噼里啪啦写代码，恭喜，生效了。

两个真实场景

📦 场景 A：不写代码的人——周报技能

输入：一份流水账（“这周做了 A 项目上线、开了三个会、修了两个 bug”）。技能文件里写清楚：周报必须按“结果—数据—风险”三段写、每段不超过三行、先给结论、数据用具体数字。输出：每周格式统一、老板扫一眼就懂的周报。解决什么问题：每周五从“想措辞”变成“填内容”，十分钟收工。

📦 场景 B：程序员——“先计划后动手”技能

输入：一个开发任务（“给订单加个取消功能”）。技能文件里写清楚：动手前先列出改动涉及的文件和风险点，等我确认后才许改代码；禁止改动计划之外的文件。输出：一份带风险提示的改动计划 + 你确认后的精准修改。解决什么问题：就是狗哥那个“改按钮结果登录模块被重写”的悲剧，从机制上断根。

一段对话，感受一下grill-me的脾气

**你输入： 给我的博客加个评论功能。

**小七返回：**动手之前，先确认几件事：1. 评论需要登录才能发，还是游客可发？2. 要不要支持回复和嵌套？3. 敏感词过滤用现成服务还是自己写？4. 大概预期多少评论量？这决定要不要分页方案。

**你再说：**游客可发，先不要嵌套，用现成过滤，量不大。

**小七返回：**明白。复述一下最终方案……确认无误，我开始动手。 是不是有点像被甲方折磨的自己？这就对了——你受过的折磨，最好让 AI 也受一遍，它才长记性。

避坑提示，三条都是真金白银换来的

• 别贪多。 技能文件不是越多越好——AI 开工时能带的“注意力”是有限的，你塞一整个仓库进去，等于让实习生先读一百页制度再干活，读完了活儿也不用干了。论坛里说得很直白：大多数这类配置膨胀得飞快，小而专的技能才真正好使。一次装一两个，真用顺了再加。

• 写进文件的经验会过期。 模型每隔几个月就换代，今天的金牌经验可能就是明天的绊脚石。给自己的技能文件定个“回检日”，模型升级后拿出来跑一遍，没用的就删。《韩非子》两千年前就说了：“世异则事异，事异则备变”——世道变了，做事的方法就得跟着变。技能文件也一样，它不是刻在石头上的。

• 抄思路，别抄文件。 这大概是最值钱的一条。Matt 仓库里的具体条文是为他的工作流定制的，你照搬过来八成水土不服；但他“把经验整理成文件、定好验收标准、让 AI 可重复执行”的思路，谁都能拿走。而且自己动手写的那份，才是真正长在你身上的——有条评论说得很扎心也很对：绕过撞墙的过程，技能就不会留在你身上。

06 // 未来：你的下一段职业经历，可能是一个文件夹

最后，咱们把镜头拉远一点，看看这件事真正在改变什么。

你有没有发现，“经验”这个东西的形态，正在起变化？过去，经验长在人脑子里，师傅退休，经验跟着进火葬场；后来，经验写成了书，但书的更新速度追不上行业变化；现在，经验第一次可以变成活的文件——能执行、能迭代、能被验证、能直接上手干活。Matt 那 27.5 万个 star 说明一件事：大家愿意为一个“经验文件包”狂欢，这在五年前是不可想象的。

再往深想一层。老话说“教会徒弟，饿死师傅”，这话建立在“手艺不可复制”的前提下——师傅的产出就那么多，徒弟抢一份，师傅就少一份。但 AI 时代这个前提被抽掉了：徒弟越教越多，师傅反而越来越值钱。为什么？因为徒弟给师傅交作业、交反馈、交真实场景里的坑，Matt 的仓库就是这么滚起来的——他自己在用，社区在提意见，文件一直在迭代。手艺第一次变成了越分享越增值的东西。当然，评论区也有人泼冷水说“这是卖课的引流漏斗”——你看，争议本身就是流量，争议本身就是生意。

对咱们普通人来说，真正要紧的信号是这个：**你的竞争力，可能很快不再用“你会做什么”来衡量，而是用“你沉淀了什么”来衡量。**同样用 AI 干活，一个人每次从零开始教，另一个人有一套自己迭代了两年的技能文件——两三个月后，差距会大到像两个人在跟不同的 AI 合作。好消息是，这套东西的入场费低得离谱：一个文件夹，一个文本文件，今天下班就能写第一份。

AI 的记性只有一天，但文件的记忆是一辈子。狗哥已经把小七培训成了正式员工，你那位“每天失忆的天才实习生”，还光着膀子等编制呢。

把经验写进聊天记录，它活一晚上；写进技能文件，它活一辈子。