🔥AI 编程必读文章。

苯鸟

🔥AI 编程必读文章。

《OpenAI Codex 最佳实践指南》：提示词4要素，5步验证闭环，16类适用场景，8条避坑指南。

1、上下文与提示词

好提示词四要素：目标、上下文、约束条件、验收标准。用 @ 引用文件，用语音输入加速。

推理级别选择：Low 适合小任务，Medium/High 适合调试，Extra High 适合长链路任务。

2、复杂任务先规划

三种方式：用 Plan 模式（/plan 或 Shift+Tab）、让 Codex 反问你来澄清需求、用 PLANS.md 模板处理多步骤任务。

3、AGENTS.md

相当于写给 AI 的 README，自动加载到上下文。内容包括：仓库结构、构建/测试/lint 命令、工程规范、禁止事项、完成定义。

层级：~/.codex（全局）→ 仓库根目录（共享）→ 子目录（细粒度），就近优先。


用 /init 生成初始版本。

保持精简，只在反复踩坑时才加规则。

写长了就拆文件引用。

4、配置

个人偏好放 ~/.codex/config.toml，仓库级放 .codex/config.toml，命令行参数仅临时覆盖。CLI、IDE、App 共享配置层。新手先用默认权限，熟悉后再放宽。

很多"质量问题"其实是配置问题。

5、测试与审查

让 Codex 完成完整闭环：写测试 → 跑测试 → lint/类型检查 → 确认行为 → 审查 diff。用 /review 做 PR 审查、审查未提交变更或特定提交。
团队可维护 code_review.md 统一标准。
GitHub Cloud 可配置自动审查 PR。

6、MCP

用于获取仓库外的信息，支持 STDIO 和 Streamable HTTP。适用场景：数据在仓库外、数据常变、需跨项目复用。先接一两个高频工具，别一口气全连上。

7、技能（Skill）

将可重复工作流封装为 SKILL.md。每个技能聚焦一件事，定义清晰的输入输出和触发短语。适用：日志排查、发布说明、PR 审查、迁移方案、事故摘要等。个人技能放 $HOME/.agents/skills，团队共享放仓库 .agents/skills。

判断标准：反复用同一提示词或纠正同一流程 → 做成技能。

8、自动化

技能定义"怎么做"，自动化定义"什么时候做"。在 Codex App 的 Automations 中设定项目、提示词、频率、环境。适用：汇总提交、扫描 bug、起草发布说明、检查 CI、每日站会摘要。手动流程不稳定时别急着自动化。

9、会话管理

一个线程对应一个工作单元，同一问题留在同一线程。

关键命令：/resume 恢复会话、/fork 分支、/compact 压缩上下文、/agent 切换子代理。用子代理分担探索、测试等辅助工作。

10、常见误区

长期规则写在提示词里而非 AGENTS.md
没告诉代理怎么跑构建和测试
复杂任务跳过规划
过早开放完全访问权限
多线程操作同文件不用 worktree
手动还不稳就急着自动化
盯着 Codex 而非让它并行工作
所有任务挤一个线程导致上下文膨胀

传送门：developers.openai.com/codex/learn/best-practices

#HOW I AI###