Codex Remote 工程实践介绍

Codex Remote 工程实践介绍 核心观点 移动端最有价值的能力不是复制桌面,而是让关键决策变得快速、清晰且安全。 Codex Remote 的价值体现在几个方面: 控制执行环境 :在任务开始前选择主机、仓库、分支、workspace 或独立 worktree,避免后续清理混乱的 Git 状态。 明确任务边界 :通过 Plan mode、Goal、附件、技能和插件,让 Codex 在正确上下文中工作。 区分 Queue 与 St…

Codex Remote 工程实践介绍

核心观点

移动端最有价值的能力不是复制桌面,而是让关键决策变得快速、清晰且安全。

Codex Remote 的价值体现在几个方面:

  • 控制执行环境:在任务开始前选择主机、仓库、分支、workspace 或独立 worktree,避免后续清理混乱的 Git 状态。
  • 明确任务边界:通过 Plan mode、Goal、附件、技能和插件,让 Codex 在正确上下文中工作。
  • 区分 Queue 与 Steer:Queue 适合排队后续任务,Steer 适合在当前运行中及时纠偏。
  • 用 side chat 分离思考支线:主线程继续推进工程任务,side chat 用来解释错误、讨论架构或生成发布说明。
  • 在移动端完成轻量代码审查:查看 changed-file summary、打开 diff、添加 inline comments,并让 Codex 在同一线程中修复。
  • 把权限审批纳入工作流:对命令、文件修改、网络访问和连接工具进行细粒度审批,尽量使用最小权限。
  • 管理长期上下文:使用 /status、/compact/fork 等命令保持线程聚焦,避免长期会话变慢或跑偏。

关键功能速览

功能 / 命令 用途
Worktree / Branch 选择 为任务创建隔离环境,避免污染当前 checkout。
Queue 当前任务完成后再发送下一条提示。
Steer 在当前运行过程中注入纠偏指令。
/side 开启支线对话,讨论问题但不打断主线程。
/plan 先让 Codex 给出实现路径,再决定是否改代码。
/goal 设置跨多轮持续追踪的完成目标。
/review 审查本地改动或与指定分支比较。
/status 查看会话、workspace、上下文和速率限制等信息。
/compact 压缩过长线程,保留关键状态。
/fork 从当前历史创建新的主工作线程。

推荐工作流

1. 发布负责人模式

为某个 release 或 PR 开一个专门线程,让 Codex 检查当前分支、CI 状态、review feedback 和发布范围。完成后在手机上审查 diff 或 release note,最后归档线程。

2. 中断式 Bug 修复

遇到线上或测试问题时,先附上截图、日志或相关文件,让 Codex 诊断而不是立即修改。必要时用 side chat 单独分析某个异常,再回到主线程授权最小修复。

3. 移动端代码审查

让 Codex 对目标分支运行 review,查看变更摘要,打开关键文件,留下 inline comments,再让 Codex 只处理这些评论。适合处理阻塞在一两个判断点上的 review。

4. 长期目标推进

通过 /goal 设置明确完成条件,例如测试通过、review feedback 全部解决、性能阈值达标。之后用通知和状态检查跟进进度,而不是反复问“做完了吗”。

5. 多机器操作台

给不同主机、workspace 和仓库清晰命名。根据任务需要把工作派到拥有正确凭据、模拟器、系统环境或 checkout 的机器上执行。