波仔
🐳 第四章 从Skill、Tool到Hook
📄 一句话概括

第四章把三层扩展都摸了一遍：Skill 加经验、Tool 加能力、Hook 改规矩；并用两次实测证明——能力清单可以不动，规矩可以整批换。

📝 本节和前面几节的关系

第 3 章讲完了机制，这一章第一次真正动手。小结之后，第 5 章进 Cordis，看这套动态组合的机制本身。

一、八节复盘

  1. Skill 这一层（4.1.1）——4 件包，技能目录随包走。
  2. 删 Skill 实验（4.1.2）——只多 1 行；面板还在，能力没了。
  3. 注册的生命周期（4.2.1）——四层叠加，补丁整体替换。
  4. Tool 不止是函数（4.2.2）——一个包挂多个入口。
  5. Hook 是机制（4.3）——配置里搜不到，落地成 8 件规则插件。
  6. 六道关（4.4）——挂载、注册、审批、沙箱、超时、留痕。
  7. 权限与分层（4.5.1、4.5.2）——三档枚举、审批与沙箱分家。
  8. 管线不能绕（4.6、4.7）——换写法不换关口；实测工具 0 行改动。

二、这一章的真数据

三、带走一个方法

补丁做加减法，dump 做对比。

想验证一个能力从哪来——补丁停掉它，diff 看变化；想验证规则挂在哪一层——补丁改掉它，diff 看它出现在哪段。

这个方法的成本是几秒，收益是不用猜。第 8 章设计自己的 Harness 时，还会再用到它。

四、下一章预告

第 5 章【Cordis 让插件能够动态组合】：从 5.1 的【生命周期结束时，变化也必须被撤下】开始，讲动态组合的时间与空间两个维度。

第四章证明了【能装、能换、能停】，第五章回答这套能装能换能停的机制，凭什么不会乱。

五、动手 Demo：第四章走完，三层扩展的全貌

逐节复盘，再把三层扩展的规模收口：

tiers = [
    ("Skill", "一份技能文件", "不用写代码"),
    ("Tool", "一个插件包（可多入口）", "要写代码"),
    ("Hook", "一条规则插件", "改行为不改能力"),
]
for a, b, c in tiers:
    print("  %-6s %-22s %s" % (a, b, c))
print()
print("  两次实验的 diff: 删 Skill 1 行 / 换规则 6 行")
print("  工具注册项: 无论怎么改规则，都是 0 行变动")

实跑输出：

--------------------------------------------------------------------
第四章走完，三层扩展的全貌
--------------------------------------------------------------------
  逐节复盘，每节留一个抓手：

  节        想明白的事
  ----------------------------------------------
  4.1.1     Skill 是 4 件包，技能目录随包走
  4.1.2     删 Skill：面板还在，能力没了
  4.2.1     注册有生命周期：四层叠加 + 补丁语义
  4.2.2     Tool 不止是函数：一个包多个入口
  4.3       Hook 改的是规则：8 件规则类插件
  4.4       一次调用六道关，关关有真身
  4.5       三档枚举权限，单调不拼接
  4.6       PTC 换写法，不换关口
  4.7       同一 Tool 不同规则：工具 0 行改动
  ----------------------------------------------

  三层扩展的规模，一张表收口：

  层        加什么                     改动量
  ----------------------------------------------------
  Skill     一份技能文件               不用写代码
  Tool      一个插件包（可多入口）     要写代码
  Hook      一条规则插件               改行为不改能力
  ----------------------------------------------------

  下一章进 Cordis：看这套动态组合的机制本身是怎么写的。

三层从轻到重：能用技能解决就别写工具，能改规则就别改工具。 两次实验的 diff 数字（1 行、6 行）比任何描述都有说服力——改动量就在那儿。 下一章的问题已经在这儿埋好：能装能换能停，靠什么保证不乱？

30 秒实验

  1. 合上笔记，把三层扩展各用一句话说清楚。
  2. 把两次实验的 diff 数字复述一遍（1 行 / 6 行），解释它们为什么这么小。
  3. 预习式提问：插件能动态装上，那它【装一半失败】了怎么办？

常见误区

  1. 错误：三层扩展从轻到重，所以先从最重的 Tool 学起。——纠正：顺序反了——能用技能解决就别写工具，能改规则就别改工具。
  2. 错误：规则改动看起来只是几行配置，影响也小。——纠正：几行规则决定 Agent 能动手到哪一步——小改动、大后果。
  3. 错误：实验做过一次就够了。——纠正：这两个实验是方法，第 8 章设计自己的 Harness 时还要用。
自测三问（点开对答案） 1. 三层扩展分别加什么？ —— Skill 加经验（不写代码）、Tool 加能力（写代码、挂多端）、Hook 改规矩（不动能力）。 2. 两次实验的 diff 各是多少？说明了什么？ —— 删 Skill 只多 1 行、换规则只有 6 行——**改动量极小，但能力与规矩确实换了**。 3. 这一章带走的方法是什么？ —— **补丁做加减法，dump 做对比**——花几秒验证，不用猜。

相关笔记