核心理念
Codex 的价值不是"写一段代码"，而是把理解、修改、验证、评审这条工程链路跑完整，让 AI 变成日常工程实践的一部分。
适合谁
研发团队日常编码、技术负责人做架构决策、需要在复杂项目中保持质量和效率的工程师。
掌握什么
AGENTS.md 项目规范、Skills 沉淀能力、Subagents 并行处理、Slash Commands 高效工作流。
初始化项目
/init
计划模式
/plan
查看改动
/diff
代码评审
/review
01 日常使用路径
- 进入项目根目录，启动
codex。 - 第一次接入运行
/init，生成AGENTS.md。 - 先让 Codex 解释项目结构、运行方式、测试命令和风险，再进入修改。
- 复杂任务先用
/plan收敛方案，确认后再实现。 - 修改后查看
/diff，运行测试，用/review或人工评审收口。
Codex 的核心价值是把理解、修改、验证、评审这条链路跑完整。
02 常用 Slash Commands
| 命令 | 日常用途 | 使用时机 |
|---|---|---|
/init | 生成 AGENTS.md 初稿 | 首次接入项目、子目录需专门规则时 |
/plan | 进入计划模式 | 前端改版、跨文件重构、需求不清时 |
/diff | 查看当前 Git diff | 提交前、阶段性确认改动范围 |
/review | 独立视角做代码评审 | 合并前检查 bug、回归风险、测试缺口 |
/compact | 压缩长上下文 | 长任务推进一半、上下文过长时 |
/clear | 清理当前会话 | 切换完全不同任务时 |
/model | 切换模型和推理强度 | 简单修改提速、复杂任务强推理时 |
/permissions | 调整会话权限 | 在只读、自动执行、严格审批间切换 |
/mcp | 查看可用 MCP 工具 | 接入外部上下文时 |
/agent | 切换 Subagent 线程 | 并行探索、评审、实现多任务线时 |
03 AGENTS.md：让团队规则自动进入上下文
Codex 的项目说明书，适合保存项目结构、运行命令、代码约定、禁区和验收标准。
建议写什么
- 项目目标、主要用户和业务边界
- 关键目录、路由、组件、数据源和构建方式
- 常用开发、测试、Lint、构建命令
- 前端设计原则、代码风格、命名约定
- 哪些文件不能随意改、哪些操作必须先确认
不要写什么
- 太长的业务百科
- 已过期的命令和部署路径
- 没有验收方式的抽象口号
04 Skills：把重复工作变成团队能力
Skill 把稳定工作流沉淀下来，比如"前端视觉 QA""内容指南生成""提交前检查"。由 SKILL.md 描述触发条件、步骤和输出标准。
| Skill 类型 | 适合沉淀的内容 | 客户价值 |
|---|---|---|
| 前端视觉 QA | 桌面端、移动端、截图检查、验收清单 | 让页面交付更稳定，减少返工 |
| 内容指南生成 | 工具介绍、使用路径、常见误区 | 让内容库持续扩展 |
| 提交前检查 | Diff、测试、构建、风险点 | 把工程质量变成固定动作 |
05 Subagents：把复杂任务拆给专门角色
适合并行处理复杂任务。内置通用、执行和探索型角色，也可自定义。
什么时候值得用
- 需要多人视角评审同一批改动。
- 要同时探索代码结构、定位风险、补测试。
- 一个任务可拆成互不冲突的写入范围。
什么时候先别用
- 任务很小，一个主线程就能完成。
- 下一步完全依赖某个探索结论。
- 多个 Agent 同时改同一批文件。
06 MCP、Hooks 和权限
落地建议
- 先把本地项目跑通，再接 MCP。
- 只给必要工具，不要一次性接入所有系统。
- Hooks 适合密钥扫描、命令拦截、停止前检查、会话记录。
- 涉及生产、客户数据、密钥和财务时，默认收紧权限。
07 日常提示词模板
理解项目
请先阅读项目结构，说明主要模块、运行命令、测试方式、潜在风险，不要修改文件。前端改版
先输出产品和 UI 实施计划，覆盖信息层级、桌面端、移动端、状态和验收标准。确认后再改代码。复杂实现
请先拆分任务边界、列出会改哪些文件、如何验证、可能风险，再开始实现。提交前收口
请查看 diff，运行必要检查，从代码评审角度列出 bug、回归风险、测试缺口和剩余事项。