跳到主要内容

自动化任务(Automations)

Automations 允许你配置定期在后台运行的重复性任务。结果会添加到收件箱,无结果时自动归档。Automations 可与 Skills 结合,执行更复杂的工作流。

运行条件

  • Codex App 必须保持运行
  • 选定的项目必须存在于磁盘上

工作机制

每次自动化运行会在新的 Worktree 中启动,不干扰你的主要工作分支。

"每次自动化运行在一个新的 Worktree 中启动,不会干扰你的主 checkout。对于没有版本控制的项目,自动化直接在项目目录运行。"


管理界面

自动化任务显示在应用侧边栏的 Automations 面板中。

Triage(分类)区域:作为收件箱,展示有发现结果的自动化运行记录,可按以下方式过滤:

  • 所有运行记录
  • 仅未读记录

权限与沙箱模式

自动化任务使用默认沙箱设置:

模式说明
只读模式需要文件修改、网络访问或应用交互的工具调用会失败
工作区写入模式工作区外的修改、网络访问或应用交互会失败
完全访问模式风险较高,Codex 可能修改文件、运行命令和访问网络
警告

管理员在托管环境中可以通过强制要求禁止 approval_policy = "never"


Worktree 管理

频繁的调度计划可能会积累大量 Worktree。保持整洁的建议:

  • 归档不再需要的运行记录
  • 避免不必要地固定(Pin)运行记录

测试建议

在设置定时计划之前,先手动在普通线程中测试提示词:

  1. 验证提示词清晰度和范围是否合适
  2. 确认模型和工具行为符合预期
  3. 检查生成的 Diff 是否可以正常审查

初始几次自动化运行后仔细检查输出,根据需要调整提示词或执行频率。


与 Skills 结合使用

在自动化提示词中使用 $skill-name 语法调用 Skills:

$scan-security 扫描最近 24 小时的提交,找出潜在的安全问题

Skills 为 Codex 提供特定操作的工具和上下文,使自动化更加可靠和准确。