第 03 章 | 心智模型——三层架构

更新于 2026/5/9
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

第 3 章：心智模型——三层架构

学习目标

掌握"工具/知识/治理"三层模型，后面所有章节都对应到这张图上。

三层架构图

flowchart TB
    subgraph G["治理层 (Governance)"]
        direction LR
        Agents["多角色 agent
dev / tester / reviewer / e2e"]
        Perm["permission + hook"]
        Cmd["/dev 自定义命令"]
    end

    subgraph K["知识层 (Knowledge)"]
        direction LR
        Specs["specs/
系统当前承诺"]
        Changes["changes/
进行中变更"]
        Tasks["tasks.md
可执行清单"]
    end

    subgraph T["工具层 (Tooling)"]
        direction LR
        CC["Claude Code
主进程 + Bash/Edit/Write"]
        Models["模型路由
opus / sonnet / haiku"]
    end

    G -.->|读/写| K
    G -.->|执行| T
    K -.->|定义边界| T

    style G fill:#fce4ec
    style K fill:#e8f5e9
    style T fill:#e3f2fd

公司比喻

把项目想象成一家小公司：

层 对应公司角色
治理层 CEO（你）+ PM（main Claude）+ 各部门员工（subagent）
知识层 PRD 文件夹 + Jira 看板 + 产品 Wiki
工具层 笔记本电脑 + IDE + 编程语言

CEO 不写代码，但定方向；PM 不写代码，但调度。Dev / QA / Reviewer 各司其职。所有人查的是同一份 PRD（specs/）——不是各自记忆里的版本。

为什么分三层很关键

如果你不分层，会发生这些混乱：

flowchart LR
    Bad["不分层"] --> X1["规约改了，agent 不知道"]
    Bad --> X2["agent 越权改 spec"]
    Bad --> X3["权限规则散在各处"]

    Good["分三层"] --> Y1["规约改了，所有 agent 重读"]
    Good --> Y2["agent 写权限受文件路径限制"]
    Good --> Y3["权限统一在 settings.json"]

    style Bad fill:#ffcdd2
    style Good fill:#c8e6c9

三层之间的"流动"

你想做新功能
   ↓
治理层启动：main Claude 启动 explore
   ↓
知识层产出：proposal + design + specs + tasks
   ↓
治理层调度：dispatch developer 实现 task
   ↓
工具层执行：Claude Code 用 Bash/Edit 写代码
   ↓
知识层更新：tasks.md 勾选 + review/N.md 写入
   ↓
治理层判断：reviewer 通过 → 进下一组

章节的对应关系

Part 对应层
Part III（Ch 16） 概念 + 工具层基础
Part III（Ch 7~13） 知识层（OpenSpec 详解）
Part IV（Ch 14~18） 治理层（多 agent）
Part V（Ch 19~22） 治理层（编排 + 命令）
Part VI（Ch 23~26） 治理层 + 工具层（permission + hook）
Part VII（Ch 27~30） 综合实战

读完 Part VI 你就有完整的"治理层"——再加上前面的"知识层 + 工具层"，整套机器就转起来了。

你现在能做什么

  • 能画出三层关系图
  • 能给一个具体功能（比如"加 OAuth 登录"）说出在哪一层产生什么动作
  • 能识别现实项目里哪些做法属于"层泄漏"

下一章我们开始动手——准备环境。