指令文件

指令文件是最容易被写坏的地方：很多工具会整份覆盖，用户手写的内容一下就没了。AgentHub 的做法是只在受控区块里写。

受控区块

写入的内容被包在一对标记之间：

<!-- agenthub:begin -->
你希望统一分发的内容
<!-- agenthub:end -->

标记之外的内容逐字节保留。文件不存在时会新建；已存在但没有标记时，会把区块追加到末尾，而不是替换整份文件。

支持的文件

文件	常见于
AGENTS.md	Codex、OpenCode 等
CLAUDE.md	Claude Code
SOUL.md	Hermes

桥接

多个工具读同一个文件时，可以用桥接避免维护两份内容：

@AGENTS.md

CLAUDE.md 里写这一行，实际内容仍然只有 AGENTS.md 一份。

与项目作用域的关系

• 全局指令文件对所有项目生效。
• 项目里的 .agenthub/project.json 记录该项目启用了哪些项，只在项目内建链接、写区块。

区块内容同样走计划与备份。生成计划时能看到每个文件的 diff，取消勾选就不会被写。