agentmentoragentmentor

Codex 新用户上手课

这门课给已经装好 Codex 的新用户:你会学会怎么把一个模糊任务交给 Codex,让它先读项目再动手,看懂 plan/status,审阅 diff,跑测试,处理权限、联网和工作树边界,最后让 Codex 调起课程生成 skill 产出一门类似的自学课。课程不假设某个按钮永远不变;凡是 Codex 界面细节容易变化的地方,都写成"检查当前 Codex 界面/配置"。

学完你将能(course objectives):

  • 把一句需求改写成 Codex 能执行、能验收、边界清楚的任务。
  • 要求 Codex 先读项目指令、文件结构和相关代码,再提出计划。
  • 区分 plan、status、diff、测试结果各自说明了什么。
  • 审阅 Codex 的改动,用行级反馈让它小步修正。
  • 判断什么时候需要批准命令、开放网络、切换权限或使用工作树。
  • generate-course-from-topic skill 生成并 guard 一门 Markdown 自学课。

先修: 已安装并能打开 Codex CLI、Codex app 或 Codex IDE extension 之一;会打开一个本地项目目录。

练习环境: 你自己的 Git 项目。最好选一个小仓库或练习分支,里面有可运行的测试命令。

课时表

主题你将学会
01把任务交清楚写出目标、边界、验收和安全约束
02先让 Codex 读项目使用 AGENTS.md、文件定位和读前计划
03看懂 plan 和 status判断 Codex 下一步是否合理,何时打断
04审阅 diff,再让它改从 Review pane 或 Git diff 给精准反馈
05跑测试和验证让 Codex 找测试、跑测试、解释失败并复验
06权限、联网和工作树选择最小权限,限制网络,用 worktree 并行
07让 Codex 生成一门课触发课程 skill、检查产物、跑 guard

来源见 sources.md