深度解读 · 七章全书精华 · 姊妹卷之二

图解 Skill

从任务到技能的完整方法论
作者 宝玉
篇幅 ~184 页 · 7 章
覆盖 Claude Code / 扣子 / OpenClaw
全书一句话:技能(skill)= 把「每次都要交代的要求」变成「只说一次」的文件——从「到处改」变成「改一处、处处生效」。这是把个人和团队经验固化成 AI 可复用能力的完整手册。
读书 · 二〇二六年七月
下 滑 阅 读
导读 · 为什么值得读

用 AI 的人都遇到过同一件事:每次都要把要求重新交代一遍,改了这次、下次又忘。宝玉这本《图解 Skill》解决的就是这个问题——把要求写成「技能」,让 AI 记住你的做法。它不是编程书,不会写代码也能全书跟下来;对已经在用 AI 助手干活的人,这是把零散经验变成资产的系统方法。

全书的总纲是两个互补的轴:动手做任何技能之前,先在这张坐标上定位。

做什么轴 · 三类操作(第三章) 执行规则 做判断 调外援 → 脚本 → 模型 → 工具 / MCP 铁律:绝不全交给模型 怎么设计轴 · 三种类型(第四章) 约束型 定义输出的「质感」 例:写作风格 · 品牌语气 模板型 定义输出的「结构」 例:会议纪要 · 周报 流程型 定义一套「先后动作 + 工具」 例:文章配图 · 数据报告 先定坐标,再动手 —— 全书总纲
图〇两个互补的轴:做什么 × 怎么设计

每章可点入详解页深读;详解页末附「读书会 · 对我们的启发」——销售管理与市场部两个视角的应用笔记。

01
第一章

先用用:跑通第一个技能十分钟建立手感

阅读第一章详解

宝玉的教学顺序很务实:先跑起来,再讲原理。一个技能 = 一个文件夹 + 一个 SKILL.md 文件,三部分构成:name(身份证)、description(名片,决定会不会被调用)、正文(被选中后才读的具体要求)。

📁 my-skill/ SKILL.md (一个文件承载一项能力) name 身份证:唯一 ID description 名片:决定调不调用 ← 全书最关键的一行 正文 被选中后才读的详细要求
图一一个技能的解剖

上手有三条路径(Claude Code、扣子、OpenClaw 类智能体),创建也有两种方法:手写,或者让 AI 帮你写初稿再自己改——后者是宝玉推荐的默认起点。

02
第二章 · 理解触发机制的一章

看门道:技能的核心逻辑名片机制与渐进式披露

阅读第二章详解

为什么有的技能装了却从不被调用?因为智能体启动时只扫每个技能的 name 和 description 来决定用不用——正文写得再好,名片不行就永远躺着。这是全书最重要的机制洞察。

用户说一句话 “帮我整理会议纪要” 扫所有技能的名片 只读 name + description 触发词命中 → 选中 才加载正文 细则按需读取 按要求干活 渐进式披露:主文件薄、细则按需加载——省上下文,不跑偏
图二名片机制:description 决定生死
description 公式功能定义 + 触发场景/触发词。覆盖用户的高频说法、去人称、控制在约 100 字。太模糊不触发,太精确难命中,太长透支预算
反向触发词技能装多了会互相抢活。在 description 里写明「不用于……」,给相邻技能划清边界
03
第三章

想清楚:从任务到技能五步走动手写之前的功课

阅读第三章详解

不是所有事都该做成技能。判据只有两个:高频 + 可复用。过了这一关,把任务拆开看它由哪三类操作构成,然后各归其位——这就是「做什么轴」。

执行规则 → 给脚本确定性、可重复的步骤交给脚本,交给模型反而不稳定、不可复现
做判断 → 给模型看情况、没有固定答案的部分才是模型的主场
调外援 → 给工具 / MCP需要外部数据或系统能力时接工具,别让模型凭记忆编
绝不全交给模型。
—— 第三章 · 分工铁律

这一章还给了安全三件套:外部输入不可信、敏感操作要确认、权限最小化——技能会代替你执行动作,红线要在设计时画好。

04
第四章 · 全书最该记住的一章

动手做:三种技能类型约束型 · 模板型 · 流程型

阅读第四章详解

「怎么设计轴」把所有技能归成三类,每类有完全不同的写法重点。判断标准一句话:你要定义的是输出的质感(约束型)、结构(模板型),还是一套先后动作(流程型)?

类型定义什么典型例子写法重点
约束型输出的「质感」写作风格、品牌语气正反例 + 禁止清单(≤10 条)+ 持续迭代
模板型输出的「结构」会议纪要、周报固定模板 + 不编造 / 标 [待确认]
流程型「先后动作 + 工具」文章配图、数据报告分步骤 + 工具调用 + 先「生成计划」

约束型迭代法:专治「AI 味」

这是全书含金量最高的方法:① 发 3–5 篇你自己写的满意文章,让 AI 提炼风格;② 用技能写一篇;③ 自己动手改(别口头说改);④ 把「AI 原文 + 你的改版」发回去,让 AI 提炼「改了什么、为什么」写进技能。每次修改都是训练数据——几轮之后,AI 写得比你更像你。

05
第五章

组合用:多技能工作流串联 · 并联 · 循环

阅读第五章详解

单个技能是零件,工作流才是产线。组合只有三种基本形态:串联(先后接力)、并联(同时开工,交给子智能体)、循环(不合格打回重做)。

串联 技能 A 技能 B 技能 C 并联(子智能体) 主任务 子智能体 ① 子智能体 ② 子智能体 ③ 循环 产出 检查 不合格 → 打回重做 合格 ✓ 可复用的能力拆成独立技能,别焊死在一条流程里
图三多技能组合的三种形态

技能和子智能体怎么选?技能是「怎么做」的说明书,子智能体是「谁去做」的分身——并行任务、需要独立上下文时用子智能体,其余大多数场景一个技能就够。

06
第六章 · 从会写到写好

工程化:从需求到上线设计四招与测试四步

阅读第六章详解

这一章把做技能变成一条完整流水线:需求(5 分钟定义)→ 设计 → 实现(人机协作)→ 测试 → 上线。其中最值钱的是两组四步。

设计四招记录踩坑点 · 可容错(预留检查/确认/中间点)· 可扩展(外挂配置不改原文件)· 跨对话记忆
测试四步① 建测试用例(含反例)→ ② 写客观检查项 → ③ 有/无技能对比跑测 → ④ 按丢分项改。先定考题再测考生,防第一印象锚定
两条铁律踩坑点写进 SKILL.md;测试用例存独立题库——两者绝不混在一起,用例混进正文会干扰运行

上线分三层:个人自用 → 团队分享(用 EXTEND 机制做个性化,不改原文件)→ 社区发布。团队里每个人的偏好不同,EXTEND 让一份技能长出多个「个人版」。

07
第七章 · 收官实战

上实战:V1 → V3 迭代吃狗粮与两大黄金公式

阅读第七章详解

最后一章用一个真实技能的三版进化收束全书:V1 先跑通 → 吃自己的狗粮发现问题 → V2 加深度 → V3 上生产。改技能比改软件快得多,所以别追一次完美。

V1 跑通 极简 · 单文件 V2 加深度 吃狗粮后补短板 V3 上生产 多文件包 · 团队用 文件从一个长成一包,能力从能用长成好用
图四演进式架构:先跑通,再演进
黄金公式一:给方向 > 给参数模型擅长的领域给方向、让它动态决策;只有它不擅长的硬约束才写死参数
黄金公式二:正面描述 + 禁止清单永远两者一起用——正面牵引方向,禁止兜底红线;只给一边都会失衡
好技能不改变用户的使用习惯——复杂度锁在技能里,用户说的那句话永远不变。
+
附 · 怎么用这本书

四个判断与一张坏味道表把方法论变成手边的判断工具

动手前的四个判断

① 要不要做成技能?高频 ✓ + 可复用 ✓ → 做;一次性任务别做。最稳的起步 = 先手动跑顺,再固化成技能
② 这一步交给谁?确定性可重复 → 脚本;看情况无固定答案 → 模型;要外部数据 → 工具/MCP
③ 这是哪一类技能?定质感 → 约束型;定结构 → 模板型;定先后动作 → 流程型
④ 给方向还是给参数?模型擅长的给方向;只有硬约束才写死。正面描述与禁止清单永远配合用

坏味道对照表(出现即诊断)

症状诊断
AI 味重写太标准、没个性 → 上约束型,攒「坏的样子」反例
输出格式飘忽缺模板型
AI 边做边忘步骤流程型缺「先生成计划」这一步
技能互相抢活缺反向触发词
用户要学新指令坏技能——复杂度应该锁在技能里
V1 就想做完美反模式——先跑通再演进,吃自己的狗粮

读完值得互相讨论的三个问题

一、过去一个月,哪件事你向 AI 交代了三遍以上?那就是你的第一个(或下一个)技能——高频 + 可复用的活判据
二、团队里最有经验的人的判断,现在写在哪里?如果答案是「在他脑子里」,约束型 + 迭代法就是把它变成团队资产的路径
三、我们现有的 AI 用法里,哪些正在「全交给模型」?用三类操作分工法重新拆一遍,稳定性和可复现性立刻不一样

结语:一句话读完全书

技能的本质,是把「你希望 AI 怎么干活」从每次口头交代,变成一份可积累、可测试、可分享的文件。两轴定坐标(做什么 × 怎么设计),名片定生死(description),迭代定质量(V1 → V3,每次修改都是训练数据)。

而所有方法背后是同一个标准——好技能不改变用户的使用习惯,复杂度永远锁在技能里。

依据原书七章全文提炼整理 · 2026 年 7 月
图表为解读者根据书中框架绘制 · 姊妹卷:《智能》深度解读