07
第七章 · 收官实战

上实战:V1 → V3 迭代

吃狗粮与两大黄金公式
前面六章讲完了道理,这一章亲自下场:把一个数据分析技能从 V1 做到 V3。核心体感只有一句——改技能比改软件快得多,所以别追求一次完美;先跑通,自己先用(吃狗粮),让真实使用暴露下一版要解决的问题。
本页末附 · 读书会:对我们的启发 ↓
♪ 本章音频导读

框架详解

这一章是全书的收官实战。作者带着第六章的工程方法论,从零开始做一个数据分析技能,走完三个版本。对管理者来说,它最有价值的地方不是技术细节,而是节奏感:什么时候该停,什么时候该加码。

V1 基础版:先跑通再说第一版就是一份极简的 SKILL.md,只有 20 多行,目标唯一:把基本逻辑跑通。这个版本按任何"专业标准"看都很寒酸,但它已经能干活了。作者刻意不在这一步追求完美——因为改技能的成本极低,V1 的使命不是好用,而是给后面的迭代提供一个能跑起来的起点。很多人做不出技能,卡的恰恰是这一步:总想憋个大的,结果什么都没上线。
V2 增强版:有深度的业务分析V1 用起来之后会发现:能跑,但分析太浅,只是基础统计。V2 的动作是升级分析方法——把一套三阶段分析框架直接注入 SKILL.md。注意这里加的不是代码,而是方法论:告诉智能体"专业的分析应该分几步走、每步看什么"。文件还是那一份,但技能的"业务水位"上了一个台阶。这一步对应的正是管理者最熟悉的事:把老手的分析套路写成可复用的框架。
V3 生产版:专业可视化报告V2 的输出仍是对话文本,离"能直接拿去用的交付物"还差一截。V3 挂载了报告模板和设计简报,技能从单文件长成"主文件 + 参考文档"的完整技能包,输出升级为精美的可视化报告。到这一步才引入外部参考——因为此时智能体确实需要一份"照猫画虎"的参考物来稳定输出样式。三版走完,技能从 20 多行长到 100 多行,从能跑到能上生产。
吃自己的狗粮(dogfooding)三版之间的推进剂不是规划,而是使用:自己做的技能自己先用起来。V1 用了才知道分析太浅,V2 用了才知道输出不够正式——每一版都靠实际使用暴露下一版要解决的问题。这比闭门写需求文档可靠得多:真问题只在真使用里出现。对管理者的启示是,别等用户提需求,自己先当第一个用户。
四个心法 · 克制地引入外部参考什么时候该给技能挂参考文档?判断标准只有一个:智能体当前的任务是否必须有一份"照猫画虎"的参考物。过早塞参考,徒增复杂度(V1、V2 都不需要);过晚引入,输出不稳定(V3 要出正式报告就必须有模板)。参考不是越多越专业,而是"非它不可"时才上。
四个心法 · 设计方向优于具体参数两大黄金公式之一:在模型能力覆盖的领域,给方向比给参数效果好。你说清楚要什么效果、什么气质,具体参数交给智能体根据当下情况动态决策。反过来,把每个参数写死,等于用自己的有限经验封住了模型的发挥空间。方向定了,细节放权——这条既是写技能的公式,也是带人的公式。
四个心法 · 正面描述 + 禁止清单组合用两大黄金公式之二:正面描述牵引方向,禁止清单兜底红线,两者必须配合使用。只写正面描述,智能体容易在你没想到的地方踩雷;只列禁止清单,它又无所适从、不知道该往哪走。一拉一挡,才是完整的约束——这也延续了第四章约束型设计的思路。
四个心法 · 好技能不改变用户的使用习惯全章的终极标准:复杂度锁在技能文件里,不转嫁给用户。技能内部再怎么进化,用户侧的动作不该变。凡是要求用户学新指令、背新流程的技能,都是把自己的活儿推给了别人。这条是衡量一个技能"做没做好"的北极星。
好技能不改变用户的使用习惯。
—— 第七章

关键概念

概念含义
三版进化轨迹V1 基础版先跑通 → V2 增强版加分析深度 → V3 生产版出专业报告,逐版演进,不追一次到位。
吃自己的狗粮自己做的技能自己先用,每一版靠实际使用暴露下一版要解决的问题。
演进式架构(实战版)文件结构从单文件长成多文件包,能力从基础统计升到三阶段框架,但用户操作始终是"上传文件 + 说一句话"。
黄金公式一给方向 > 设具体参数:方向定了,参数交给智能体动态决策。
黄金公式二正面描述 + 禁止清单:正面牵引方向,红线兜底,缺一不可。

心智模型

这一章底层的心智转变,是把"做技能"从软件工程的心态里解放出来。软件改一版代价高昂,所以要求设计尽量一次到位;而技能的主体是几份文本文件,改技能比改软件快得多——这条成本结构的差异,直接推翻了"追求 V1 完美"的合理性。既然迭代便宜,最优策略就是:最快速度上 V1,用真实使用换真实反馈,把打磨留给 V2、V3。

另一个模型是"复杂度守恒":技能变强,复杂度一定在增加,问题只是它落在谁头上。好的技能把增量全部吃进自己的文件里,让用户侧的体验保持恒定;坏的技能则把复杂度往外溢——要用户换说法、学指令、记流程。判断一个技能做得好不好,别看它内部多精巧,看用户那句话变没变。

书中案例

WORKED EXAMPLE · 一句话没变,技能翻了三版

整个实战最漂亮的一个事实是:"帮我分析一下这份数据"这句话,从 V1 用到 V3,一个字都没改

V1 时代,技能是一份 20 多行的极简 SKILL.md,用户上传文件、说这句话,得到的是基础统计——能跑,但浅。作者自己用了几次,浅这个问题藏不住了,于是有了 V2:往 SKILL.md 里注入三阶段分析框架,同一句话进去,出来的已经是有深度的业务分析。再用,又发现对话文本拿不出手,V3 于是挂上报告模板和设计简报,技能长成"主文件 + 参考文档"的完整包,同一句话进去,出来的是一份精美的可视化报告。

三版下来,技能文件从 20 多行长到 100 多行,分析从基础统计升到三阶段框架,输出从对话文本升到可视化报告——而用户的操作从头到尾就是两个动作:上传文件,说一句话。这就是"好技能不改变用户的使用习惯"的活证据:所有新增的复杂度,全部锁在了技能文件里,一点没有溢到用户身上。

改技能比改软件快得多,所以别追求一次完美——先跑通,用起来,让下一版有的放矢。
—— 第七章

反模式

反模式 · ANTI-PATTERNS

本章要点

  1. V1 先跑通,V2 加深度,V3 上生产——逐版演进,别在第一版上恋战。
  2. 改技能比改软件快,成本结构决定了"迭代"优于"一次完美"。
  3. 吃自己的狗粮:自己先用起来,才知道下一版该改什么。
  4. 引入外部参考要克制,唯一标准是"是否必须照猫画虎"。
  5. 两大黄金公式:给方向 > 给参数;正面描述 + 禁止清单组合用。
  6. 终极标准:复杂度锁在技能里,用户那句话永远不变。
原文摘读 · 三段
原书 156 页

看到这张表,你可能会想:既然知道最终要做到 V3,为什么不一步到位,直接写一个 100 多行的技能?因为在实际项目中,你很难在动手之前就把所有细节想清楚。V2 的“三阶段分析法”是在 V1 跑完之后才发现需要加入的;V3 的可视化报告(HTML)是在用了 V2 之后才意识到“光在对话里看还不行”的。需求不是规划出来的,是每一版用完之后才浮现的。本章就是在模拟这个真实的过程:当前版让你不满意的地方,就是下一版的改进方向。

原书 169 页

这里有一个关键取舍:设计类任务,更适合给方向,而不是给参数。

你可能会想:“我直接把每个参数写死行不行?”比如“主色用深蓝,间距 16px,卡片圆角 8px”。当然可以,智能体会严格照做。但这样做的结果,本质上是把智能体退化成一个模板填充器。相反,如果你只给设计方向(如“偏麦肯锡研报风格,避免后台系统风格”),智能体会在这些约束下,自主补全大量细节——字体选择、间距节奏、阴影层级、交互反馈等。把微观决策权还给智能体,才是更高级的设计。

原书 179 页

好技能不改变用户的使用习惯。回顾本章,“帮我分析一下这份数据”这句话从 V1 用到 V3,一个字都没改。技能在背后从 20 多行进化到 100 多行,分析从基础统计升级到三阶段框架,输出从对话文本变成精美报告,但用户的操作始终是:上传文件,说一句话。我们应该将复杂度锁在技能文件里,而不是转嫁给用户,让他们学习新的指令或操作流程。

读书会 · 对我们的启发
吴总的角度 · 销售管理
  • 第一版别求完美:先跑通、自己先用(吃狗粮),发现真问题再进 V2——改技能比改流程便宜得多
  • 「给方向 > 给参数」既适合带 AI 也适合带人:说清要什么效果,而不是把每个细节都规定死
Vera 的角度 · 市场部
  • 「好技能不改变用户的使用习惯」是做工具的北极星——用的人永远只说一句话,复杂度全部锁在技能里
  • V1→V3 的节奏也是产品节奏:先单点跑通,吃狗粮攒真实反馈,再谈深度和规模