用途:分析当前代码库,创建或改进 AGENTS.md 文件,供后续 ODIN Code Agent 实例使用。核心原则是只记录重新发现成本高的知识;若信息只需一次搜索即可获得,就应省略。AGENTS.md 用于为未来智能体提供约定、约束与理由,而非仓库摘要。
主要能力:捕获跨越多个文件的横切约定与边界;记录快速探索代码时容易忽略的隐式契约与运行约束;仅在隐藏约束重要时(如必需顺序、特定标志、环境变量、注意事项)提供非显而易见的命令指引。每项内容都需说明规则或约束是什么,以及为何存在(理由)。
使用方式:对代码库进行分析;若 AGENTS.md 已存在,则建议针对性改进而非重写,且不重复表述,每个事实只出现一次。所有陈述必须基于实际读过的文件,绝不虚构;不确定时改为省略,而非推测。
应省略的内容:文件树、逐目录描述或组件清单;依赖/版本表;通用开发最佳实践;可通过搜索或读取轻松发现的信息;虚构的填充章节,如“Common Development Tasks”“Tips”“Support”;以及只重复代码组织、不含约定或理由的摘要式叙述。
适用场景:接入新仓库、为后续智能体留下高价值上下文、整理难以重新发现的约定与约束。限制:不用于生成仓库概览或常规文档;不得编造未验证信息;官方文档中未提供具体安装命令、收费、价格或平台信息。