Codex: Codex 进阶使用技巧

# Alice 同时处理三个独立模块

Task 1: 重构 src/auth/ 模块
Task 2: 为 src/api/ 添加 Swagger 文档
Task 3: 优化 src/utils/ 的性能

# 三个任务修改不同目录，可以并行
# 预计节省 60% 时间

# 好的做法
/add src/auth/login.ts          # 只添加相关文件
/add src/types/auth.ts          # 添加类型定义

# 不好的做法
/add src/**/*.ts                # 添加太多文件，浪费上下文

# AGENTS.md
## 项目结构
- src/auth/ - 认证模块
- src/api/ - API 路由
- src/utils/ - 工具函数

## 约定
- 使用 TypeScript strict 模式
- 所有 API 需要错误处理

# Bob 处理大型项目
/status                    # 查看：上下文已用 75%

# 优化
/remove src/legacy/        # 移除无关文件
/compact                   # 压缩历史

# 仍然不够
/new                       # 开始新会话
/add src/payments/         # 只添加当前任务相关文件

# 场景：Codex 运行测试失败
> Codex: 测试失败，3 个用例未通过
> 你: 查看失败用例的详细信息，逐一修复

# 场景：Codex 修改了错误的文件
> Codex: 修改了 config.ts（应该修改 constants.ts）
> 你: 撤销 config.ts 的修改，修改 constants.ts

# 查看修改
git diff

# 撤销特定文件
git checkout -- src/wrong-file.ts

# 撤销所有修改
git checkout -- .

# 回到上一个 commit
git reset --hard HEAD~1

# 第一次尝试
> "将 Express 迁移到 Fastify"
  结果：部分路由未正确转换

# 追加修正
> "检查 /api/users 路由，转换语法不对，参考 Fastify 官方文档"
  结果：路由修复完成

# 继续修正
> "中间件的转换也有问题，错误处理需要用 Fastify 的 setNotFoundHandler"
  结果：中间件修复完成

# 修复 Bug 模板
"修复 <文件> 中的 <Bug描述>。
错误信息：<错误日志>
期望行为：<正确行为>
确保测试通过。"

# 添加功能模板
"在 <模块> 中添加 <功能>。
参考 <已有文件> 的代码风格。
包含输入验证和错误处理。
编写单元测试。"

# 重构模板
"将 <旧实现> 重构为 <新实现>。
保持对外接口不变。
确保所有现有测试通过。
添加新测试覆盖新实现。"

# 一键完成：代码修复 → 测试 → 提交
codex --full-auto "修复所有 lint 错误，运行测试，如果通过则 git commit -m 'fix: lint errors'"