更新：2026-10-03。适用 Codex App / CLI；模型、命令、额度以当前入口为准。
让 Codex 发挥好，关键是任务边界清楚、上下文有用、权限合适、结果可验证。本教程保留原稿四条主线，补充纠错、工程模板和验收流程。
1. 原稿纠错：经验与官方规则分开
原稿来自用户提供的视频笔记。本次未取得完整字幕，不将原稿时间戳当作已复核的逐字证据。下面按官方文档修订。
| 原说法 | 修订 |
|---|---|
| 15 万 Token 是硬性舒适区 | 属于经验建议，不是官方质量保证线；按相关性、重复内容与错误情况决定压缩。 |
| 27K 缓存临界点 | 不作为通用缓存阈值。GPT-6 Astra 模型页的 272K 输入 Token 是 API 长上下文计费门槛，与缓存命中和订阅额度不同。模型页 |
| Sora 是编程主模型 | 应为 Sol；使用当前界面列出的完整型号。 |
| 绝对禁止中途换模型 | 改为按任务选择；切换可能影响行为和缓存复用，复杂阶段可交接后另开任务。 |
| 调整思考强度总能保留缓存 | 官方 API 仅对支持的更新方式给出条件，不推成所有 App 操作的保证。缓存文档 |
| 20 美元 Pro / Plus 与固定额度 | 删除套餐混写；价格、可用模型与限额看当前账户。API 计费和订阅用量分别管理。 |
| agent.md 自动加载 | 正式文件名为 AGENTS.md；其他名字需明确配置或引用。 |
| auto-trigger / invocation: false | 支持该格式的 Codex Skill 用 agents/openai.yaml 中的 policy.allow_implicit_invocation: false。 |
2. 开工前确认入口与基线
| 入口 | 适合任务 | 必查内容 |
|---|---|---|
| ChatGPT Chat | 讨论、研究、需求澄清 | 资料能否读取、本机是否有工具连接 |
| ChatGPT Work | 文档、资料、连接器任务 | 来源、访问范围、产物格式 |
| Codex App / CLI | 代码、构建、测试、Git | 仓库路径、现有改动、项目规则、权限 |
“能讨论代码”不代表已读工程；MCP 健康不代表目标软件可操作。先读取实际文件和错误证据，再修改。
目标：修复 <具体问题>。
上下文：仓库 <路径>；日志 <路径>；相关模块 <名称>。
约束：先读项目规则；保留用户改动；不扩大范围。
完成条件：问题可复现且修复后消失；相关检查通过；说明验证边界。
3. 上下文、缓存、额度分别管理
上下文决定模型能看到什么；缓存决定相同前缀是否复用；账户额度决定还能用多少。不要用一个 Token 数解释三件事。
保留当前目标、限制、决策、真实错误、已改文件、检查结果和下一步。收敛重复日志、过期方案、离题讨论；不能删掉影响正确性的硬件约束。
| 情况 | 动作 | 注意 |
|---|---|---|
| 目标没变，对话很长 | /compact | 压缩后核对限制与未完成项 |
| 临时问概念 | 侧聊；入口支持时用 /side | 快捷别名不保证跨入口可用 |
| 基于历史做新方向 | 分叉；支持时用 /fork | 历史继承不代表文件与分支隔离 |
| 阶段结束 | 写交接后新任务 | 不把旧检查当作新检查 |
先看当前命令菜单。官方命令说明
缓存优化：稳定指令与参考资料放在前面，避免无必要改写历史和工具定义。压缩可能重置缓存复用，但能恢复清楚的任务主线。正确性优先。
API 开发者查看 cached_tokens、cache_write_tokens 与请求成本；Codex 用户查看账户用量。API 单价不能直接换算订阅剩余额度。
交接模板
# 任务交接
目标：
仓库 / 分支 / 当前提交：
相关文件：
已完成：
验证：命令、时间、结果；未运行项与原因。
未解决：
下一步：
授权边界：提交、推送、部署、硬件动作是否允许。
风险：现有改动、外部依赖、硬件条件。
已有 Issue / PR 能承载状态时直接引用，避免重复记录。
4. 模型与推理强度按任务选择
| 任务 | 可考虑层级 | 验收 |
|---|---|---|
| 确定性转换、格式整理 | Luna 等较轻模型 | 抽查与源数据一致 |
| 常规修改、错误定位 | Sol 等通用开发模型 | 根因明确、相关检查通过 |
| 复杂架构、多模块推理 | Astra 等高能力模型 | 方案可审查、依赖与风险明确 |
这是分工建议，不是性能保证。以当前账户的完整型号为准；模型选择不替代测试。
复杂分析提高 reasoning effort，明确重复任务降低强度。官方 API 的 configuration_update 可在支持条件下追加推理更新、保持原前缀；直接更改请求级 reasoning.effort 可能改写隐藏指令。官方缓存说明
ChatGPT 可做前期构思，Codex 读取实际工程并执行。跨入口传递文件、约束和验收标准。第三方浏览器 / MCP 集成需核对来源、读写权限与凭据，不默认安装，也不保证省额度。
5. 提示词四要素：目标、上下文、约束、完成条件
小 Bug
目标：修复空列表时页面报错。
上下文：logs/ui-error.txt；入口 src/List.tsx。
约束：保留 API；不重构旁边模块；先复现和确认根因。
完成条件：空列表与非空列表都正常；相关检查通过。
已授权、可逆的小决策直接推进；重大歧义先说明。
新功能
目标：新增 <功能>，解决 <用户问题>。
上下文：已有方案 <路径>；使用场景 <描述>。
约束：兼容 <接口>；不能改变 <行为>。
完成条件：可审查方案、任务列表、实现和验证证据。
先形成方案，再按确认范围小步实现。
代码审查
审查 <分支 / diff / 文件>。
重点：正确性、边界条件、兼容性、证据缺口。
每条问题给出文件位置、触发条件、影响和修复建议。
只报告真实问题；不为了凑数量提出风格重构。
有真实依赖时保留步骤。“精简”不能省略安全和验证。
6. AGENTS.md 与 Skills：少而准确
AGENTS.md 放长期规则、构建入口、安全边界和文档路由；细节引用项目文件，不堆全部历史。官方项目指令
# 项目规则示例
- 修改前读相关代码；保留用户改动。
- 使用既有语言、接口和构建方式。
- 已授权、非破坏性、可逆的小决策直接推进并验证。
- 提交、部署、外部写入按授权范围执行。
- 不提交凭据；真实硬件动作需明确授权。
- 完成报告写清改动、检查和未验证部分。
每个 Skill 聚焦一件事，描述写清触发条件。重复能力选权威入口；插件缓存通过管理入口处理。不要因教程建议就批量删除 Skills。
# 对支持该格式的 Skill：agents/openai.yaml
policy:
allow_implicit_invocation: false
关闭后仍可显式 $skill 调用。写在任意 SKILL.md 正文不会自动成为有效配置。Skills 文档
7. 自主执行与子代理
自主权覆盖已授权的小决策；不能据此忽略删除、生产发布、对外发送或真实硬件动作的授权边界。
子代理适合独立只读分析或互不冲突的任务。主代理整合、检查冲突并验证最终结果。共用目录必须分配文件所有权；需要隔离时使用独立工作树。
将 A、B 独立分析交给子代理。
每个代理只读指定文件，返回证据与结论。
主代理统一修改、验证；避免同时写同一个文件。
模型使用当前可用配置，不猜不存在的型号。
不要拆分有先后依赖的步骤。子代理说“通过”不等于最终验收。
8. 验证范围适当，证据完整
先跑受影响模块检查；跨模块接口、构建配置、高风险行为变更扩大验证。必需 CI 不能因“省资源”跳过。
最终报告包括改动、根因、命令与结果、未验证项。没运行就写“未运行”，不能写“应该通过”。
9. STM32 工程实例
本节是工程建议，不是视频复述。
硬件事实与工程基线
→ OpenSpec：proposal / design / spec / tasks
→ 用户确认
→ Superpowers：小步实现 / Debug / Verification
→ 编译与软件测试
→ 按需 Bring-up：plan / checklist / log / result
→ 上板与链路实测
→ gstack review；必要时 QA
→ 文档同步与归档
明确小 Bug 可走最小修改支路；改变 GPIO、时钟、发送、中断或初始化时仍需必要 Bring-up。
目标：定位 CAN 接收异常并修复已证实缺陷。
上下文：工程 <路径>；MCU <准确型号>；.ioc <路径>；日志 <路径>。
约束：核对 startup、linker、构建目标、字节序和单位。
不要猜引脚、时钟或内存；硬件事实查官方资料。
只做代码与软件验证；未明确授权时不烧录、不主动发送总线消息。
完成条件：调用链与根因明确；构建通过；列出上板待验步骤。
| 层级 | 证明什么 | 不能代替 |
|---|---|---|
| 文档完成 | 需求、方案、验收条件已形成 | 实现 |
| 代码检查 | 符合已知约束 | 编译和执行 |
| 编译通过 | 能生成目标固件 | 板上行为 |
| Bring-up 通过 | 记录条件下模块 / 链路可工作 | 未测工况与量产可靠性 |
电机、继电器、主动总线发送可能产生真实动作，执行前说明风险并取得相应授权。
10. 常见问题
| 表现 | 检查 | 处理 |
|---|---|---|
| 反复问已回答问题 | 关键结论是否丢失 | 短状态摘要，明确自主范围 |
| 长任务偏离目标 | 目标与完成条件 | 压缩或交接，恢复主线 |
| 工具连接但不能操作 | 是否只测连接健康 | 读取目标状态，最小可逆验证 |
| 改完没测试 | 验收要求是否缺失 | 运行相关检查，标注未测项 |
| Skills 竞争 | 描述与触发重叠 | 选权威入口，精简描述 |
| 子代理冲突 | 文件所有权和依赖 | 统一整合，独立工作树 |
11. 发布与交接检查清单
- [ ] 入口、仓库、模型与权限已确认。
- [ ] 已读项目规则和现有改动。
- [ ] Prompt 四要素完整。
- [ ] 经验阈值没有写成官方保证。
- [ ] API 价格、缓存、订阅额度分别说明。
- [ ] AGENTS.md 名称与 Skill 配置正确。
- [ ] 子代理职责明确，改动无冲突。
- [ ] 相关检查已运行，失败已处理或说明。
- [ ] 编译、Bring-up、板级验证分开报告。
- [ ] 发布物、下载链接和交接状态一致。
12. 参考与维护
模型与产品变化时重新核对官方页；经验建议保留条件；模板跟随真实工程验证修订。