第 15 章 复用路线:视频课、认证课与图书的切法
这一章面向一个特定读者:要把 WorkBuddy 讲给别人听的人——录课的讲师、做企业内训的负责人、写教程的作者。本书的产出本身是一套可拆用的教学资产,这章给出拆法:哪些章撑起一节视频课,哪些模块构成一个认证单元,实操环节怎么设计才不翻车。
如果你不讲课,本章可以跳过,不影响全书的完整性。
15.1 一节课的骨架:90 分钟讲透 Harness
以「WorkBuddy 的 Harness 设计」为主题的完整一讲(约 90 分钟),从本书取材的推荐切法:
开场 10 分钟——用第 1 章的开场:一次真实对话的五环拆解。观众对着自己每天在用的产品,看到「按下回车后发生了什么」,好奇心就位。配上第 1 章的全景图作为第一张幻灯片。
概念 15 分钟——第 2 章的五层模型。给观众一个能装下所有后续内容的框架。Red Hat 那句「Sandbox constrains,Harness enables」适合做这节的收束金句。
机制纵深 35 分钟——这是主体,三个模块按需选:提示词拼装(第 5 章,现场演示打开模板目录,观众第一次看到「UI 背后的文件」时的冲击力最强)、专家解剖(第 7 章,现场选一位专家对话,再打开它的 plugin.json 对照 UI 字段)、记忆三层(第 4 章,现场 cat 自己的 MEMORY.md)。每个模块的讲法都是同一个范式:可见行为 → 打开文件 → 对照映射 → 架构判断。这个范式本身就是本书可传授的方法。
风险与治理 15 分钟——第 12 章的浓缩:注入面、明文凭证、权限三层、七条自查。企业学员这段最关心,放在后面恰好承接他们已经建立的机制理解。
收尾 15 分钟——第 14 章的五步排查法 + 现场答疑。给观众一个「明天就能用」的带走件。
15.2 认证单元:智能体工程师课程的嵌入方案
面向工程师的认证课程(如智能体工程师认证),本书内容可以组成一个 4—8 学时的模块,设计要点:
考核目标对齐三个层次:能解释(机制层:五层模型、拼装机制、三层记忆——笔试/口试)、能操作(实操层:五步排查、技能开发、插件评估——上机考核)、能设计(架构层:为组织设计规则+技能+插件的分发方案——方案答辩)。本书第 14 章的模式三(团队规范三层分发)可以直接做答辩题干。
实操环节的防翻车设计:所有上机任务用可逆环境(临时目录、只读命令、备份先行——第 14 章的所有命令都按这个标准写过,直接复用);考核用的 WorkBuddy 环境提前冻结版本(本书方法:版本号 + 文件指纹,附录 D);准备离线降级方案(网络或服务异常时,用会话样本文件做「考古式」实操——第 10 章的 JSONL 分析不需要活的应用)。
与课程其他模块的衔接:本书模块适合放在「提示词工程」之后、「多 Agent 编排」之前——它恰好是从提示词到系统之间的那层。前接的知识(上下文、指令遵循)在本册第 4、5 章深化;后接的话题(编排、协作)在第 7 章专家团处开了头。
15.3 图书写作的复用边界
如果你在写一本 WorkBuddy 的入门书或使用手册,本书的复用要守两条边界。
其一,机制内容引用要带版本锚点。本书全部机制描述绑定 5.3.13 与文件指纹,你的书引用时保留这个锚(「据某某版本实测」),否则你的读者会在更新日志的速度里迷失。其二,实操内容请重写而非照搬。本书的命令与流程在声明环境验证过,但教学设计(步骤密度、提示语、练习梯度)应该按你的读者重新校准——直接搬命令可以,直接搬章节不行,机制分析的表述也建议重述(事实不受版权保护,表达受)。
反过来,本书从你的教学中能获得的东西也值得说:课堂上是机制被证伪的最佳环境——学员机器上的「不生效」案例,每一个都是五步排查法的实弹演习,也是下一版更新的素材来源。
15.4 教学资产清单
本书可直接转为教学资产的清单,供备课速查:
| 资产 | 位置 | 教学用途 |
|---|---|---|
| 五环全景图 | 第 1 章 | 开场框架 |
| 五层模型对照表 | 第 2 章 | 概念骨架、板书结构 |
| 目录六家族表 | 第 3 章 | 上机导航图 |
| 三层记忆矩阵 | 第 4 章 | 记忆模块主图 |
| 拼装数据流图 | 第 5 章 | 机制主体演示 |
| 专家四件套与 UI 映射 | 第 7 章 | 现场对照演示 |
| 供应链三问 | 第 8 章 | 安全讨论引导 |
| 五步排查法 | 第 14 章 | 收尾带走件、考核大纲 |
一条备课时的重要提醒:演示环境提前一天做全量验证(你的机器、你的版本、你的插件组合),并准备会话样本文件做备份演示——现场网络的不可控,教过课的都懂。
15.5 全书收束
回到开头的问题:为什么一个把按钮做到极简的产品,值得一本讲底层文件的书?因为按钮解决的是「能不能用」,理解解决的是「能不能用好、敢不敢托付」。WorkBuddy 把 Harness 的全部复杂性装进了 ~/.workbuddy 这个安静的目录,这本书做的只是把它打开给你看。
机制会过时——这个产品两天一个版本,书里的文件路径和字段名终将变成考古材料。但方法不会:五层模型是分析任何 Agent 的框架,「UI → 文件 → 请求」是追问任何黑盒产品的路径,证据意识(会话、轨迹、审计)是与技术共处的底气。带着这三样,下一个现象级 Agent 出现时,你打开它的数据目录,就知道该看什么。
大鹏主编|智见 AI 出品