概述

Agent 规则文件是告诉 LLM 如何维护这个 Wiki 的那份规约。在当前仓库里，这个角色由 AGENTS.md 承担。

关键点

• 它定义目录结构、命名方式、页面格式和维护流程。
• 它让 LLM 的行为更像一个有纪律的 Wiki 维护者，而不是泛化聊天助手。
• 它本身也是 [Agent-Computer Interface](Agent-Computer Interface) 的一部分，因为它规定了 Agent 如何读资料、改页面、写日志和做交接。
• 对长时运行任务来说，这份规则文件还应该明确交接要求和会话结束时应留下的状态。
• 在更成熟的 Agent 优先工程里，规则文件更适合作为目录入口和导航地图，而不是把所有知识都堆成一份长文。
• 在实践上，这类文件还适合承载命名约定、业务规则、已知怪癖、依赖提示和仓库内其他关键文档入口。

证据

• [LLM Wiki Pattern](LLM Wiki Pattern) 把 Schema 视为整个模式中的关键配置层。
• [Building Effective AI Agents](Building Effective AI Agents) 认为 Agent 工具与接口需要被认真设计和记录。
• [Effective Harnesses for Long-Running Agents](Effective Harnesses for Long-Running Agents) 说明了进度文件、启动脚本和交接约定对跨会话连续性的价值。
• [Harness engineering leveraging Codex in an agent-first world](Harness engineering leveraging Codex in an agent-first world) 明确指出，超长 AGENTS.md 会挤压任务上下文，应把更深知识拆进仓库知识结构中。
• [How OpenAI uses Codex](How OpenAI uses Codex) 则补充说明，AGENTS.md 对日常 Codex 工作也很承重，尤其在命名约定、业务逻辑和已知依赖难以从代码直接推断时。

关联

• 统领 [Ingest Workflow](Ingest Workflow)、[Query Workflow](Query Workflow) 和 [Lint Workflow](Lint Workflow)。
• 连接 [Agent-Computer Interface](Agent-Computer Interface)、[Agent Harness](Agent Harness) 与 [Multi-Session Agent Maintenance](Multi-Session Agent Maintenance)。
• 与 [Repository as System of Record](Repository as System of Record) 和 [Agent Legibility](Agent Legibility) 紧密相关。

开放问题

• AGENTS.md 是否应该加入标准化的长时运行交接清单？
• 是否要把页面评估标准也制度化写入其中？
• 当前这个 Wiki 的 AGENTS.md 是否也应该进一步收缩为“地图”，把更多知识下沉到仓库内文档？

变更记录

• 2026-05-20：基于 [LLM Wiki Pattern](LLM Wiki Pattern) 创建。
• 2026-05-20：结合 [Building Effective AI Agents](Building Effective AI Agents) 更新了接口与简洁设计相关含义。
• 2026-05-20：结合 [Effective Harnesses for Long-Running Agents](Effective Harnesses for Long-Running Agents) 更新了长时运行交接相关含义。
• 2026-05-21：结合 [Harness engineering leveraging Codex in an agent-first world](Harness engineering leveraging Codex in an agent-first world) 更新了“地图而非百科全书”含义。
• 2026-05-22：结合 [How OpenAI uses Codex](How OpenAI uses Codex) 补充其在日常仓库上下文中的承重角色。