最高指令软链接法
用软链接在多个 Agent 的工作指令文件（CLAUDE.md、AGENTS.md 等）中共同引用一份 COLLABORATION.md 最高指令文件，实现多 Agent 在同一项目空间内共享接管，无缝切换
简介
最高指令软链接法是由 Vibe Coding 作者小普在（人人都是产品经理 2026-07-29）中提出的一种多 Agent 协作管理模式。当多个 Agent（Claude Code、Codex、Pi Agent 等）同时对一个项目执行时，各 Agent 分别读取不同的项目配置文件——Claude Code 读取 CLAUDE.md、Codex 读取 AGENTS.md、Pi Agent 可读取两种文件——导致技术栈约束、命名规范、禁区在不同 Agent 之间不可见。
软链接法的浅层解法：在项目根目录新建一个 COLLABORATION.md 加载通用约束（技术栈约定、命名规范、不能动的文件、管理方式、安全红线），然后在各 Agent 的主配置文档首句写入 @COLLABORATION.md，实现一个文件、多个 Agent 共享同一份”最高指令”。
类比：与电脑桌面上的快捷方式相同——你只有一份文件，但多个 Agent 的”快捷方式”指向同一个 COLABORATION.md，真正解决”同一个项目不同 Agent 切换时各读各的”过期。
关键信息
- 类型：协作方法论
- 领域：AI 编程 / Agent 编排 / 工作流
- 提出者：小普
- 相关概念：Vibe Coding、COLLABORATION.md、Agent 选型四步法、VS Code 多 Agent 工作台、CLAUDE.md 行为驱动设计
核心流程
- 在项目根目录创建
COLLABORATION.md - 把”所有 Agent 必须遵守的约定”写进 COLLABORATION.md：技术栈、文件命名规范、不可修改的文件路径、管理方式（git 分支策略、commit 前缀、审批流程）、安全红线
- 在
CLAUDE.md首句写入@COLLABORATION.md - 在
AGENTS.md（Codex 读取的文件）首句引用同一份 COLLABORATION.md - 各 Agent 启动时，CLUADE.md 自动优先加载 COLLABORATION.md，然后再读各自的专属配置
适用场景
- 同一项目同时使用 Claude Code + Codex + Pi Agent 等多 Agent
- 需要任务分工（冷启动 → Claude Code、精修 → Codex、个性化 → Pi Agent）但不希望打破规范
- 团队协作（多人共用同一项目，不同人选用不同 Agent 时，使一切单位保持一致约束）
注意事项
- 需要确认各 Agent 是否支持
@引用机制 - COLLABORATION.md 只记”核心铁律”，不要冗余放各别配置
- 修改 COLLABORATION.md 后需要重新启动 Agent（或让它重新读）