最佳实践概述

本文档总结了使用 Codex CLI 的核心技巧和最佳实践。建议按以下顺序根据你的水平选择性阅读。

🟢 核心原则（所有人必读）

1. 具体胜于含糊

# ❌ 模糊
> 优化代码

# ✅ 具体  
> 将 parseConfig 函数的嵌套 if-else 替换为策略模式，减少圈复杂度

2. 上下文为王

> 这个排序函数目前时间复杂度 O(n²)，当用户数据达到 10 万条时会卡顿，
> 请改为 O(n log n) 的实现，保持类型签名不变。

3. 渐进式交互（小步快跑）

> 第一步：定义数据模型和类型
> 第二步：实现 API 客户端
> 第三步：创建 UI 组件
> 第四步：添加集成测试

4. 每次变更后验证

> 运行 npm run typecheck && npm test
> 确认无回归后再继续下一步

---

🟡 通用技巧

1. 善用技能系统

• 了解你已安装的技能和插件
• 在描述需求时让 Codex 自动匹配技能
• 使用 $SkillName 手动触发特定技能

2. 文件引用

在对话中使用 @filename 引用文件，帮助 Codex 定位上下文，减少不必要的输出。

3. 反馈循环

如果结果不理想，提供具体反馈重新生成：

> 这个实现太复杂了，请简化
> 改用 React Hooks 而不是类组件
> 增加错误处理

4. 善用计划模式

复杂任务进入计划模式让 Codex 分解可行方案，避免盲目操作。

---

🔴 主题文章

主题	适用读者	内容概要
提示词技巧	所有人	提示词结构、模板、上下文管理、高级技巧
任务规划	所有人	计划模式使用、多步骤执行策略
代码开发	所有人	TDD 工作流、代码审查、AI 生成代码的自我审查
安全实践	所有人	沙箱模型、信任级别、提示词安全约束
调试技巧	有经验用户	系统化调试、常见错误分类
协作工作流	团队用户	Git 工作流、PR 管理、知识共享
多代理协作	进阶用户	代理类型、并行调度、Monorepo 工作流

适用版本

本文档基于 Codex CLI v0.142.5。