要充分发挥Codex作为协作AI助手的潜力，关键在于定义清晰的协作规则——而[AGENTS.md](AGENTS.md)正是基础。这个文件就像"团队战术手册"，告诉Codex它的角色、工作流边界、沟通风格和任务优先级。与模糊的提示词不同，[AGENTS.md](AGENTS.md)将临时性的交互转变为结构化、可重复的工作流程。以下是为Codex编写高效AGENTS.md文件的实用指南，包含可操作的模板和代码示例。
为什么AGENTS.md对Codex很重要
Codex擅长技术任务（编码、调试、脚本编写），但在非结构化协作中表现不佳。没有清晰的指南：
- 它可能越界（例如，在要求调试代码片段时修改生产代码）。
- 它会遗漏上下文（例如，忽略项目特定的编码标准）。
- 它会重复工作（例如，重写已有函数）。
[AGENTS.md](AGENTS.md)通过为Codex提供跨会话持久化的固定参考规则来解决这些问题。把它想象成一份"用户手册"，告诉你希望Codex如何与你协作——确保一致性、减少返工、使输出与你的需求对齐。
高质量AGENTS.md的核心组成部分
一个有效的Codex AGENTS.md包含6个不可或缺的章节。根据你的工作流定制每个部分：
1. 团队身份与角色
定义涉及的人员（你+Codex）及其明确的职责。避免模糊描述——对技术范围要具体明确。例如，明确指定Codex在项目中的角色是"初级开发者"还是"代码审查者"。
2. 技术栈与环境
列出项目使用的编程语言、框架、工具和版本号。这能确保Codex生成的代码与你的项目环境兼容，避免因版本差异导致的兼容性问题。
3. 代码规范与约定
定义缩进风格、命名约定、注释规范和文件组织结构。例如，"使用双空格缩进""变量名采用camelCase""类型定义放在单独的types目录下"。
4. 沟通风格与反馈偏好
指定你希望Codex如何呈现信息和反馈。是提供简洁的答案还是详细的解释？是否需要附带代码示例？是否需要在修改前请求确认？
5. 工作流与边界规则
定义Codex可以做什么、不可以做什么。例如，"禁止修改生产环境的配置文件""修改数据库相关代码前必须通知我""每次修改前先展示改动计划"。
6. 常用命令与快捷操作
集中列出项目中最常用的命令：构建命令、测试命令、部署命令、代码格式化命令等。这样Codex可以在需要时快速执行相应操作。
常见问题
问：这篇文章关于什么？
本文涵盖The First Step to Making Codex Understand You: Write Effective AGENTS.md Files，为初级读者提供逐步指导和实用见解。
问：我需要先前经验吗？
本指南面向初级读者。每个概念都会在深入之前进行解释。
问：讨论了哪些工具？
文章引用了codex-agent和claude。您可以在AIStudyOnline工具目录中找到它们。