01

先说结论:先把流程跑通,再交给计划任务

这篇文章适合想让 Codex 定期检查 CI、整理提交、生成发布说明、扫描明显缺陷、更新文档或输出日报的开发者。官方建议先在普通聊天中手动测试提示词,确认模型、推理强度、工具和输出都可控,再创建计划任务;尚需频繁人工纠偏的流程,应该先整理成 Skill 或脚本。

Scheduled Tasks 负责“何时运行”,Skill 负责“如何运行”。把方法、输入、验证和输出固化到 Skill 或仓库说明中,再让计划任务指定项目、周期和执行环境,后续维护成本更低。下图是本站原创的定时触发、隔离执行、权限检查、测试与报告流水线示意,不是官方产品界面。

如果需要先补齐任务说明,可以使用Codex 任务说明模板;更多中文实践入口见GPTUPCN 首页。本站是第三方中文知识与服务入口,并非 OpenAI 官方。

Codex 定时任务从触发到 Worktree 权限测试和报告验收的原创流程图
Codex 定时任务从触发到 Worktree 权限测试和报告验收的原创流程图
02

先选择网页任务还是桌面项目任务

当前文档把任务表面分成网页与桌面两类。网页端可创建和管理 Scheduled Tasks,能使用上传的上下文、连接工具、Skills 和插件,但不能直接访问你电脑上的本地文件夹。需要读取本机仓库、运行本地命令或写入项目文件时,应使用桌面端并选择对应项目。

桌面端的本地项目任务依赖电脑保持开机、应用保持运行且项目路径仍然可用。若任务只需访问云端数据或公开网站,云端执行更适合无人值守;若结果必须落到本地仓库,就要把设备在线、磁盘路径和依赖环境视为任务的一部分。CLI 和 IDE 扩展可以帮助试跑提示词或脚本,但官方当前说明它们不提供 Scheduled 管理界面。

场景更合适的执行面关键限制
定期研究网页并输出摘要网页或云端 Scheduled Task来源、联网与报告位置要明确
修改本机 Git 仓库桌面项目任务电脑和应用需在线,项目路径需可用
独立生成每日报告Standalone 计划任务每次从保存的提示词开始
持续跟进同一部署或审查聊天内计划任务沿用当前聊天上下文并设置停止条件
先验证命令与脚本CLI 或 IDE 手动执行完成试跑后再到网页或桌面创建计划
03

Local 与 Worktree 怎么选?

Git 项目可以让计划任务直接在本地主检出目录运行,也可以使用独立 Worktree。Local 的优点是结果直接落在你正在使用的目录,代价是后台任务可能与未完成的人工修改碰撞;Worktree 会把修改隔离到独立检出,更适合自动修复、生成代码或批量更新。非 Git 项目没有 Worktree 隔离,任务会直接在项目目录中运行。

频繁计划可能积累大量 Worktree。官方建议及时归档不再需要的计划运行,并避免无目的地固定运行记录,否则后台检出会长期占用空间。可结合Codex 与 Git Worktree 并行开发实践制定清理规则。

  • 只读检查、日志摘要:Local 或 Worktree 均可,优先最小改动
  • 自动修复、格式化、依赖更新:优先 Worktree 隔离
  • 需要修改当前主目录中的固定报表:可用 Local,但要限制目标路径
  • 非 Git 目录:先准备备份和明确输出文件,避免覆盖原始资料
  • 高频计划:定期归档运行并检查遗留 Worktree
04

权限设置:从最窄边界开始

计划任务无人值守,因此权限要比交互式聊天更谨慎。文档说明 Scheduled Tasks 使用默认 sandbox 设置:read-only 不适合写文件、联网或操作本机应用;workspace-write 允许工作区内写入,但工作区外文件、联网和本机应用仍受限制;full access 风险最高,可能在无人确认时修改更广范围的文件并访问网络。

更稳妥的做法是先列出任务真正需要的能力,再选择最小权限。需要联网时只放行必要来源;需要写入时限定输出目录;涉及发布、删除、付费、权限变更或外部消息时,把人工确认写进流程,不要让“每天运行”自动扩大授权。详细边界可参考Codex 权限与沙箱实践

权限模式适合任务常见失败或风险
read-only代码审查、现状分析、读取报告写文件、联网或本机应用操作可能失败
workspace-write在指定项目内生成代码和报告项目外路径与未允许网络仍会失败
full access确有必要且来源可信的高级维护无人值守时影响范围大,应尽量避免
05

一个可复用的定时任务提示词结构

计划任务提示词应能在你不在线时独立解释目标。不要只写“每天检查项目”,而要说明输入范围、执行动作、判断标准、允许修改的目录、验证命令、报告格式、没有变化时如何处理,以及遇到登录失效或事实无法核实时是否停止。

  • 目标:本次运行要达成什么可验证结果
  • 范围:允许读取和修改哪些仓库、分支、目录与外部来源
  • 步骤:检查、实现、测试、发布和回滚的顺序
  • 验收:必须通过哪些命令、页面状态或数据校验
  • 输出:报告文件名、保存路径、链接与摘要字段
  • 异常:无变化、登录失效、验证码、冲突和测试失败时怎么处理
  • 停止条件:何时完成、何时暂停并请求人工判断
06

上线前后各做一次验收

创建计划前先手动执行同一提示词,并检查它是否会重复生成近似内容、覆盖用户文件或依赖交互式登录。创建后立即用 Run now 或首个计划周期验证一次,确认任务选择了正确项目、模型、环境和权限,最终产物能被别人独立检查。

对写代码任务,至少保留测试、差异和回滚说明;对研究任务,保留来源和日期;对发布任务,逐条打开公开链接验证状态码、排版、图片和索引文件。可结合Codex 任务完成后的测试证据清单建立统一报告。

验收阶段必须确认失败时处理
手动试跑提示词、工具、模型和输出可控缩小范围或先做 Skill
首次计划运行项目、权限、周期和时区正确暂停任务并修正配置
结果检查测试、差异、链接和报告完整不发布低质量或未验证结果
持续维护选题未重复、依赖仍有效、Worktree 可控降低频率或归档旧运行
07

常见故障排查顺序

任务没有运行时,依次检查计划是否启用、时区与 RRULE、账号或工作区权限;任务运行但读不到文件时,检查执行面、项目路径、电脑和应用是否在线;能读取但无法写入或联网时,检查 sandbox 与规则;运行成功但结果不可用时,回到提示词、来源、验收和输出路径。

模型也属于计划配置的一部分。昨天已经完成的Codex GPT-5.4 迁移到 GPT-5.6 Terra / Luna 清单可用于检查旧任务中的模型引用,但不要为了追新而频繁改动已经稳定的流程,先以代表性任务回归验证。

08

结论:可重复、可审查,比“自动运行”更重要

一个成熟的 Codex 定时任务应满足四点:输入稳定、权限最小、输出可验证、异常会停下。先用普通聊天或 CLI 把流程跑通,再用 Skill 固化方法,最后交给 Scheduled Tasks 安排时间,才能把自动化从偶然成功变成可维护的工程能力。

资料

官方资料与延伸阅读

产品界面、价格、额度和规则可能调整,涉及实时信息时请以官方页面与账号内显示为准。

延伸

相关文章

继续阅读同一主题下的文章,可以把购买、支付、套餐、账号和到账问题串成完整流程。

FAQ

常见问题

Codex CLI 可以直接管理 Scheduled Tasks 吗?

官方当前文档说明 CLI 不提供 Scheduled 管理界面。可以用 CLI 先测试提示词、Skill 或脚本,再通过 ChatGPT 网页或桌面应用创建和管理计划任务。

Codex 定时任务需要电脑一直开机吗?

需要直接访问本机项目或本地文件的桌面任务,需要电脑保持开机、应用运行且项目路径可用。网页或云端任务不依赖本机目录,但也不能直接读取你的本地文件夹。

定时任务应该选 Local 还是 Worktree?

会修改代码或生成较多文件时优先 Worktree 隔离;只读检查或确实需要写入当前主目录时可选 Local,但要防止与人工修改冲突。

为什么任务能手动运行,计划运行却无法联网?

计划任务按默认 sandbox 和组织策略无人值守执行,权限环境可能与交互式运行不同。检查网络访问、工作区规则和管理员限制,不要直接改成 full access。

Skill 和 Scheduled Task 有什么区别?

Skill 固化可复用的方法、工具和上下文;Scheduled Task 决定何时、在哪个项目和环境执行。复杂流程通常先做成 Skill,再安排周期。