对比
Apothem 对比原生 CodeBuddy 规则
为何要让 CodeBuddy 的项目规则经由 Apothem 处理，而不是为每个项目手写 .codebuddy/rules 文件。
CodeBuddy 从 .codebuddy/rules/*.md 读取项目规则。你可以逐项目、长期地手写这些文件。Apothem 的 codebuddy 适配器会从共享配置档案渲染其中一个文件，并使其在每个工具与每个项目之间保持一致。本页将手工维护该配置与使用 Apothem 管理它进行对比。
工作量对比
| 任务 | 手工配置 | Apothem 托管 |
|---|---|---|
| 编写规则 | 逐项目将相同的纪律复制粘贴到 .codebuddy/rules/ | 从一份共享语料库渲染 |
| 真相来源 | 每个项目各自的文件 | 一个规范的集合 |
| 使规则在各工具间保持一致 | 逐个工具重新推导 | 自动投影 |
| 更新规则 | 逐个项目手动编辑 | apothem update --harness codebuddy --project <path> |
| 移除配置 | 手动删除 | apothem uninstall，附带带时间戳的备份 |
| 共享可复用的技能和命令 | 把每个技能文件夹手工复制到 ~/.codebuddy/skills/ 并保持这些副本最新 | 由适配器写入 ~/.codebuddy/skills/，所有项目共用一份副本，并在 apothem update 时刷新 |
Apothem 管理的内容
codebuddy 适配器会将共享规则渲染到专用文件 <project>/.codebuddy/rules/apothem-rules.md 中。它还会在你的主目录中写入所有项目共享的两个文件夹：技能以及包装为技能的命令写入 ~/.codebuddy/skills/，这些技能引用的规则和模板写入 ~/.config/apothem/rules/ 和 ~/.config/apothem/templates/。你的 CODEBUDDY.md 记忆文件、你的 .codebuddy/settings.json 权限与 MCP 服务器，以及你自己编写的任何其他规则文件，都完全归操作者所有——适配器会识别这些表面，但从不编辑它们。对共享规则的每次变更，都会在下一次 apothem update 时重新渲染该规则文件。
迁移路径
- 如果尚未创建共享配置档案，请运行
apothem profile init。 - 将现有
.codebuddy/rules/文件中的纪律迁移到共享语料库中。 - 运行
apothem install --harness codebuddy --project <path>，在保持你自己的规则不变的同时渲染apothem-rules.md文件。 - 运行
apothem verify --harness codebuddy --project <path>，以确认配置已落地。 - 此后的每次变更都使用
apothem update --harness codebuddy --project <path>。