# 计划任务 ## 概述使用此技能通过本机 Zig `cron` CLI 管理 Codex 自动化。运行时路径仅限 Zig（无 Python 回退，无 shell launchd 包装器）。 ## Zig CLI 迭代存储库当迭代“cron”时，使用这两个存储库： * `skills-zig` (`/Users/tk/workspace/tk/skills-zig`)：`cron` 二进制文件、构建/测试连接、发布标签的源。 * `homebrew-tap` (`/Users/tk/workspace/tk/homebrew-tap`)：已发布二进制文件的公式/校验和更新。 ## 快速入门运行_cron_工具（）{ install_cron_direct() { 本地存储库 =“${SKILLS_ZIG_REPO:-$HOME/workspace/tk/skills-zig}” 如果！命令 -v zig >/dev/null 2>&1;然后 echo“未找到 zig。从 https://ziglang.org/download/ 安装 Zig 并重试。” >&2 返回1 菲如果[！ -d“$repo”]；然后 echo“在 $repo 中找不到技能-zig 存储库。” >&2 echo "克隆它： git clone https://github.com/tkersey/skills-zig \"$repo\"" >&2 返回1 菲如果！ (cd "$repo" && zig build build-cron -Doptimize=ReleaseFast);然后 echo“直接 Zig 构建在 $repo 中失败。” >&2 返回1 菲如果[！ -x "$repo/zig-out/bin/cron"];然后 echo“直接 Zig 构建没有生成 $repo/zig-out/bin/cron。” >&2 返回1 菲 mkdir -p“$HOME/.local/bin” 安装-m 0755“$repo/zig-out/bin/cron”“$HOME/.local/bin/cron” } 本地操作系统=“$(uname -s)” if 命令 -v cron >/dev/null 2>&1 && cron --help 2>&1 | grep -q "cron.zig";然后克罗恩“$@” 返回菲 if [ "$os" = "达尔文" ];然后如果！命令 -v brew >/dev/null 2>&1;然后 echo "macOS 上需要自制软件：https://brew.sh/" >&2 返回1 菲如果！酿造安装 tkersey/tap/cron;然后 echo“brew 安装 tkersey/tap/cron 失败。” >&2 返回1 菲埃利夫！ (命令 -v cron >/dev/null 2>&1 && cron --help 2>&1 | grep -q "cron.zig");然后如果！ install_cron_direct;然后返回1 菲菲 if 命令 -v cron >/dev/null 2>&1 && cron --help 2>&1 | grep -q "cron.zig";然后克罗恩“$@” 返回菲 echo“尝试安装后，cron 二进制文件丢失或不兼容。” >&2 if [ "$os" = "达尔文" ];然后 echo "预期安装路径：brew install tkersey/tap/cron" >&2 否则 echo“预期直接路径：SKILLS_ZIG_REPO= zig build build-cron -Doptimize=ReleaseFast”>&2 菲返回1 } * 列出自动化：`run_cron_tool list` * 显示一项自动化操作：`run_cron_tool show --id ` * 创建自动化： `run_cron_tool create --name "Weekly release Notes" --prompt-file /path/to/prompt.md --rrule "RRULE:FREQ=WEEKLY;BYDAY=FR;BYHOUR=9;BYMINUTE=0"` * 更新自动化： `run_cron_tool update --id --rrule "RRULE:FREQ=DAILY;BYHOUR=9;BYMINUTE=0"` * 启用或禁用：`run_cron_tool启用--id`或`run_cron_tool禁用--id` * 立即运行：`run_cron_tool run-now --id ` * 删除：`run_cron_tool delete --id ` * 运行一次到期自动化：`run_cron_tool run-due` * 运行应有的自动化试运行：`run_cron_tool run-due --dry-run` * 安装/启动 launchd 调度程序 (macOS): `run_cron_tool Scheduler install` * 停止/删除 launchd 调度程序 (macOS)：`run_cron_tool 调度程序卸载` * 显示调度程序状态 (macOS)：`run_cron_tool 调度程序状态` 运行时引导策略镜像 `seq`/`cas`/`lift`：需要 Zig 二进制文件，在 macOS 上默认安装 Homebrew，并在非 macOS 上回退到从 `skills-zig` 直接安装 Zig。子命令 `--help` 打印顶级用法。有关详细选项，请使用下面的矩阵。 ## 工作流程 1. 选择工作目录（`cwds`）。如果在“create”上省略，则默认为当前存储库。 2. 编写自动化提示符（使用 `--prompt-file` 进行多行提示符）。 3. 提供 RFC5545 RRULE 字符串。 4. 使用 `cron` 创建或更新。 5. 对于无人值守执行，请通过“cron Scheduler install”安装调度程序。 ## 无头跑者 * `cron run-due` 通过调用 `codex exec` 执行适当的自动化并更新： * `automations.last_run_at` * `automations.next_run_at` * `automation_runs` 行 * `cron run-due --dry-run` 是只读的： * 没有插入/更新“automation_runs”行 * 没有 `automations.last_run_at`/`next_run_at` 更新 * 没有自动化文件或 `memory.md` 写入 * `--codex-bin` 接受可执行文件名称或绝对路径（默认解析 `PATH` 中的 `$CODEX_BIN` 或 `codex`）。 * 锁定是标签范围内的且失败时关闭（`--lock-label` 或 env `CRON_LAUNCHD_LABEL`）。 * `--lock-label` 使用严格的标签验证：仅 `[A-Za-z0-9._-]` （无斜杠/空格）。 * “run-due”默认批量限制是每次调用“10”个自动化（“--limit”覆盖）。 * 调度程序命令仅限 macOS，并直接从 Zig 管理 `~/Library/LaunchAgents/.plist`。 * Launchd 调度程序使用默认数据库路径和默认限制运行“run-due”，除非您通过覆盖手动调用“cron”。 * 日志：`~/Library/Logs/codex-automation-runner/out.log` 和 `~/Library/Logs/codex-automation-runner/err.log`。 ## 命令选项（高信号） * `list`: `--status `, `--json` * `show`: `--id ` 或 `--name `，可选 `--json` * `create`: `--name`, `--prompt|--prompt-file`, `--rrule`, 可选的 `--status`, `--cwd` (可重复), `--cwds-json`, `--clear-cwds`, `--next-run-at` * `update`: `--id|--name`, 可选 `--new-name`, `--prompt|--prompt-file`, `--rrule`, `--status`, `--cwd` (可重复), `--cwds-json`, `--clear-cwds`, `--next-run-at`, `--clear-next-run-at` * `启用|禁用|立即运行|删除`: `--id` 或 `--name` * `run-due`：可选 `--id`、`--limit`、`--dry-run`、`--codex-bin`、`--lock-label` （仅限 `[A-Za-z0-9._-]`） * `调度程序安装`：可选`--label`、`--interval-seconds`、`--path`、`--codex-bin` * `调度程序卸载|状态`: 可选`--label` * 调度程序 `--label` 是严格的：只有 `[A-Za-z0-9._-]` （没有斜杠/空格）。 ## 歧义时澄清仅当请求不明确或用户明确要求指导时才提出问题。否则请勿阻塞。确认或推断的基本要素： 1. 自动化名称。 2.提示内容（单行或文件路径）。 3. 安排为 RFC5545 RRULE 字符串（包括“RRULE:”前缀）。 4. 工作目录（`cwds`），如果未指定，则默认为当前存储库。 5. 明确要求的状态；否则默认为“ACTIVE”。当有歧义时，询问缺失的细节。示例： * 如果用户说“每天”/“每周”而没有时间，请询问所需的时间/日期字段。 * 如果用户在没有路径的情况下说“为此存储库运行它”，请确认存储库根目录为“cwd”。 ## 时间表 (RRULE) * 仅接受 RFC5545 RRULE 字符串。不支持 Cron 表达式。 * 规则被规范化为“RRULE:”前缀形式。 * 为了兼容性，在运行时仍然接受传统的无前缀存储值（`FREQ=...`）。 * 验证失败后关闭。 * `BYHOUR`/`BYMINUTE` 以 UTC 解释。 * 支持的频率： * `HOURLY` 需要 `BYMINUTE` * `DAILY` 需要 `BYHOUR` 和 `BYMINUTE` * `WEEKLY` 需要 `BYDAY`、`BYHOUR` 和 `BYMINUTE` 规则示例： * 每天 09:00：`RRULE:FREQ=DAILY;BYHOUR=9;BYMINUTE=0` * 每周周五 09:00：`RRULE:FREQ=WEEKLY;BYDAY=FR;BYHOUR=9;BYMINUTE=0` * 每 24 小时：`RRULE:FREQ=HOURLY;INTERVAL=24;BYMINUTE=0` ## 任务示例 ### 每日站立总结名称：“总结昨天的 git 活动” 提示：总结昨天站立的 git 活动。包括值得注意的提交、涉及的文件以及任何风险或后续行动。时间表：`RRULE:FREQ=DAILY;BYHOUR=9;BYMINUTE=0` ### 每周发行说明名称：“每周发布说明草案” 提示：来自合并 PR 的每周发布说明草案。包括可用的链接并按区域分组。时间表：`RRULE:FREQ=WEEKLY;BYDAY=FR;BYHOUR=9;BYMINUTE=0` ### CI 失败分类名称：“总结 CI 失败”提示：总结上一个 CI 窗口中的 CI 失败和不稳定测试，按根本原因分组，并建议最少的修复。时间表：`RRULE:FREQ=DAILY;BYHOUR=8;BYMINUTE=30` ## 数据模型参考有关架构和字段注释，请参阅“references/db.md”。

计划任务

包含技能