有一位大神写了一本 Codex橙皮书-操作指南【附链接】

引言我为什么会去读这份指南上周一个朋友发给我一份 PDF说这个你要看看。我打开一看200多页封面写着Codex 操作指南。我的第一反应是又是一个标题党的教程合集翻了两页我意识到自己错了。这不是教你怎么用 Codex 聊天的教程这是一套完整的任务驱动开发方法论。而写这份指南的人不是官方文档团队是一个在一线用 Codex 干活的大神。第一部分这份指南到底讲了什么这不是教程是一套方法论很多人包括我第一次用 Codex都把它当成了 ChatGPT。问它问题让它写代码复制粘贴。这份指南开篇就说你用错了。Codex 不是聊天工具它是会执行命令的 AI 工程师。它能读你的项目文件修改代码运行测试然后把 diff 反馈给你。核心方法四段式 prompt指南里最实用的一个方法是四段式 prompt。每次给 Codex 下指令都要包含四个要素1. 目标你想改变或构建什么2. 上下文哪些文件、文档、示例与当前任务相关3. 约束条件需要遵循哪些标准、架构要求或规范4. 完成标志任务结束的判断依据是什么举个例子。❌ 错误的指令“帮我写一个用户注册功能”✅ 正确的指令“帮我实现用户注册功能。参考src/auth/login.py的风格使用 Prisma ORM要求邮箱验证完成后跑通测试用例。”前者是聊天后者是任务。Codex 需要的是任务不是聊天。AGENTS.md给 Codex 写入职文档指南里另一个让我印象深刻的点是 AGENTS.md。这是写给 Codex 的项目说明书放在项目根目录每次启动自动加载。比如code复制## 技术栈 - 前端: Next.js 14, React 18, TailwindCSS - 后端: Next.js API Routes, Prisma ORM - 数据库: PostgreSQL 15 ## 重要约定 - 所有数据库操作必须通过 lib/db.ts 中的 prisma 实例 - API 路由错误统一用 lib/api-error.ts 处理 - 环境变量在 .env.local 中有了这份入职文档Codex 就知道你的项目规则不用每次重复说明。这就像给新员工发了员工手册而不是每次干活都要重新培训一遍。Skill把重复流程变成工具指南还介绍了 Skill 机制。Skill 本质上是一套写好的执行步骤用 Markdown 写成。比如代码改动验证这个 Skill包含改完代码后自动跑测试检查代码风格生成 diff 报告提交前自查你不用每次都重复这些指令直接调用 Skill 就行。这让我想到了编程里的函数封装——把重复的逻辑抽象成可复用的工具。第二部分我用指南里的方法试了一下看完指南我决定试一试。案例 1快速搭建一个 Web 服务我给 Codex 的指令是“帮我做一个 Go Web 服务使用 Gin提供 /health 接口帮我运行起来。”按指南的方法我补全了四个要素目标搭建 Go Web 服务上下文使用 Gin 框架约束提供 /health 接口完成标志运行起来并返回访问地址Codex 做了什么创建项目目录初始化 go.mod写代码执行go run返回访问地址http://localhost:8080/health整个过程不到 3 分钟。我打开浏览器访问那个地址看到了{status: ok}。案例 2清理项目文件我又试了一个任务清理下载文件夹里超过 500MB 的大文件。指令“检查我电脑的’下载’文件夹找出超过 500MB 的大文件按大小排序帮我列出哪些可以清理。”Codex 扫描了文件夹生成了一个列表还按大小排了序。我确认后它帮我清理了几个不用的安装包。桌面瞬间干净了不少。第三部分这份指南给我的 3 个启发看完这份指南我总结了三点。启发 1别把 AI 当聊天工具Codex 不是 ChatGPT。它能执行命令能操作文件能跑测试。把它当聊天工具是对它能力的浪费。启发 2结构化的指令比重复说明更高效四段式 prompt 和 AGENTS.md本质上都是结构化。与其每次都重复说明规则不如一次性写清楚。这不仅适用于 Codex也适用于所有的 AI 工具。启发 3把重复流程变成工具Skill 机制的核心理念是把重复的流程抽象成可复用的工具。这让我想到了编程里的 DRY 原则Don’t Repeat Yourself。AI 工具也一样重复的指令应该被封装而不是每次重写。结尾这份指南值得你花 30 分钟读一遍这份 Codex 操作指南不是官方文档。它更像是一个一线工程师的实战笔记。没有正确的废话只有可执行的方法。如果你也在用 Codex或者准备用我建议你花 30 分钟读一遍。读完之后你对 AI 编程的理解会完全不同。行动建议搜索Codex 橙皮书找到这份指南也可以直接点击获取链接重点读四段式 prompt和AGENTS.md两个章节找一个小项目按指南的方法试一试读完这篇你可能不会再问怎么用 Codex了。你会问的是“下一个任务是什么”