Codex CLI 实用提示词大全（2026）— 50+ 真实场景示例

好的提示词是 Codex CLI 效率的关键。这里汇集了日常开发中最常用的 50+ 条提示词模板，按任务类型分类，开箱即用。每条都经过实际测试，标注了适合的场景和注意事项。

提示词三要素：范围（操作哪些文件）+ 约束（不破坏什么）+ 格式（输出什么）。例如：'重构 src/auth.ts 中的 JWT 验证逻辑 → 提取到独立函数 → 不改公开接口'

1. 代码重构

场景 — 提取重复逻辑

$ codex "src/utils/validation.ts 中有 3 处重复的 email 格式校验逻辑，提取为 validateEmail() 函数，不改调用方接口"

场景 — 拆分大函数

$ codex "processOrder() 函数超过 200 行，按单一职责原则拆分为子函数，保持原有行为不变"

场景 — 替换旧 API

$ codex "把 src/ 下所有用 axios 的地方改成 fetch API，删除 axios 依赖，TypeScript 类型保持正确"

场景 — 消除魔法字符串

$ codex "把 src/ 下所有硬编码的 HTTP 状态码（200、404、500 等）替换为 HttpStatusCode 枚举，创建 src/constants/http.ts"

场景 — 统一错误处理

$ codex "audit src/api/ 下所有 catch 块，把 console.error 换成统一的 logger.error，确保错误对象被完整传递"

场景 — 转换为 async/await

$ codex "把 src/services/user.js 中的 Promise.then() 链式调用全部改写为 async/await，保持逻辑不变"

场景 — 类型安全重构

$ codex "为 src/api/client.ts 中所有 any 类型添加具体的 TypeScript 类型定义，从函数签名和用法推断"

场景 — 模块化拆分

$ codex "src/store/index.ts 超过 500 行，按功能模块（user、cart、orders）拆分到独立文件，导出保持兼容"

2. 测试生成

场景 — 生成单元测试

$ codex "为 src/utils/date.ts 中的每个函数生成 Jest 单元测试，覆盖正常输入、边界值和异常情况"

场景 — 补充测试覆盖率

$ codex "运行 npx jest --coverage，找到覆盖率低于 80% 的文件，为它们补充缺失的测试用例"

场景 — 生成集成测试

$ codex "为 /api/users 路由生成 supertest 集成测试，覆盖 GET/POST/PUT/DELETE 方法，包含认证和权限检查"

场景 — 生成 E2E 测试

$ codex "用 Playwright 为用户登录流程写 E2E 测试：进入登录页 → 填写邮箱密码 → 点击登录 → 验证跳转到 /dashboard"

场景 — 测试数据生成

$ codex "为用户注册测试创建 factory 函数，使用 faker.js 生成随机但合法的用户数据，支持 trait（admin、premium、banned）"

场景 — 修复失败的测试

$ codex "运行 npm test，找到所有失败的测试用例，分析根因并修复（只改测试或实现代码中错误的一方）"

场景 — 快照测试

$ codex "为 src/components/Button.tsx 生成 React Testing Library 快照测试，覆盖所有 variant（primary、secondary、danger）"

3. Bug 修复与调试

场景 — 分析堆栈追踪

$ codex "分析这个错误：TypeError: Cannot read property 'id' of undefined at UserCard.tsx:42，找到根因并修复"

场景 — 修复类型错误

$ codex "运行 npx tsc --noEmit，修复所有 TypeScript 类型错误，不要用 any 或 as 强转来绕过"

场景 — 修复内存泄漏

$ codex "检查 src/hooks/ 下所有 useEffect，找到未清理的订阅、定时器或事件监听器并修复"

场景 — 修复竞态条件

$ codex "src/api/search.ts 的搜索函数有竞态条件（旧请求覆盖新结果），用 AbortController 修复"

场景 — 修复 SQL 注入

$ codex "审查 src/db/queries.ts 中所有数据库查询，把字符串拼接改为参数化查询，防止 SQL 注入"

场景 — 性能问题定位

$ codex "分析 ProfilePage 组件为何重渲染过多（React DevTools Profiler 日志见 debug.log），用 useMemo/useCallback 优化"

4. 文档生成

场景 — 生成 JSDoc

$ codex "为 src/utils/ 下所有导出函数添加完整的 JSDoc 注释，包括 @param、@returns、@throws 和一个使用示例"

场景 — 生成 README

$ codex "根据项目结构和 package.json 生成完整的 README.md，包括项目介绍、安装步骤、使用示例、API 文档和贡献指南"

场景 — 生成 API 文档

$ codex "分析 src/routes/ 下所有 Express 路由，生成 OpenAPI 3.0 规范（YAML 格式），包含请求/响应 schema 和示例"

场景 — 生成 CHANGELOG

$ codex "分析 git log --oneline 最近 50 条提交，按 Conventional Commits 规范整理为 CHANGELOG.md 的 v2.0.0 条目"

场景 — 生成代码注释

$ codex "为 src/algorithms/dijkstra.ts 中的每个关键步骤添加行内注释，解释算法逻辑（面向不熟悉图算法的读者）"

5. 代码审查与安全

场景 — 安全审查

$ codex "对 src/auth/ 目录进行安全审查，检查：JWT 验证是否完整、密码哈希算法、CORS 配置、敏感信息是否泄露到日志"

场景 — 依赖漏洞修复

$ codex "运行 npm audit，为每个 high/critical 漏洞找到安全版本并更新，同时运行测试确保不破坏现有功能"

场景 — 代码复杂度分析

$ codex "用 eslint-plugin-complexity 分析项目，找到圈复杂度 > 10 的函数，提供重构建议和简化方案"

场景 — 敏感信息扫描

$ codex "扫描整个代码库，找出所有硬编码的 API key、密码、token，替换为环境变量，更新 .env.example"

场景 — 代码风格统一

$ codex "对照 .eslintrc.json 和 .prettierrc，修复 src/ 下所有 lint 和格式问题，确保 CI 检查通过"

6. 数据库与迁移

场景 — 生成数据库迁移

$ codex "为 User 模型添加 lastLoginAt 字段（TIMESTAMP，可为空），生成 Prisma migration 文件，包含回滚脚本"

场景 — 优化查询性能

$ codex "分析 src/db/userQueries.ts，找到 N+1 查询问题，用 JOIN 或 DataLoader 批量加载优化"

场景 — 数据库 Schema 文档

$ codex "读取 prisma/schema.prisma，生成人类可读的数据库设计文档（Markdown 格式），包含 ER 图描述和字段说明"

场景 — 种子数据

$ codex "创建 prisma/seed.ts，生成开发环境种子数据：10 个用户（含 1 个 admin）、20 个产品、50 条订单记录"

场景 — 数据迁移脚本

$ codex "写一个 Node.js 脚本把 MongoDB users 集合数据迁移到 PostgreSQL users 表，处理类型转换和空值，批量插入 100 条/批"

7. CI/CD 与自动化

场景 — 生成 GitHub Actions

$ codex "为这个 Node.js 项目生成 GitHub Actions CI 工作流：Node 18/20 矩阵测试、lint、build、覆盖率报告上传到 Codecov"

场景 — 自动化发布

$ codex "创建 GitHub Actions release 工作流：打 tag 时自动运行测试、build、发布到 npm，生成 GitHub Release 和 CHANGELOG"

场景 — Docker 化

$ codex "为这个 Express 应用写多阶段 Dockerfile（Node 18 Alpine），生成 docker-compose.yml（含 PostgreSQL 和 Redis），添加健康检查"

场景 — 批量代码修改

$ codex exec "把所有 .js 文件中的 var 关键字替换为 const 或 let（根据是否重赋值判断），跳过 node_modules"

场景 — 自动修复代码质量

$ codex exec --approval-mode full-auto "运行 eslint --fix 和 prettier --write，然后运行测试，如果测试失败回滚所有更改"

8. 框架特定场景

场景 — React 组件重构

$ codex "把 src/components/UserList.tsx 从类组件改为函数组件 + Hooks，添加 TypeScript 类型，保持 props 接口不变"

场景 — Next.js API 路由

$ codex "在 pages/api/users/[id].ts 实现完整的 REST API：GET/PUT/DELETE，包含认证中间件、输入验证（zod）和错误处理"

场景 — Python 测试生成

$ codex "为 app/services/order_service.py 生成 pytest 测试，用 unittest.mock 模拟数据库调用，覆盖所有业务逻辑分支"

场景 — Go 接口实现

$ codex "实现 internal/storage/interface.go 中定义的 Storage 接口，使用 PostgreSQL（pgx/v5），包含连接池和错误处理"

场景 — Django REST

$ codex "为 Django 的 User 模型创建 DRF ViewSet，包含自定义权限（只能修改自己的数据）、过滤、搜索和分页"

想了解如何写出更好的提示词？查看实用技巧与进阶用法指南；需要在 CI/CD 中批量运行这些命令？参考 CI/CD 自动化和 codex exec 完整指南。

🔍 语言专项教程： Python 开发指南（pytest、mypy、Django/FastAPI） · JavaScript/TypeScript 指南（React、Next.js、Node.js）