Agent 构造公式

在 Claude Code 中，Agent 不是“一段不同的人设 Prompt”。一个可运行 Agent 至少是七个部分的组合：

Agent = 身份 + 指令 + 上下文 + 能力 + 模型策略 + 权限 + 可变状态

这七部分不会被拼成一个巨大字符串。它们分布在 API 请求、本地运行时和持久化系统中。

flowchart LR
    I["身份<br/>主 Agent / Agent 类型"] --> A["Agent 实例"]
    P["指令<br/>system / append / Skill"] --> A
    C["上下文<br/>历史 / CLAUDE.md / 附件"] --> A
    T["能力<br/>经裁剪的 tools"] --> A
    M["模型策略<br/>模型 / thinking / fallback"] --> A
    G["权限<br/>模式 / 规则 / Sandbox"] --> A
    S["可变状态<br/>会话 / 取消 / 缓存 / 任务"] --> A
    A --> R["system + messages + tools<br/>与本地执行上下文"]

身份：决定它为什么存在

身份先定义 Agent 的职责，再影响后面的指令和能力。

主 Agent 承担用户会话、最终决策和结果交付。
Explore Agent 主要做只读检索和代码建模。
Plan Agent 主要形成方案，不应拥有普通写入能力。
自定义 Agent 可以定义专用职责、指令、工具、模型、Skills、Hooks 和 MCP 需求。
特殊内部 Agent 可服务于压缩、验证、会话记忆等系统任务；它们可能受功能开关或构建类型限制。

身份不是界面标签，而是能力边界的输入。例如只读 Agent 不只会在 Prompt 中收到“不要写文件”，它的工具池也会直接移除写入能力。

指令：定义决策规则

指令包含不同生命周期的内容：

指令类型	典型内容	生命周期
基础 system	身份、安全原则、任务方法、工具使用和表达风格	Agent 构造时选择
Agent 专用指令	某类 Agent 的职责和边界	该 Agent 生命周期
附加 system	用户显式要求附加的高层指令	当前会话或 Agent
项目指令	CLAUDE.md、Rules	随工作目录和文件范围变化
运行时提醒	Plan Mode、Skill、Memory、Hook、任务状态	在特定回合附加

这些指令并不都进入顶层 system。动态指令往往通过 user 消息中的 <system-reminder> 进入正确时序位置。

上下文：定义它此刻知道什么

上下文与指令不同。指令规定“应该怎样做”，上下文提供“当前世界是什么样”。

上下文可以来自：

用户原话与会话历史；
工具返回的文件、命令、网页和 MCP 结果；
当前工作目录、Git、日期、模型与平台信息；
项目指令、Memory、已调用 Skill 和压缩摘要；
子 Agent、后台任务、Hook 和 IDE 产生的事件。

上下文必须被选择。把本地所有内容都塞给模型不但不可能，还会破坏时序、缓存和注意力分配。

能力：定义它真正能做什么

能力由当前工具池表达，而不只是由 Prompt 声称。但最终工具池并不是一条对所有来源都适用的简单交集，它有两条汇合路径：

基础装配池：内置工具和会话运行时已注册的 MCP 工具，按当前 worker 自己的权限模式重新装配，再经过平台、全局可见性、Agent 规则、前后台规则与延迟加载裁剪。普通 Subagent 不继承父 Agent 已裁剪后的最终数组；只有 Fork 精确复制父级工具快照。
Agent 专属 MCP：Agent 自己声明的 MCP Server 在上述 Agent 裁剪完成后增量接入，再与第一条路径汇合。

两条路径得到的是“模型可提议的能力”。具体调用仍要经过运行时权限：本地进程工具在适用时继续受 Sandbox，远程 MCP 则受外部服务自身边界。这个非对称结构很重要：基础池工具受 Agent 的 tools / disallowedTools 约束；专属 MCP 不再回穿这层可见性裁剪，但仍不能绕过执行时 deny 和权限边界。

因此，同一模型、同一用户、同一项目，在主 Agent、Plan Agent 和后台 Agent 中也可能拥有不同能力。