ToCodex 定时任务

ToCodex 定时任务可以让 AI Agent 在指定时间自动执行工作流。它适合把重复、固定时间或需要持续巡检的任务交给 ToCodex 自动完成，例如生成日报、检查服务健康状态、同步文档与整理项目资料。

定时任务能做什么

定时任务会在后台按照触发规则启动一个 ToCodex 任务，并使用你指定的模式、提示词和运行配置执行。常见能力包括：

一次性任务：在某个具体时间只执行一次。
周期任务：按照固定间隔重复执行，例如每小时、每天或每周。
Cron 任务：使用 Cron 表达式定义更灵活的执行计划。
通知：在任务成功或失败时发送提醒，便于及时跟进。
并发策略：当上一次任务尚未结束而下一次触发到来时，决定跳过、排队或取消旧任务。

任务类型

一次性任务

一次性任务适合明确只需要执行一次的计划，例如：

明天早上 9 点生成某份项目报告。
在发布前 30 分钟检查文档、配置或部署状态。
在指定时间整理某个目录中的临时文件。

一次性任务执行完成后不会再次自动触发。

周期任务

周期任务按固定时间间隔重复运行，适合持续监控或定期维护，例如：

每小时检查服务是否正常。
每天汇总日志并生成摘要。
每 10 分钟检查任务队列是否堆积。

如果任务执行时间可能超过触发间隔，需要结合并发策略避免重复运行造成冲突。

Cron 任务

Cron 任务适合需要精确日历规则的场景，例如：

每个工作日早上 9 点生成日报。
每周一同步项目文档。
每月 1 日整理上月数据。

Cron 表达式通常由 5 个字段组成：

分钟 小时 日期 月份 星期

示例：

0 9 * * 1-5

表示每周一到周五早上 9 点执行。

通知设置

定时任务可以配置通知触发条件：

失败时通知：推荐默认开启，便于及时发现自动化中断、权限错误、网络异常或测试失败。
成功时通知：适合关键任务，例如发布前检查、报告生成、同步完成确认。
成功和失败都通知：适合需要完整审计记录的任务。

对于高频任务，建议只在失败时通知，避免产生过多提醒。

并发策略

当任务还在运行时，如果下一次触发已经到来，ToCodex 会根据并发策略处理：

| 策略 | 行为 | 适用场景 | | --- | --- | --- | | skip | 跳过本次新触发，保留正在运行的任务 | 监控、巡检、报告生成等不需要重复叠加的任务 | | queue | 将新触发排队，等当前任务完成后再执行 | 数据处理、文档同步等每次执行都不能丢的任务 | | cancel-previous | 取消正在运行的旧任务，立即开始新任务 | 只关心最新状态的任务，例如最新分支检查或最新文档构建 |

一般建议优先使用 skip，它最安全，能避免多个 Agent 同时修改同一批文件或访问同一服务。

示例一：每日生成报告

适用场景：每天固定时间汇总项目进展、测试结果、日志摘要或运营数据。

推荐配置：

触发方式：Cron
执行时间：每天 9:00
Cron 表达式：0 9 * * *
通知：失败时通知；关键报告可成功和失败都通知
并发策略：skip

示例提示词：

汇总昨天的项目变更、测试结果和待处理问题，生成一份中文日报，保存到 docs/reports/ 目录。

适合让 ToCodex 自动读取项目文件、运行检查命令、整理结果并生成结构化报告。

示例二：每小时检查服务

适用场景：定期确认服务、接口、队列、部署状态或日志中是否出现异常。

推荐配置：

触发方式：周期任务
执行间隔：每 1 小时
通知：失败时通知
并发策略：skip

示例提示词：

检查生产服务健康状态、最近错误日志和关键接口可用性。如果发现异常，整理原因、影响范围和建议处理步骤。

如果检查过程只读，不会修改文件或服务状态，可以安全地按较短间隔执行；如果会触发修复动作，应降低频率并明确权限边界。

示例三：定时同步文档

适用场景：定期从代码、接口定义、变更记录或远程资料中更新文档。

推荐配置：

触发方式：Cron 或周期任务
执行时间：例如每周一 10:00
Cron 表达式：0 10 * * 1
通知：成功和失败都通知
并发策略：queue 或 skip

示例提示词：

根据当前代码和配置同步项目文档，检查过期说明，补充新增功能，并生成变更摘要。

如果每次同步都必须完成，选择 queue；如果只需要保持文档大体更新，选择 skip 更稳妥。

适用场景

ToCodex 定时任务特别适合以下工作：

定期报告：日报、周报、发布报告、测试摘要。
服务巡检：接口可用性、日志异常、部署状态、队列积压。
文档维护：定时同步 README、API 文档、变更日志和使用指南。
项目治理：检查依赖更新、扫描 TODO、整理重复文件、归档历史资料。
发布辅助：发布前检查、发布后验证、回归测试提醒。
数据整理：定期汇总 CSV、日志、工单或运营数据。

使用建议

为任务写清楚输入、输出、保存位置和失败处理方式。
高频任务优先选择失败通知，低频关键任务可以开启成功通知。
涉及文件修改、部署或数据同步时，优先使用 skip 或 queue，避免并发冲突。
为长时间任务设置合理的最大运行时间，防止异常任务长期占用资源。
对生产环境任务保持最小权限原则，先从只读检查开始，再逐步加入自动修复动作。

通过一次性任务、周期任务和 Cron 的组合，ToCodex 可以把重复性的工程流程转化为稳定的自动化助手，让团队把注意力放在更重要的设计、开发和决策上。