跳到主要内容

大纲 — tu-jie-skill-ai-ti-xiao(8 章)

原书 9 个正文章(前言 + 7 章 + 结语),12.6 万字符。切分对原书结构走,第 2 章按新词密度拆成两章 (六大要素 / 按需加载与 description),第 7 章+结语合为一章(实战收束)。 切分自查:任意两节「出去时知道」不同一件事;「按需加载」在 01 只给名片/正文分工的现象级说法, 机制细节全部压在 03,不重复。

01-from-prompt-to-skill.md — 从提示词到技能:跑通第一个技能(原书前言+第 1 章)​

  • 一、三个阶段(进来时以为:用 AI 就是对话;出去时知道:随性对话→提示词工程→做成技能是一条每步解决上一步痛点的进化路径,技能把「每次都说」变成「只说一次」)
  • 二、动手前的环境账(进来:不知道从哪开始;出去:智能体必须连着大模型才能干活,三条路径(扣子/Claude Code/OpenClaw)的取舍与 API Key 是什么)
  • 三、同一件事做两遍(进来:技能听起来玄;出去:不用技能=每次重说全部要求,有技能=要求写进文件,输出稳定——主走查:周报任务)
  • 四、技能的真身:一个文件夹加一份说明书(进来:以为是复杂系统;出去:SKILL.md 三部分(name/description/正文),名片管该不该用、正文管怎么做,存放位置两层)
  • 五、技能不生效怎么办(进来:只能干着急;出去:三步排查(装了吗/重启了吗/description 对上吗),排查全程可以让智能体自己做)
  • 六、边界:书是 2026 年的平台快照(进来:担心照着学会过时;出去:界面与安装命令会过期,「技能=文件夹+SKILL.md」的格式层不会)

02-agent-six-elements.md — 智能体这台机器:六大要素(原书第 2 章 2.1)​

  • 一、聊天机器人和智能体差在哪(进来:以为是一个东西的两种叫法;出去:差在工具和技能——两个极简公式,并和翁荔的权威定义对上)
  • 二、AI 厨房:六要素一次记全(进来:术语散装;出去:提示词/大模型/上下文/工具/技能/MCP 各自的位置和边界)
  • 三、「厨师动手」的真相:框架与模型的分工(进来:以为大模型直接操作一切;出去:大模型只下指令,加载技能/管理上下文/跑脚本的是框架——这是技能跨平台通用的技术基础)
  • 四、两种指令(进来:混为一谈;出去:人给模型的是大白话提示词,模型给框架的是结构化数据)
  • 五、MCP 一句话(进来:以为是又一个要学的协议;出去:通用插座,厂商适配一次智能体支持一次;本书不展开,书架有 mcp-spec 拆解)

03-progressive-disclosure.md — 按需加载:技能为什么长成三层(原书第 2 章 2.2–2.4)​

  • 一、有能力做不等于做得对(进来:以为模型够强就不需要技能;出去:模型缺的是你的流程性知识;模型越强技能越值得投入——「能做好」vs「做得对」)
  • 二、四大进化(进来:以为技能只是存好的提示词;出去:按需加载/文件系统当工作台/协同工作流/单一信源,四条都是提示词结构性做不到的)
  • 三、上下文:有限的台面(进来:以为对话随便长;出去:上下文窗口是硬上限,聊着聊着变笨的两个原因(空间占满+注意力稀释),词元怎么算)
  • 四、三层加载走查(进来:以为装了技能就常驻;出去:渐进式披露三层——名片常驻(约百词元/个)、触发才读正文(消耗一次工具调用、留到对话结束)、关联文件按需(脚本在上下文外跑,只回一行结果)——主走查:「帮我写周报」从触发到执行)
  • 五、三个管理技巧(进来:以为技能装越多越好;出去:常驻 20~50 个上限、正文 ≤5000 词元、适时开新对话;数字怎么算出来的)
  • 六、description:唯一开关(进来:以为正文写好就行;出去:所有 description 启动即注入系统提示词,是模型选技能的唯一依据;触发条件写正文=白写;误触发/漏触发/工具调用惰性;公式+两陷阱+反向触发词)

04-before-you-build.md — 动手前想清楚:拆任务、做不做、分工与安全(原书第 3 章)​

  • 一、锤子到手,别到处找钉子(进来:恨不得全技能化;出去:作者一口气建十几个技能的教训,先拆再决定)
  • 二、三类操作(进来:任务是一团;出去:执行规则/做判断/调外援——任何任务都是三类的配比;100% 准确的规则靠模型硬扛不靠谱)
  • 三、三问四限(进来:什么想做就做;出去:反复做吗/要一致吗/流程稳定吗;四个限制(不确定/通用可靠难两全/触发不准/模型差异)与对策;三种不该做成技能的情形)
  • 四、模型与脚本怎么分工(进来:不知道边界;出去:判断给模型、规则给脚本;提示词/脚本/技能三种驱动各管一段;技能填中间地带)
  • 五、工具给能力,技能给经验(进来:以为技能是教智能体用工具;出去:智能体会用 ffmpeg 但不知道你家的规范;先内置后扩展、现成库优先、工具名要写全)
  • 六、安全:三道闸四个习惯(进来:以为装个技能无风险;出去:技能=真实操作特权;最小权限/二次确认/可追溯;安装前安检五项、假数据试跑、专属文件夹、看清弹窗)

05-three-kinds-of-skills.md — 三种技能三种写法(原书第 4 章)​

  • 一、光标在第一行闪(进来:道理全懂动笔就傻眼;出去:任务类型决定写法;先跑起来再调)
  • 二、约束型:写作风格技能(进来:以为「去 AI 味」靠提示词;出去:AI 味=最大公约数,缺正面锚点;四步循环把你的修改变成规则(主走查:老兵→从业者的前后对照);四段式框架(角色定位/风格要点/禁止清单/参考资料))
  • 三、模板型:会议纪要技能(进来:以为和风格技能一路货;出去:约束型管质感、模板型管结构;模板怎么写;主走查:11 行转录稿→格式统一的纪要,模糊日期保持原文)
  • 四、流程型:文章配图技能(进来:以为还是写规则;出去:分步执行+调用外部工具;拆解步骤和 SKILL.md 步骤可以不同(「狗熊掰棒子」要靠生成配图计划防);五步流程)
  • 五、三种思路对齐(进来:三个技能孤立看;出去:管调性/管结构/管工序,大多数技能是混合型可叠加)
  • 六、技能迭代:指挥,别动手(进来:以为改技能要自己改文件;出去:发现问题→告诉智能体→它改→你验证;一次只改一处、解释原因优于堆规则;三步验证(触发/功能/对比);为什么改技能比改软件快)

06-skill-workflows.md — 多技能协作:串联、并联、循环与子智能体(原书第 5 章)​

  • 一、人肉调度器(进来:技能各干各的也挺好用;出去:复杂任务三痛点(能力锁死/缺把关/黑箱),但别把所有环节塞进一个技能)
  • 二、拆分:好东西别锁死(进来:以为拆分是洁癖;出去:可复用能力独立出来(万能高汤);判断两问;文件保存两规矩(同目录、先备份))
  • 三、三种组合方式(进来:组合=排队接力;出去:串联(输出文件=下家输入)/并联(同时多方向)/循环(润色报告打回重写);循环触发者是人;工业级全自动循环的取舍——主走查:导演口令与中间产物、暂停点)
  • 四、子智能体(进来:以为智能体只有一个;出去:独立上下文/过程隔离/同时开工三特性;派活三问(怎么触发/怎么传信息/怎么描述任务四要素);一个上下文搞得定的别派;和技能怎么选:要不要看过程)
  • 五、五个技能一条流水线(进来:工作流是概念;出去:素材分析→大纲(人工检查点)→写作(并联)→润色(循环点)→配图,加写作风格技能全局加载;写死名字还是描述能力的判据)
  • 六、四周演进与三个坑(进来:以为要一次搭完;出去:先两技能最小可用版,瓶颈了再加;三坑(一次搭完/子智能体返回全文/润色改风格);效率账:三四小时→四十分钟,省的是体力活)

07-skill-engineering.md — 技能工程:从需求到上线(原书第 6 章)​

  • 一、在我机器上能跑 ≠ 谁用都靠谱(进来:技能能用就行;出去:三个朋友翻车的故事;给自己用和给别人用是两回事;软件工程五阶段照样适用)
  • 二、需求:5 分钟需求卡(进来:不知道从哪写起;出去:6 问(问题/场景/输入/输出/规则/禁止清单)=SKILL.md 骨架;需求不需要完美)
  • 三、设计四招(进来:第一版总是后来越用越糟;出去:踩坑点(事后补的盲区,信息密度最高)/可容错(开头检查+人工确认+中间存盘)/可扩展(维度组合替代穷举、EXTEND.md、YAGNI 警告)/跨对话记忆(history.json))
  • 四、实现:你决策它执行(进来:以为要自己写文件;出去:人机协作分工;四阶段演进(MVP→补齐→重构→打磨),小红书技能 20 行→641 行+26 个文档)
  • 五、测试:评测循环(进来:靠「感觉还行」;出去:先定考题再测考生;测试用例三要求(像真人/覆盖多情况/反例最值钱);检查项要可判对错;对比打分看下限提升;三动作(记分表/主观验收/耗时账);治根不治标(LLM→法学硕士的通用解))
  • 六、上线:三场景三档要求(进来:发布=传个网盘;出去:自用(安全清单)→团队(分发+「发布前有人用过」)→社区(一分钟决定三件事、清密钥、版本号、向后兼容))

08-data-analysis-iteration.md — 实战:V1→V2→V3 与全书收束(原书第 7 章+结语)​

  • 一、从「就这?」开始(进来:以为智能体分析数据很厉害;出去:裸跑只会做算术;三个版本各解决一个问题(稳定/深度/交付);需求是用出来的不是规划出来的)
  • 二、V1:先跑通(进来:想一步到位;出去:20 多行、四个取舍;没让模型变聪明,只是让输出稳定可复用;「要什么」你定、「怎么做」它定)
  • 三、V2:教它怎么思考(进来:以为分析深浅全看模型;出去:三阶段分析法+分析哲学(so what/标题即结论/异常值是金矿/警惕虚假精确)写进技能;给指引而非脚本;主走查:同一份 35 行数据的 V1 对 V2 输出,2.27 vs 2.17 之谜(简单平均 vs 加权))
  • 四、V3:交付一份报告(进来:以为输出文本就是终点;出去:参考文档两层(样板+简报);给方向不给参数;正面描述+禁止清单必须配合;模型自主补全了没要求的细节)
  • 五、复盘:scripts/ 为什么是空的(进来:以为复杂技能就要堆脚本;出去:判断型任务现场生成代码,「同样输入是否应产同样输出」才是脚本判据;领域知识文件的引入时机)
  • 六、从菜谱到厨艺(进来:学完就会了;出去:四个心法(好食材/先开火/你掌勺/好菜变菜谱);「写书技能」失败的坦白;技能不会过时,因为它装的是业务经验)