Codex CLI 实用技巧与进阶用法：从新手到高手

# 批量操作模式：用"所有"但限定范围
为 src/controllers/ 目录下所有文件中的所有 async 函数添加 try-catch 错误处理，
错误统一传给 next(err)，不要修改 src/middleware/ 下的文件。

# 先分析后操作模式：减少意外修改
先列出 src/models/ 目录下所有使用了裸 SQL 查询的函数，然后等我确认后再替换成 Sequelize ORM 写法。

# 约束 + 输出模式：明确不能做的事
重构 src/auth/passport.ts 中的 OAuth 回调函数，提高可读性。
约束：不要修改函数签名，不要改变错误处理逻辑，函数名保持不变。

# 渐进式模式：大任务分步
第一步：只分析 src/legacy/ 目录，列出哪些函数超过 50 行且没有类型注解，不要修改任何文件。

# 交互模式：用斜杠命令临时切换（只影响当前会话）
/model gpt-4.1-mini

# 命令行参数（单次生效）
$ codex --model o4-mini "重构认证模块"

# 配置文件（永久默认）
# ~/.codex/config.toml
model = "gpt-4.1"

## 禁止事项（Codex 必须遵守）
- 不要修改 generated/ 目录，这些文件是自动生成的
- 不要直接操作 prisma/schema.prisma，迁移通过 `pnpm db:migrate` 执行
- 不要在路由文件里写业务逻辑，统一放 services/
- 不要修改 .env.example 和 .env，密钥在这里
- Stripe webhook 处理逻辑在 webhooks.ts，修改前告诉我

## 常用命令
```bash
pnpm dev          # 启动开发服务器，热重载，端口 3000
pnpm test         # Vitest 单元测试
pnpm test:watch   # 测试监听模式
pnpm build        # 构建生产包
pnpm db:migrate   # 执行 Prisma 迁移
pnpm lint         # ESLint 检查（提交前必须通过）
```

# ❌ 一次做太多
重构整个 src/ 目录，添加类型注解，优化性能，更新文档

# ✅ 分步来
# 第一轮：只加类型
为 src/services/ 目录下的所有函数添加 TypeScript 类型注解，不做其他修改

# 确认后第二轮
在第一轮的基础上，为 src/services/ 目录下已有类型注解的函数识别性能瓶颈并优化

# ❌ 让 Codex 自己找
找到所有处理用户认证的文件并重构

# ✅ 直接告诉它在哪里
重构以下文件中的认证逻辑：
- src/api/routes/auth.ts（路由层）
- src/services/authService.ts（业务逻辑层）
- src/middleware/jwtMiddleware.ts（JWT 验证中间件）

#!/bin/bash
# 批量为所有未添加类型的文件加注解
for file in src/services/*.ts; do
  echo "处理 $file ..."
  codex exec "为 $file 中所有无类型注解的函数添加 TypeScript 类型，不修改逻辑"
done

#!/bin/bash
# 只在 git diff 有内容时运行
DIFF=$(git diff HEAD~1 --name-only '*.ts')
if [ -z "$DIFF" ]; then
  echo "没有 TypeScript 文件变更，跳过"
  exit 0
fi
codex exec "根据 git diff HEAD~1 的 TypeScript 变更，更新对应的 JSDoc 注释"

#!/bin/bash
set -e  # 任何命令失败立即退出

# codex exec 失败时退出码非 0，set -e 会自动终止脚本
codex exec "修复 src/api/ 目录下所有 ESLint 错误，不修改逻辑"

# 确认 lint 通过
npm run lint
echo "✓ 所有 lint 错误已修复"

# 在交互模式内用斜杠命令调整
/permissions

# 或在 config.toml 中设置默认值
# ~/.codex/config.toml
approval_policy = "auto-edit"  # 文件修改自动批准，命令执行仍需确认

# 这里写的内容对所有项目生效
- 代码注释用中文
- 解释方案时先给结论，再展开细节
- 遇到不确定的地方先问我，不要自己猜

## 我的代码风格
- 优先使用函数式写法
- async/await 优先于 Promise.then
- 变量命名用 camelCase