网通社科技快报
AGENTS.md规范落地 Codex与ClaudeCode统一AI编程行为准则
近期,名为AGENTS.md的配置规范正悄然在Codex、Claude Code等AI编程工具中落地,成为统一AI代理行为的关键基础设施。该规范并非新功能,而是一种静默运行的‘行为契约’,旨在将原本散落在多次对话中的长期约定集中固化为结构化文本文件,并在会话初始化阶段自动加载执行。Codex按层级读取全局(用户主目录)、项目级(根目录)及子目录备选规则,冲突时以更具体的项目级规则优先。
规范明确八大核心维度:一是项目定位与技术栈,防止Agent擅自切换语言或框架;二是真实命令验证,要求从package.json或CI脚本提取实际安装、构建等指令,避免因依赖管理偏差引发故障;三是复用优先原则,鼓励检索已有实现而非重复造轮子;四是边界与权限界定,如禁止修改敏感配置文件;五是防御性设计克制,反对为理论风险过度复杂化;六是风格一致性,沿用现有命名与结构惯例;七是卡点透明反馈,遇阻需说明缺失信息与尝试路径;八是验收可追溯,修改后须列明检查项与结果状态。
AGENTS.md与CLAUDE.md形成互补生态:当Claude无法直接读取AGENTS.md时,可通过同目录CLAUDE.md中@AGENTS.md引用桥接加载。规范提供30–60行全局通用模板与50–100行项目定制模板,建议由Agent扫描README、锁文件等自动生成初稿后人工校验,全程不触碰业务代码与密钥。
目前该规范尚未标准化,但已在社区自发扩散,部分团队将其纳入CI校验流程,开源项目亦主动添加作为协作者指南。其价值在于以极低认知成本,将模糊的‘应该怎么做’转化为确定的‘必须这么做’,标志着AI编程正从单次任务响应迈向持续协作治理。
规范明确八大核心维度:一是项目定位与技术栈,防止Agent擅自切换语言或框架;二是真实命令验证,要求从package.json或CI脚本提取实际安装、构建等指令,避免因依赖管理偏差引发故障;三是复用优先原则,鼓励检索已有实现而非重复造轮子;四是边界与权限界定,如禁止修改敏感配置文件;五是防御性设计克制,反对为理论风险过度复杂化;六是风格一致性,沿用现有命名与结构惯例;七是卡点透明反馈,遇阻需说明缺失信息与尝试路径;八是验收可追溯,修改后须列明检查项与结果状态。
AGENTS.md与CLAUDE.md形成互补生态:当Claude无法直接读取AGENTS.md时,可通过同目录CLAUDE.md中@AGENTS.md引用桥接加载。规范提供30–60行全局通用模板与50–100行项目定制模板,建议由Agent扫描README、锁文件等自动生成初稿后人工校验,全程不触碰业务代码与密钥。
目前该规范尚未标准化,但已在社区自发扩散,部分团队将其纳入CI校验流程,开源项目亦主动添加作为协作者指南。其价值在于以极低认知成本,将模糊的‘应该怎么做’转化为确定的‘必须这么做’,标志着AI编程正从单次任务响应迈向持续协作治理。