任务卡总览：按你要完成的工作进入 Codex
采集日期：2026-06-18。复测日期：2026-06-18。
这页不是知识目录，而是任务入口。你不用先理解所有概念，先选你今天要完成的工作，再进入对应页面。
先选一个目标
Section titled “先选一个目标”| 你现在要做什么 | 先读哪页 | 复制给 Codex 的第一句话 |
|---|---|---|
| 安装并确认入口 | Codex 安装与访问 | 请先判断我应该使用 Codex App、CLI 还是 IDE，并列出安装前需要确认的账号、系统和项目目录条件。 |
| 让 Codex 读懂项目 | 读项目指令 | 请先只读当前项目，不要修改文件。输出项目做什么、入口文件、运行方式、风险边界和一个最小任务建议。 |
| 不会描述需求 | 不会写任务说明 | 请把我的模糊想法整理成一张任务卡，包含目标、范围、不能做什么、验收标准和下一步。 |
| 改一个小功能 | 改小功能指令 | 请先定位相关文件并写实现计划，只允许改 1-3 个和任务直接相关的文件，完成后给出验证方式。 |
| 修一个报错 | 报错排查指令 | 请根据报错文本先分类原因，只做一个低风险定位动作，不要直接重装或大范围修改。 |
| 写测试或补验证 | 写测试指令 | 请先找出这个功能的用户行为和边界条件，再建议最小测试，不要为了测试而重构业务代码。 |
| 检查 diff 或 PR | 代码审查指令 | 请以代码审查视角检查当前 diff，优先列出真实 bug、回归风险和缺少的验证。 |
| 学 Skill | Codex Skill FAQ | 请只读这个 Skill，不要安装，不要运行命令。输出触发场景、会读写什么、风险和适合的新手练习方式。 |
| 接 MCP 或外部工具 | MCP 与外部工具 | 请先判断这个任务是否真的需要 MCP，并列出它会访问的数据、凭证、写权限和费用风险。 |
| 做浏览器验证 | Computer Use 安全 | 请只做本地页面的只读检查和无副作用点击，不要登录真实账号、提交表单、删除、发布或支付。 |
| 用 Worktree 交付 | Worktree / GitHub / PR | 请先读取 Git 状态，说明是否适合开 worktree，并列出预计修改文件、验证命令和回滚方式。 |
新手最短闭环
Section titled “新手最短闭环”如果你还没有明确任务，按这个顺序走：
- Codex 新手第一小时：完成一次只读、计划、小改动、验证。
- 读项目指令：让 Codex 先理解项目，而不是直接写代码。
- 改小功能指令：只改一个小功能，限制文件范围。
- Agent 跑偏纠偏：一旦范围扩大，立刻叫停。
- 内容复测记录：确认本站这条路径最近是否复测过。
P1 后续补强队列
Section titled “P1 后续补强队列”后续页面会优先补齐四个模块：适用场景、可复制任务说明、合格输出、失败叫停。
| 优先级 | 页面 | 为什么先补 |
|---|---|---|
| P1 | MCP 是什么 | 当前页面偏短，需要把“什么时候不要接 MCP”讲透 |
| P1 | 安装前先准备 | 新手最容易在账号、目录、Shell 和网络上卡住 |
| P1 | Claude Code Windows 安装 | 相关工具对照页偏薄，需要避免过时命令 |
| P1 | 安装命令报错 | 报错页应该变成可复刻排查卡 |
| P1 | 用 AI 做出第一个小网页 | 实战项目需要更像“产品雏形”，不是演示页 |
- 想走完整主线：读 Codex 总览。
- 想按概念查：读 Wiki 总览。
- 想按 Skill 查：读 高频 Skill 应用地图。
- 想看来源边界：读 Wiki 来源登记。
- 来源：本站 Codex 主线页面、Wiki 页面、指令库和实战页装配。
- 分享日期：2026-06-18。
- 复测日期：2026-06-18。