夜雨聆风上回掀完 Claude Code 的引擎盖，评论区最多的一句话：「道理都懂了，但我怎么给它写技能包？」今天就写这个。
——————————————————————————————
先说结论：prompt 不是不够好，是不够稳
上篇我拆完 Claude Code 的五层架构之后，一个做电商的朋友发来一条消息，我笑了半天。
「我懂了！AI 需要运行系统！所以我每次用 AI 之前，都给它打一段 800 字的 system prompt。」 我问他：那你每次打那段 800 字要多长时间？ 他说：「两分钟吧……但有时候忘了打，它就瞎搞，白干半小时。」 你看，这就是问题。 prompt 是有用的——但它像口头交代。你今天跟员工说「这个项目要注意三点」，他记住了，明天他可能就忘了一两点。后天你不在，新来的员工根本不知道有这回事。 而 SOP——或者说，给 AI 写的「技能包」——是把你的经验写成一个它每次都会自动调用的文件夹。你不需要重复交代。它每次开工之前，系统自动把这份东西塞到它面前。prompt 解决的是「这一次怎么做」，技能包解决的是「每一次都这么做」。这两件事的差距，就是「用 AI 提高效率」和「用 AI 建立系统」的差距。
一个技能包，到底长什么样
先给你看一个真实的。下面这个是我的「公众号文章写作」技能包的核心骨架——不是完整内容，但你一眼就能看懂它在干什么：
┌─ SKILL.md (入口文件，AI 匹配任务时加载)
│ ├─ name: 公众号文章写作
│ ├─ description: 当用户要写公众号文章时触发。含选题研究、全文生成、配图、合规审核。
│ └─ body: 11 个阶段的完整工作流
│
├─ 内置爆款数据库 (6000+ 篇文章的结构分析)
├─ 10 条爆款写作技法 (每条有具体示例)
├─ 合规规则库 (小红书 12 条 + 公众号 4 条)
├─ 纯小白文章检查清单 (19 项，逐一勾选)
└─ 双平台策略速查表 (9 种场景，跨平台差异)
注意看，这不是一段 prompt。这是一个结构化的文件夹，里面有规则、有数据、有流程、有检查清单。AI 被触发后，不是「自由发挥」，而是沿着这条轨道跑。 你可以把它想象成麦当劳后厨的操作台——炸薯条不是厨师凭感觉撒盐，是按机器上标的克数和秒数。不管换哪个员工、哪天上班，炸出来的东西味道一样。技能包 = 你的经验被写成了代码之外的「代码」。
小白成功标志：✅ 你能用自己的话解释：技能包不是一段 prompt，而是一个有结构的文件夹 ✅ 你能区分「写一次 prompt」和「建一个可复用的技能包」
怎么找到值得写成技能包的事？三个标准
不是什么事都值得写成技能包。如果一件事你只做一次，写 prompt 就够了。 但如果你在做这三类事，就需要技能包：
标准一：重复 ≥3 次
同一件事，你做过三次以上——比如每周写周报、每次发小红书前做合规检查、每篇公众号文章结尾加 checklist。这些事，每次做的时候你都在重复同样的「思考+操作」组合。重复三次，就值得打包。打包一次，后面一百次都省。
标准二：容易漏步骤
流程超过 3 步的事情，人脑就会漏。比如你发小红书之前要检查 8 项合规——关境外链接、删 VPN 词汇、加 AI 声明、检查标签全是中文……你不可能每次都记得全。但技能包可以。人脑记不住的事情，是技能包的最佳候选人。
标准三：有隐性知识
有些事情你做了很多次之后，脑子里有一些「说不清但知道该这么做」的东西。比如你知道标题加数字比不加好，知道开头用「事情是这样的」比「随着AI技术的发展」更抓人。这些隐性知识，如果你不写下来，每次 AI 都可能换个路子走。隐性知识不写下来，AI 就永远学不会。你写了它才会用。
三类事的快速定位：
类型 | 例子 | 适合打包吗
─────────────────────────────────────────────────
一次性任务 | 「帮我写个年会发言稿」 | ❌ prompt 够了
重复型工作流 | 每周写周报、每月数据分析 | ✅ 技能包
容易漏步骤的 | 小红书合规检查、代码部署 | ✅ 技能包
有隐性知识的 | 写爆款标题、定价策略判断 | ✅ 技能包
纯创意型 | 想活动 slogan、画画风格 | ⚠️ 部分适用
怎么写你的第一个技能包？（实操）
来，上手。我不讲理论了，直接带你写一个。 假设你每周五要写周报。你发现每次写周报都要提醒 AI 同样的格式、同样的语气、同样的总结方式。写成技能包，以后说一句「写周报」就行。
第一步：建一个文件夹
mkdir -p .claude/skills/weekly-report
cd .claude/skills/weekly-report
第二步：写 SKILL.md
这是技能包的入口。用 YAML 写元数据（告诉 AI 什么时候触发），用 Markdown 写指令（告诉 AI 怎么执行）。 下面是完整模板，你可以直接改：
---
name: weekly-report
description: >
当用户说「写周报」「周报」「本周总结」「weekly report」时触发。
从用户提供的本周工作内容中，按固定格式生成周报。
---
# 周报生成器
## 你的角色
你是一个帮我写周报的助手。目标是：结构清晰、重点突出、3 分钟内能读完。
## 输出格式（必须严格遵守）
### ✅ 本周成果
- **【重点项目名】** 完成了什么 + 量化结果
- 用「完成了」「上线了」「跑通了」开头，不用「参与了」「负责了」
### 🚧 阻塞项
- [P0/P1/P2] 什么问题 | 影响什么 | 需要谁协助
- 没有阻塞项就直接写「本周无阻塞项 ✅」
### 📌 下周重点
- 不超过 3 项
- 每项带一个可验证的完成标志
## 规则
1. 不要写「感觉」「可能」「应该」——只写确定的事
2. 每项不超过两行
3. 总量不超过一屏（手机屏幕能看完）
## 避坑
- 不要把我没说的事编进去——如果我不提供本周内容，你说「请给我本周的工作要点」
- 不要用「我们」——用「我」，这是我的周报
- 不要写超过 3 项下周计划——多了等于没写
直接把上面这块复制粘贴，你的第一个技能包就写好了。改一下 name 和 description，换成你自己的场景，就是你的。
第三步：测试它
保存文件，重启 Claude Code（或者你用的 AI 工具），然后说一句「帮我写这周的周报」。 如果它按你指定的格式输出了——技能包生效了。 如果没触发——检查 description 里有没有写清楚触发词。这是最常见的坑。
⚠ 新手最容易踩的三个坑：坑 1：description 写得太模糊。AI 靠 description 决定是否触发技能。写「周报工具」太模糊——写「当用户说写周报、本周总结、weekly report 时触发」就清晰了。 坑 2：指令写成散文。不要写「你最好保持一个专业但友好的语气」——写「用'我'开头，每项不超过两行」。 坑 3：一次塞太多。一个技能只做一件事。如果你的技能包同时负责写周报、写月报、写年度总结——拆成三个。
小白成功标志：✅ 你在 .claude/skills/ 下建了自己的文件夹 ✅ SKILL.md 里写了 name、description 和至少一段指令 ✅ 你对 AI 说了触发词，它按你的格式输出了
我的三个技能包是怎么从「能用」变成「好用」的
给你看三个真实案例。不是「最佳实践」，是「进化路径」——从粗胚到打磨。
案例一：公众号文章写作
第一版：300 字。只有 4 个阶段——接收选题 → 研究素材 → 生成文章 → 保存文件。能用，但每次写的文章风格不稳定。有时候偏专业向，有时候太口语，有时候忘了配图。 第二版：加了 10 条爆款写作技法（从 6000+ 篇文章里提炼的），加了排版规范（字体、字号、颜色、行距全部精确到像素级），加了纯小白检查清单。风格就稳定了。 第三版：加了这个——合规审核。因为有一次文章里出现了境外 URL，小红书审核没过。从那以后，合规扫描成了技能包里不可跳过的一步。第一版解决「能做」，第二版解决「做得稳定」，第三版解决「不踩雷」。
案例二：周报生成器
第一版：就 5 行指令。输出格式：成果 / 问题 / 计划。用了两周，发现 AI 每次都把「参与了讨论」这种虚的东西写进去。 第二版：加了这条规则——「用'完成了'『上线了』『跑通了』开头，不用』参与了『』负责了『」。加了这条之后，周报变成了可以发给老板看的东西。一条规则，改变了整份周报的质量。
案例三：封面图生成器
第一版：描述了我喜欢的公众号封面图风格——「温暖、干净、留白多」。但 AI 每次生成的效果都不一样。 第二版：我不再描述「风格」，而是给了一个具体的颜色板（#FFF8F0 米白底色、#C0392B 珊瑚橙强调）、字体要求、构图规则。还加了一个 negative prompt：「不要冷色、不要霓虹、不要赛博朋克、不要 AI 机器人图标」。说清楚「不要什么」，比说清楚「要什么」更管用。
三个案例的共同规律：
第一版都很简陋——但能用。先上线，再用。 每次踩坑，就往技能包里加一条规则。坑踩得越具体，规则写得越具体。 最好的规则是否定句——「不要做X」「禁止Y」「避免Z」。
从 Prompt 思维到 Skill 思维
写到这里，我想跟你聊一个更大的转变。 大多数人用 AI，停留在「对话模式」：打开对话框 → 输入一段话 → 看结果 → 不满意 → 再改 → 再来一轮。 这个模式的本质是什么？你在用「一次性语言」驱动一个「长期工具」。就像你每次开车前，都要重新跟发动机解释「什么是方向盘」「什么是油门」「红灯停绿灯行」。它每次都是第一次听，所以你永远在磨合。 技能包做的事情，是把「一次性语言」变成「长期配置」——你写一次，它记一辈子。以后你每次说「出发」，它就知道往哪开、怎么开、路上不能做什么。
不是 AI 不够聪明。是你还没把它教成一个有 SOP 的员工。
上篇我说过一句话：
「一样的模型大脑，不一样的运行系统，效率差出一大截。」 今天再加一句： 「一样的运行系统，不一样的技能包，稳定性差出一大截。」 大脑决定上限。运行系统决定下限。技能包决定——你能不能在洗完澡、喝着茶的时候，还让 AI 跑得跟你在键盘前一样好。
——————————————————————————————
跟你有啥关系
你不需要是程序员。上面那个周报技能包的例子——建文件夹、写 YAML、写 Markdown——跟写 Word 文档的难度差不多。 真正的门槛不是技术。是：
你愿不愿意停下来花 20 分钟，把一个重复了三次的事情打包？ 你愿不愿意每次踩坑之后，回过头来往技能包里加一句话？ 你愿不愿意承认——「我不在的时候，AI 应该按我的标准干活。」 多数人不愿意。多数人宁愿每次多花两分钟重新交代，也不愿意一次性花 20 分钟写成一个文件。所以愿意做这件事的人，正在慢慢甩开不愿意的人。不是技术差距。是思维方式差距。
下一篇预告
写到这里你可能会问：我写好了技能包，怎么知道它真的有用？怎么测试、怎么迭代、怎么管理 20 个技能包不打架？ 下一篇：从 1 个到 20 个——技能包管理的实操法则。
——————————————————————————————
你的第一个技能包计划（现在就可以做的 5 件事）
拿一张纸，或者打开备忘录，回答这 5 个问题：
☐ 1. 你最近有什么事情重复做了 3 次以上？写下来。（比如：写周报、发小红书、写朋友圈文案、做数据分析报表） ☐ 2. 这几次做的时候，你有什么不满意的？是风格不稳？漏步骤？还是每次都要重新交代一遍？ ☐ 3. 在意的事，写成 3 条规则。用否定句——「不要XXX」「禁止XXX」「避免XXX」。 ☐ 4. 花 10 分钟，照着上面周报的例子，写出你第一个 SKILL.md。不要追求完美——能跑就行。 ☐ 5. 用一次。用完之后记一笔：什么地方对了，什么地方不对。不对的地方，加一条规则。
你不需要变厉害才能开始。你需要开始了，才会慢慢变厉害。
今天就用上面那个模板，写出你的第一个技能包。然后回来告诉我——它好不好使。
——————————————————————————————
作者：坤坤-AI研究员日期：2026 年 6 月 15 日本文涉及的工具和界面以 2026 年 6 月版本为准，具体按钮名称以你当前版本为准。
——————————————————————————————
*本文为「AI 代理设计思想」系列课程的第三轮内容。第一轮：AI 代理设计思想_第一轮课程（五层架构）第二轮：Claude Code 这个鬼东西，用了一个月后我决定掀开它的引擎盖第三轮：给 AI 写 SOP 的人，正在偷偷甩开只会写 prompt 的人（本文）