Skip to content

Commit b197626

Browse files
CodeCasterXcodex
andcommitted
docs(agents): 补充 Codex CLI 加载机制说明
- 记录 Codex CLI 加载与目录切换的实测结论 - 补充子目录规则的使用建议 🤖 Generated with Codex Co-Authored-By: Codex <noreply@openai.com>
1 parent 768c42e commit b197626

1 file changed

Lines changed: 25 additions & 0 deletions

File tree

.ai-agents/README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -267,6 +267,31 @@ AI 会:
267267
- **根目录 `AGENTS.md`**:存放**绝大多数**通用规则。这是最安全、最可靠的地方。
268268
- **子目录 `AGENTS.md`**:仅用于那些用户通常会**在该目录下启动终端**进行开发的独立子项目。对于普通的模块化项目,建议尽量将规则合并到根目录,避免因目录层级问题导致规则未加载。
269269

270+
#### Codex 加载机制(实测验证)
271+
272+
**测试方法**
273+
1. 在项目根创建多级目录 `codex-agents-test/level1/level2/`
274+
2. 在各级目录放置包含特定指令(Tag)的 `AGENTS.md`
275+
3. 在项目根启动 Codex CLI(v0.92.0)
276+
4. 执行 `cd` 后再 `pwd`,并读取子目录文件(如 `test.md`),询问是否加载子目录 `AGENTS.md`
277+
278+
**核心结论**
279+
280+
1. **命令级 Shell(无目录持久化)**
281+
- `cd` 只对**当前命令**生效
282+
- 下一轮命令会回到启动目录
283+
284+
2. **启动时加载**
285+
- 仅加载启动目录的 `AGENTS.md`(或 `~/.codex/AGENTS.md`
286+
- 没有发现自动级联加载多级目录规则
287+
288+
3. **无按需加载**
289+
- 读取子目录文件**不会**触发自动注入该目录下的 `AGENTS.md`
290+
291+
4. **使用技巧**
292+
- 需要子目录规则时,必须**在该目录启动 Codex CLI**
293+
- 或在 Prompt 中明确指示:“请读取 `path/to/AGENTS.md` 并严格遵守其中规则”
294+
270295
### ClaudeCode 配置
271296

272297
ClaudeCode 的配置保持在 `.claude/` 目录(项目根目录),包括:

0 commit comments

Comments
 (0)