Codex / 使用 Codex
Codex 与 Linear
Linear 适合把产品需求转成工程任务，再由 Codex 处理可验证的子任务。
Linear 工单结构
Linear 工单适合给 Codex 作为工程任务来源。高质量工单应包含背景、范围、验收标准、设计链接、风险边界和测试要求。
| 字段 | 示例 |
|---|---|
| 背景 | 用户刷新 token 后偶发 401。 |
| 范围 | auth service、middleware、auth tests。 |
| 验收 | 新增回归测试并通过 build。 |
| 禁止 | 不要改支付和数据库 schema。 |
状态回写
完成后把改动摘要、验证结果、剩余风险和需要产品确认的问题回写工单。
完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
Linear 到工程任务
Linear 适合把产品需求变成 Codex 可执行的工程任务。高质量工单要比普通需求更具体：背景、影响用户、复现路径、相关设计、范围、验收标准、不可触碰范围和测试要求都要写清楚。
Codex 处理 Linear 任务时，应先读取工单和相关代码，输出问题理解和计划，再进行最小实现。完成后回写工单摘要：改了什么、如何验证、还有什么风险、需要产品确认什么。
如果工单太大，应先拆成子任务。不要让 Codex 在一个含糊工单里同时做设计、实现、数据迁移和发布。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“Codex 与 Linear”放回 Codex 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是入口或平台页面，要特别确认本入口能访问哪些上下文：本地文件、云端仓库、浏览器登录态、团队消息、外部工具，以及这些上下文是否足以完成验证。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 AGENTS.md，哪些运行行为应该交给 config.toml、permission profile、skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Codex 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。
Codex 实操注意事项
围绕本地环境、权限升级、远程入口、自动化失败和回滚补齐 Codex 使用中最容易被忽略的执行细节。
Codex 实操注意事项
这一页属于 Codex 的使用入口。落地时要确认任务是在本地、云端还是协作工具中执行，并检查该入口是否能访问真实仓库、依赖、网络、浏览器状态和验证命令。
处理“Codex 与 Linear”相关任务时，建议始终先确认当前 Git 状态和工作目录。Codex 可以很快完成修改，但它不会自动知道哪些未提交改动来自用户、哪些文件不能碰、哪些命令会影响生产环境。
- 本地任务优先使用低风险分支或工作树，完成后用 git diff 审查。
- 涉及安装依赖、联网、数据库、部署、push、删除、reset 时，先要求 Codex 解释影响再批准。
- 远程或协作入口生成的结果，也要回到 PR、CI、构建日志和测试证据中确认。
- 自动化任务要提前定义失败输出和退出条件，避免 Codex 在错误方向上反复尝试。
把 Codex 当成能执行命令的工程队友，而不是只会写文本的助手。越靠近真实系统，越需要明确边界、证据和回滚。