agent-isolation#

多 agent 共享基础设施时的硬边界——不是靠约定，是靠写死规则。

问题#

当两个（或更多）agent 跑在同一台机器上、共享同一个运行时底座，会出现：

• Agent A 读了 Agent B 的 session 文件，上下文污染
• Agent A 改了 Agent B 的配置文件，B 突然挂掉
• 两个 agent 的 cron 互相触发，产生幽灵任务
• 排查问题时不知道"这是谁的锅"

解决方案：三个工作区 + 两条死命令#

三个工作区（目录级隔离）#

text

~/agent-a/          ← Agent A 专属工作区
~/.runtime/         ← 共享运行时（引擎层，只在需要管理时碰）
~/agent-b/          ← Agent B 专属项目文件

共享面只有一个：声明一个公共目录（如 ~/shared/styles/），两个 agent 各自写各自的文件，不冲突。

两条死命令（写入 AGENT.md）#

Agent A 的 AGENT.md：

markdown

## [Workspace Boundary] 工作区边界（硬规则）

- `~/agent-a/` 是你的工作区。
- `~/.runtime/` 和 `~/agent-b/` 是 Agent B 的工作区。
- 不主动操作 Agent B 的工作区——不读、不改、不写。
- 唯一例外：用户明确说"帮 Agent B 查"、"帮 Agent B 改配置"等管理指令。完成任务后立即退出，不逗留。

Agent B 的 AGENT.md：

markdown

## 工作区边界（硬规则）

- `~/agent-a/` 是 Agent A 的工作区。没有理由访问它。
- 发现自己在读/写 Agent A 的文件时，立即停止。
- 共享区：`~/shared/styles/`，各写各的文件。

关键设计决策#

为什么不是"删掉一方"？

多 agent 环境下，直觉可能是删掉一个来解决冲突。但如果两个 agent 各自有不可替代的价值，删掉一方是逃避问题——隔离才是解决。

为什么例外条款是"用户明确说"而不是"自动判断"？

自动判断（"检测到 B 挂了就自动修复"）会导致 agent 主动越界，越界频率失控。只有用户指令才触发越界——这让越界是可审计的。

逐步执行#

Step 1 — 确认三个工作区#

确认 agent A、agent B、共享运行时的实际目录路径。

Step 2 — 找出交叉引用#

用 grep 搜各个 agent 的配置文件，看是否有引用其他 agent 路径。

Step 3 — 写入边界规则#

在各自的 AGENT.md 中插入上面的边界规则块。

Step 4 — 声明共享区#

如果有需要共享的资源（风格模板等），指定一个显式目录。

Step 5 — 验证隔离#

• Agent A 执行任务 → 确认没有访问 Agent B 的文件
• Agent B 执行任务 → 确认没有访问 Agent A 的文件
• 用户明确指令 → 确认越界后正确退出

从混乱到隔离：典型事故#

真实场景中常见的踩踏链：

1. Agent A 和 Agent B 的定时任务互相触发，产生幽灵任务
2. Agent A 删了 Agent B 的 session 文件（误以为是临时文件）
3. Agent B 失忆，用户追问"为什么又这样"
4. 排查数天才发现根因是工作区没有边界

解决不是删掉一方——是硬隔离。

不适用场景#

• 单 agent 环境（不需要隔离）
• agent 之间需要频繁直接协作（隔离会阻碍——考虑消息队列而非共享文件）