AI Agent / 系统课时

创建 Codex Automations

创建 Codex Automations

Codex Automations 适合把“定期回来检查并处理”的维护工作交给后台任务。当前官方文档将这类能力统一呈现为 Scheduled tasks:可以按时间运行,也可以在符合条件的应用事件到达时触发,并把每次运行结果集中到 Scheduled 里审查。:contentReference[oaicite:3]{index=3}

学习目标

  • 把自动化拆成触发条件、持久任务指令、运行环境和审查出口
  • 为本地项目、隔离 worktree 与 Web 任务选择合适的执行位置
  • 配置一个可验证、可暂停且默认需要人工审查的重复维护任务

把一次性操作改成可重复任务

一个可靠的 Automation 不只是“每隔一段时间重复一句提示词”。它至少包含四个稳定部分:什么时候触发、每次具体做什么、在哪个环境执行、结果由谁审查。独立 Scheduled task 每次从保存的提示开始新运行;放在现有 chat 中的 scheduled task 会继续使用该对话已有上下文。

Codex Scheduled task 从触发到审查的自动化链路

这四部分应当独立设计。触发条件不要承担业务规则,业务规则写进持久 prompt;运行环境只提供任务真正需要的文件、工具和网络权限;审查出口则决定自动化是只报告发现,还是留下可供人工确认的修改。

选择触发条件

时间计划适合日报、依赖检查、失败测试汇总等固定节奏工作。高级计划可以使用 RFC 5545 的 RRULE。例如下面的配置片段表示每周一到周五 9:00 运行一次;具体时区由任务设置决定。

text
RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=9;BYMINUTE=0

预期行为:任务在工作日的设定时区 9:00 进入一次 Scheduled 运行。创建后先使用 Run now 手动执行一次,再检查下一次运行时间是否与预期一致。

事件触发适合“有变化才做事”。在符合资格的计划和工作区中,Web 或移动端可针对 Gmail、Slack 和 GitHub 的受支持事件触发任务;GitHub 可以围绕 PR 活动按作者、标题、标签等条件过滤。一个任务可以使用多个事件触发器,但不能同时再配置时间计划。:contentReference[oaicite:4]{index=4}

选择运行环境

如果任务需要操作本机仓库,桌面端可以让 scheduled task 直接在本地项目中运行,也可以为 Git 仓库创建隔离 worktree。本地模式会直接改动你正在使用的 checkout;worktree 把后台修改隔离开,更适合自动修复、依赖升级和代码整理。

本地项目任务要求机器保持开机、桌面应用保持运行,并且项目路径仍然可用。Web Scheduled task 则可以使用上传文件、连接工具、skills 和 plugins,但不会长期保留你电脑上的本地目录或 worktree。:contentReference[oaicite:5]{index=5}

写出可长期运行的任务指令

持久 prompt 必须能在没有临时口头补充的情况下重复执行。它至少要写清输入范围、判断条件、允许的动作、验证命令和“没有重要变化时怎么办”。下面是一份适合每日维护的完整任务指令,可先在普通 chat 中手动运行验证,再交给 Scheduled task。

text
检查当前仓库最近一次基线之后的 CI 失败与测试回归。

要求:
- 只处理能够在当前仓库中复现的问题。
- 先定位根因,再做最小修改,不顺手重构无关代码。
- 修改后运行与变更直接相关的测试。
- 如果测试通过,返回变更文件、根因、验证结果和仍需人工确认的风险。
- 如果没有可复现的新问题,只报告“没有需要处理的新回归”,不要修改文件。

预期结果

text
每次运行都会得到一份可审查结果:
- 有问题时:根因、最小修改、测试验证和风险说明;
- 无问题时:明确说明没有需要处理的新回归;
- 不应在没有证据时制造无关改动。

把“每天几点运行”“监听哪个 PR 事件”留给任务触发器,而不是写死在业务 prompt 里。这样以后调整 cadence 不需要改动维护逻辑,同一份 prompt 也更容易迁移到别的项目。

把审查设为默认出口

Scheduled 视图既是任务管理页,也是运行结果收件箱,可以查看 Active、Paused、Completed 状态和近期运行。自动化刚建立时,先审查前几次输出,再调整 prompt、工具或频率;不要第一次运行看起来正确,就直接把高风险写操作永久放开。:contentReference[oaicite:6]{index=6}

Scheduled tasks 会在无人值守时使用默认 sandbox 设置,因此应从最窄权限开始。只读任务不需要写文件;需要改代码时再开放 workspace write;需要网络或外部工具时也只开放明确目标。把“自动发现和准备修复”与“人工确认后合并”分开,通常比让周期任务直接改主分支更适合作为长期维护基线。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 Codex Automations

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通