codex规则配置

~/.codex/AGENTS.md

Global Agent Rules

规则

• 默认使用中文回答。


• 先分析再改代码。


• 只修改与需求相关的文件。


• 不做大面积重构，除非用户明确要求。


• 修改后输出：改动文件、改动原因、测试步骤、风险。

开发原则

• 以臆猜接口为耻，以查档求证为荣。


• 以模糊开工为耻，以对齐需求为荣。


• 以脑补业务为耻，以请示规则为荣。


• 以新增冗余为耻，以复用存量为荣。


• 以省略校验为耻，以完备测例为荣。


• 以乱改架构为耻，以恪守规范为荣。


• 以不懂装懂为耻，以坦诚存疑为荣。


• 以批量乱改为耻，以分步迭代为荣。

修改代码要求

1. 
   

   修改前必须：

   
   
   
   
   • 阅读相关代码。
   
   
   • 查找已有实现。
   
   
   • 确认接口、类型、数据结构来源。
   
   
   
   


2. 
   

   禁止：

   
   
   
   
   • 凭空创建接口。
   
   
   • 根据猜测补字段。
   
   
   • 未确认影响范围直接批量修改。
   
   
   • 为解决局部问题进行无关重构。
   
   
   
   


3. 
   

   修改策略：

   
   
   
   
   • 优先复用已有组件、工具、方法。
   
   
   • 优先小范围修改。
   
   
   • 每次只解决一个明确问题。
   
   
   • 修改后及时验证。
   
   
   
   


4. 
   

   输出结果必须包含：

   
   
   
   
   • 修改文件列表。
   
   
   • 每个文件修改原因。
   
   
   • 测试方式和结果。
   
   
   • 潜在风险。
   
   
   
   

必须读取规则文件

开启新会话时，必须读取并遵守：

• ~/.codex/rules/file-tools.md

@/Users/dz/.codex/RTK.md

**file-tools文件

**

# 文件操作



---



## 工具优先级



> 总原则：优先 Codegraph，其次专用工具，再次命令行工具。



| 操作 | 首选        | 其次（专用工具）           | 兜底   |

|----|-----------|--------------------|------|

| 读  | Codegraph | Read / Grep / Glob | Bash |

| 写  | -         | Edit / Write       | Bash |



---



## 执行规则



| 规则            | 说明                                     |

|---------------|----------------------------------------|

| 读首选 Codegraph | 代码理解、源码读取、符号查找优先 Codegraph             |

| 优先专用工具        | 读/写优先使用专用工具（Read、Grep、Glob、Edit、Write） |

| Bash 兜底       | 仅在专用工具无法满足需求时，方可使用 Bash 处理文件           |



---



## 工具权限



| 操作类型 | 策略   |

|------|------|

| 读取   | 自动授权 |

| 联网   | 自动授权 |



---



## 工具选型



> Codegraph MCP 与 Context7 MCP 为代码理解与文档查询的唯一指定工具，强制优先，禁止绕过。



| 场景            | 优先工具          |

|---------------|---------------|

| 理解项目          | Codegraph MCP |

| 调用链分析、影响范围评估  | Codegraph MCP |

| 代码追踪、跨文件数据流追踪 | Codegraph MCP |

| 定位符号定义        | Codegraph MCP |

| 读取源码文件        | Codegraph MCP |

| 文档查询          | Context7 MCP  |

| 代码操作          | LSP           |



---