🛠️ Codex快速入门
照着《Codex 快速入门》(袁从德、吴军、陈文浩 著,异步图书·人民邮电出版社)做的自学笔记 —— 封面副题是「Harness 工程落地」,书腰那三行是它的卖点:4 个场景案例、1 整套开源代码、方法论适用于 11 个 AI 工具。它在本站 AI 编程线里补的是「怎么用」这一半:22 课 Harness 技术架构原理 讲上下文怎么拼、工具怎么调、Agent 循环怎么转,这一本讲同一个循环配上什么说明书和护栏,才敢让它半夜自动提 PR。四部分:认知与第一次闭环(第 1~4 章,它到底是什么、边界在哪、第一次怎么跑通、四个入口怎么选);Harness 四件套(第 5~8 章,第一个可复用工作流、AGENTS.md 是说明书、Rules 与 Hooks 与 Approvals 是护栏、Skill 与 Subagent 与 MCP 是能力装配);四个实战场(第 9~12 章,接手陌生代码库、修 bug 补测试做回归、跨前后端功能开发、PR 与 Review 与 CI/CD 自动化);团队化与边界(第 13~14 章)。逐节一篇,「本章小结」不单独成篇并进章末,合计 66 篇。沙箱里 git、pytest、Python 都能真跑,Codex 独有的界面与云端任务贴教材原样并标注。每篇五段:若干节正文+动手 Demo+30 秒实验+常见误区+自测三问。
内容来自我的 Obsidian 自学笔记 · 全书 14 章 66 篇已全部写完 · 全书完结 🎉
第1章 Codex 是聊天机器人,更是交付工具
AI 编程工具的三次演进:从代码补全到智能体
三次演进各换了什么
为什么 Codex 是软件工程交付工具
交付与补全差在证据链
从「会写代码」到「能交付任务」:心智模型的转变
从写代码改成写验收
规则优先于「更聪明」:工程视角下的 Codex 使用哲学
规则比聪明可靠
第2章 AI 编程的最小原理——知道边界在哪里
大语言模型为什么能处理代码
预测下一个 token
Codex 完成任务时依赖什么
上下文、工具、仓库、反馈
第一条边界:信息永远不完整
信息永远不完整
第二条边界:Codex 会犯三类工程错误
三类工程错误与止损
从边界意识到的协作方法
切成能被验证的小块
第3章 第一次任务:跑通一条闭环
安装与登录:先把入口跑通
装好、登进去、跑一条
任务入口选择:本地执行,还是交给云端做
本地与云端的判断表
一次完整任务的执行流程
读、改、验三段闭环
模型选择
三档模型与成本口径
安全边界:哪些任务不该交给 Codex
三类任务不交出去
可复用的工作流
把这次成功写成步骤
第4章 Codex 的任务地图
IDE、CLI、App、Web 各自做什么
四个入口各贴什么
五个版本分别适合哪类用户
五个版本与额度
手机入口:移动值守与生态桥接层
手机是值守不是主力
哪些任务适合放在本地,哪些任务适合放在云端
本地云端的三个判据
Review、Automation、Worktree 的角色
Review、Automation、Wo…
任务地图的边界:不是所有任务都适合直接委派
什么不该直接委派
第5章 第一个可复用工作流:在 emotional_chat 项目中稳定复用
进入项目前的两个最小确认
两个最小确认
让仓库支撑 Agent:readiness、脚本与局部验证
readiness 与一键验证
走完完整链路:一次最小变更的闭环
最小变更的完整闭环
从个人闭环到团队资产:复用、成本与模型选择
成本拆解与模板化
第6章 AGENTS.md:给 Agent 的项目说明书
项目地图、关键入口与禁区
AGENTS.md 的三段结构
根目录与子目录分层
根目录与子目录谁覆盖谁
团队规则与个人偏好
硬规则与软偏好
角色分工、交接协议与值班边界
角色分工与交接
三类模板:新项目/遗留项目/团队项目
三类项目各一份模板
第7章 Rules、Hooks 与 Approvals:先约束,再放权
为什么实现智能之前要先控制
规则、钩子、审批三道闸
自动格式化、测试、审计、阻断
钩子四类与退出码
审批点怎么设计
审批点按两级分级
高风险仓库的护栏模板
高风险仓库护栏模板
第8章 Skill、Subagent 与 MCP:把能力和上下文装进系统
从脚本到 Harness:什么时候值得能力化
什么时候值得能力化
Subagent 如何拆分复杂任务
拆的是上下文不是工作量
MCP:先问是否值得接,再问怎么接
MCP 报文与接入判断
Skill、Subagent 和 MCP 协同协作,而不是堆叠复杂度
三者分工与复杂度预算
第9章 场景一:接手陌生代码库
Subagent:从串行阅读到全局俯瞰
并行分区读代码
AGENTS.md:给 AI 定规矩
陌生仓库的第一份说明书
先理解,再修改
理解的四道题
产出审查友好的最小变更
最小变更与 diff 三数
遗留项目的 Harness 工程
遗留项目的三个约束
第10章 场景二:修复 bug、补测试、做回归
复现问题:从错误日志到结构化的 bug 报告
bug 报告的五个字段
约束修改范围:防止「顺手」重构
用 diff 数字约束范围
AI 生成测试:从表面达标到真正可靠
断言要打在行为上
验证闭环:复现—修复—回归
复现、修复、回归三段
第11章 场景三:跨前后端功能开发
需求的结构化拆解:从模糊到精确
一句话需求的五个空洞
API 契约的演进:从手动同步到自动生成
契约先行与破坏性变更
数据库迁移:风险最高的一步
迁移与前向兼容
渐进式交付:从写完就发到灰度发布
开关、灰度、回滚
一次通过率:信息对齐是不是核心
一次通过率的四个变量
第12章 场景四:PR、Review 与 CI/CD 自动化
非交互模式:无人值守的前提条件
无人值守的四个前提
CI 自修复:从构建失败到自动提交 PR
CI 自修复的边界
AI 辅助代码审查
AI 审查的能与不能
超越代码审查:安全扫描与 GitHub 的演进
三类扫描的分工
自动化的边界:风险分级与信任建立
四级风险与信任积累
第13章 从个人开发助手到团队级研发流程
什么时候值得推行团队化
四个成熟度信号
共享规则、权限与能力包
规则、权限与能力包
Worktrees、云任务与异步协作
worktree 与三棵树
小团队试点的落地顺序
小团队的四步顺序