对比
Apothem 对比原生 Zed 配置
手工维护 Zed 扁平的 .rules 指令文件，对比通过 Apothem 的共享配置档案来渲染它。
Zed 从项目根目录下一个扁平的 .rules 文件读取代理指令（与 AGENTS.md /
CLAUDE.md 家族并列）。Apothem 的 zed 适配器从共享配置档案渲染该文件。本页将手工
维护那套配置与用 Apothem 管理它作对比。
工作量对比
| 任务 | 手工配置 | Apothem 管理 |
|---|---|---|
| 编写指令 | 手工编写 .rules 文件 | 从共享语料库渲染 |
保留先前的 .rules | 记得自己把它复制到一旁 | 适配器在替换前备份现有文件 |
| 让规则与其他工具保持对齐 | 手工，逐工具 | 在 apothem update 时自动完成 |
| 共享可复用的技能和命令 | 把每个技能文件夹手工复制到 ~/.agents/skills/ 并保持这些副本最新 | 由适配器写入 ~/.agents/skills/，所有项目共用一份副本，并在 apothem update 时刷新 |
| 验证配置是否正确 | 手工检查 | apothem verify --harness zed --project <path> |
Apothem 管理什么
zed 适配器把共享规则渲染进项目根目录的扁平 .rules 文件。Zed 没有 PreToolUse
钩子，因此护栏意图存活于规则正文中，而非工具调用拦截点。全局的
~/.config/zed/AGENTS.md 指令文件以及 .zed/settings.json 的 MCP 上下文服务器块
归操作者所有，不会被改动。每次对共享规则的更改都会在下一次 apothem update 时
重新渲染该文件。
迁移路径
- 如果你还没有创建共享配置档案，运行
apothem profile init。 - 把现有
.rules中的指令（以及你想共享的任何项目专属AGENTS.md内容）移入共享语料库。 - 运行
apothem install --harness zed --project <path>，以渲染.rules文件。你先前的.rules会先被备份。 - 运行
apothem verify --harness zed --project <path>来确认配置已落地。 - 之后的每次更改都使用
apothem update --harness zed --project <path>。