AGENTS.md

1# ECC 针对 Codex CLI 的指南
2 
3本文件为根目录下的 `AGENTS.md` 提供针对 Codex 的补充指导。
4 
5## 模型推荐（Model Recommendations）
6 
7| 任务类型 | 推荐模型 |
8|-----------|------------------|
9| 常规编码、测试、格式化 | o4-mini |
10| 复杂功能、架构设计 | o3 |
11| 调试、重构 | o4-mini |
12| 安全审查 | o3 |
13 
14## 技能发现（Skills Discovery）
15 
16技能（Skills）从 `.agents/skills/` 目录自动加载。每个技能包含：
17- `SKILL.md` — 详细说明与工作流（Workflow）
18- `agents/openai.yaml` — Codex 接口元数据
19 
20可用技能：
21- tdd-workflow — 测试驱动开发（TDD），包含 80% 以上的覆盖率
22- security-review — 全面的安全自查清单
23- coding-standards — 通用编码规范
24- frontend-patterns — React/Next.js 模式
25- frontend-slides — 视口安全（Viewport-safe）的 HTML 演示文稿及 PPTX 转 Web 转换工具
26- article-writing — 基于笔记和语音参考的长文写作
27- content-engine — 平台原生社交内容及内容再利用
28- market-research — 带有来源引用的市场与竞争对手研究
29- investor-materials — 幻灯片、备忘录、模型和单页介绍（One-pagers）
30- investor-outreach — 个性化投资者触达与跟进
31- backend-patterns — API 设计、数据库、缓存
32- e2e-testing — Playwright 端到端（E2E）测试
33- eval-harness — 评测驱动开发（EDD）
34- strategic-compact — 上下文（Context）管理
35- api-design — REST API 设计模式
36- verification-loop — 构建、测试、Lint、类型检查、安全检查
37 
38## MCP 服务器（MCP Servers）
39 
40在 `~/.codex/config.toml` 的 `[mcp_servers]` 部分进行配置。参考 `.codex/config.toml` 中的示例配置，包含 GitHub、Context7、Memory 和 Sequential Thinking 服务器。
41 
42## 与 Claude Code 的主要区别
43 
44| 特性 | Claude Code | Codex CLI |
45|---------|------------|-----------|
46| 钩子（Hooks） | 8+ 种事件类型 | 暂不支持 |
47| 上下文文件 | CLAUDE.md + AGENTS.md | 仅 AGENTS.md |
48| 技能（Skills） | 通过插件加载技能 | `.agents/skills/` 目录 |
49| 命令（Commands） | `/slash` 命令 | 基于指令（Instruction-based） |
50| 智能体（Agents） | Subagent Task 工具 | 单智能体模型 |
51| 安全（Security） | 基于钩子的强制执行 | 指令 + 沙箱 |
52| MCP | 全面支持 | 仅限基于命令 |
53 
54## 无钩子模式下的安全（Security Without Hooks）
55 
56由于 Codex 缺少钩子（Hooks），安全强制执行是基于指令的：
571. 始终在系统边界验证输入
582. 严禁硬编码密钥 — 使用环境变量
593. 在提交前运行 `npm audit` / `pip audit`
604. 在每次推送前检查 `git diff`
615. 在配置中使用 `sandbox_mode = "workspace-write"`
62