# 调度程序跨 macOS、Linux 和 Windows 管理自动化的 Claude Code 任务。安排市场技能、自由格式提示或 shell 脚本，以按定期 cron 计划运行或作为一次性任务运行，并具有安全控制和桌面通知。 ## 平台支持平台|调度程序|通知 | API密钥存储 ---|---|---|--- macOS | launchd（plist + launchctl）| osascript（本地）|钥匙串（`安全`CLI） Linux | systemd 用户计时器（.service + .timer）|通知发送 (libnotify) |秘密工具（GNOME 密钥环）或 `~/.config/anthropic/api-key` 窗户 |任务计划程序（schtasks.exe + XML）| BurntToast / Windows 吐司 | Windows 凭据管理器或 `%USERPROFILE%\.config\anthropic\api-key` 该平台在运行时自动检测。任务记录它们是在哪个平台上创建的。 ## 概述该编排器管理计划任务的整个生命周期。它将所有操作委托给“scheduler.py”并以对话方式呈现结果。 **核心原理**：这是一个瘦编排器。所有调度逻辑、文件生成和平台调度程序交互均由具有特定于平台的后端的“scheduler.py”处理。该技能仅管理对话流程。 ## 何时使用在以下情况下使用此技能： * 安排一项重复性或一次性任务（技能、提示或脚本） * 列出、暂停、恢复或删除计划任务 * 查看过去计划运行的结果或日志 * 在激活计划任务之前测试它 ## 先决条件 * macOS、Linux 或 Windows * PATH 中的“claude” CLI（用于技能和提示任务） * 安装了`uv`（用于运行scheduler.py） * **仅限 Linux**：`systemctl --user` 可用（带有用户会话的 systemd） * **仅限 Windows**：PowerShell 5.1+ 和任务计划程序访问 ## 首次设置第一次调用时，验证“claude”已通过身份验证并且位于 PATH 中：克劳德-p“你好”--max-turns 1--输出格式文本如果失败，请引导用户运行“claude login”，然后再继续。还要检查调度程序目录是否存在。调度程序默认使用项目级存储 - 它查找“.git”或“CLAUDE.md”来查找项目根目录，然后将状态存储在“/.claude/scheduler/”中： ls .claude/scheduler/registry.json 如果它不存在，第一个“add”命令将自动创建它。无需手动设置。您可以使用“SCHEDULER_DIR”环境变量覆盖该位置，或者在项目外部时回退到“~/.claude/scheduler/”。 ## 工作流程当用户调用`/manage`时，呈现操作菜单： 1. **添加**一个新的计划任务 2. **列出**所有计划任务 3. **暂停**任务 4. **恢复**暂停的任务 5. **删除**任务 6. **结果** — 查看任务的输出 7. **Logs**——查看执行日志 8. **立即运行** — 立即测试任务 9. **清理** — 删除旧日志和结果 10. **修复** - 重新生成包装器和计划工件然后执行下面选择的操作。 ###操作：添加以对话方式引导用户浏览每个字段： **第 1 步：任务名称** 问：“这个任务应该叫什么名字？”从名称生成 slug ID（例如，“每周笔记想法”→ `weekly-note-ideas`）。 **第 2 步：任务类型** 问：“什么类型的任务？” * **技能** — 调用市场技能（例如，`creator-stack:generate-note-ideas`） * **提示** — 运行自由格式的 Claude 提示符 * **脚本** — 执行 shell 脚本 **第 3 步：目标** 基于类型： * 技能：询问哪个技能。如果可能的话，建议相关的安装技能。 * 提示：询问提示文本。 * 脚本：询问脚本的绝对路径。 **第 4 步：频率** 问：“重复性还是一次性？” * **重复** — 按计划运行，直到暂停或删除 * **一次性** — 在指定时间运行一次，然后自动完成 **第 5 步：安排** 问：“什么安排？您可以使用自然语言或 cron 表达式。”示例：“每周一上午 8 点”、“每日 9:00”、“每个工作日上午 7:30”、“明天上午 9 点”、“0 8 * * 1” 将自然语言转换为 cron 表达式。对于一次性任务，将目标日期时间转换为特定的 cron（例如，2 月 25 日“明天上午 9 点”→ `0 9 26 2 *`）。与用户确认：“那是‘0 8 * * 1’——每周一上午 8:00。对吗？” **第 6 步：安全限制** 询问：“安全限制？默认为最多 20 圈，15 分钟超时。”让用户接受默认值或自定义。 **步骤 6a：输出目录（可选）** 询问：“想要将结果保存到特定目录吗？默认是调度程序的结果文件夹。”如果用户提供路径，它将被解析为绝对路径并用作平面输出目录（无日期子目录）。如果跳过，结果将转到“/results/YYYY-MM-DD/{id}.md”。 **步骤 6b：权限（跳过脚本类型任务）** 计划任务以非交互方式运行 - Claude Code 无法要求用户批准工具的使用。如果没有预先批准的权限，需要批准的工具将默默地失败。问：“这个任务应该有什么权限？”提供这些预设： * **默认** - 没有额外的权限（如果您全局设置了“bypassPermissions”，则有效） * **只读** — 读取文件、搜索、浏览网页（对于研究/报告任务来说是安全的） * **研究** — 读取文件、搜索、网页浏览、curl（用于数据收集） * **完整编辑** — 读取、写入、编辑文件、git、npm、uv、python、web（用于代码维护任务） * **绕过** - 跳过所有权限检查（`--dangerously-skip-permissions`） * **自定义** — 指定单独的工具名称对于 **custom** ，提示输入各个工具规范（例如，“Read”、“Write”、“Bash(git *)”），并用空格分隔。在确认汇总表中显示所选的权限模式。 CLI 标志： * `--permission-preset readonly|full-edit|research|bypass` * `--permission-mode default|acceptEdits|plan|dontAsk|bypassPermissions` * `--allowed-tools Read Write 'Bash(git *)'` （个人工具规范） **第七步：确认并创建** 呈现一个汇总表：领域 |价值 ---|--- 身份证 |每周笔记想法名称 |每周笔记想法类型 |技能目标|创建者堆栈：生成笔记想法频率|重复出现日程 |每个星期一上午 8:00 (0 8 * * 1) 最大转数| 20 超时 | 15分钟工作目录 | {当前项目目录} 输出目录 | （默认）权限| （默认）/只读/研究/完全编辑/旁路/自定义问：“创建这个任务吗？” 确认后，运行： uv run /scripts/scheduler.py 添加 \ --id“每周笔记想法”\ --name“每周笔记想法”\ --输入技能\ --target "creator-stack:generate-note-ideas" \ --cron“0 8 * * 1”\ --最大匝数 20 \ --超时分钟 15 \ --工作目录“{cwd}” 对于一次性任务，请添加“--run-once”标志。您还可以指定“--output-directory”和“--permission-preset”： uv run /scripts/scheduler.py 添加 \ --id“早间新闻脉搏”\ --name“早间新闻脉搏”\ --输入提示符\ --target“研究当今的人工智能新闻”\ --cron“0 9 26 2 *”\ --最大匝数 20 \ --超时分钟 15 \ --运行一次\ --权限预设研究\ --输出目录“/路径/到/输出”\ --工作目录“{cwd}” 报告：“已创建并激活！下次运行：{下次运行时间}。”对于一次性任务，请添加：“这将在运行后自动完成。” ### 操作：列表运行： uv run /scripts/scheduler.py 列表以格式化表格形式呈现：身份证 |名称 |类型 |日程 |状态 |最后一次运行 ---|---|---|---|---|--- 如果不存在任何任务，请说“尚无计划任务。使用添加来创建任务。” ### 操作：暂停 1. 运行“list”以显示活动任务 2.询问要暂停哪个任务 3. 运行： uv run /scripts/scheduler.py 暂停 --id "{task_id}" 4. 确认：“已暂停‘{task_id}’。除非您恢复它，否则它不会运行。” ### 操作：恢复 1. 运行“list”显示暂停的任务 2. 询问要恢复哪个任务 3. 运行： uv run /scripts/scheduler.pyresume--id“{task_id}” 4. 确认：“已恢复‘{task_id}’。下次运行：{下次}。” ### 操作：删除 1. 运行“list”显示所有任务 2.询问要删除哪个任务 3. **确认**：“这将停止计划并删除包装器和计划工件。结果和日志将保留。继续吗？” 4. 运行： uv run /scripts/scheduler.py 删除 --id "{task_id}" 5. 确认：“已删除‘{task_id}’。” ### 操作：结果 1.询问哪个任务（如果不清楚则显示列表） 2. 运行： uv run /scripts/scheduler.py 结果 --id "{task_id}" 3.内嵌显示最新结果内容列出所有结果： uv run /scripts/scheduler.py 结果 --id "{task_id}" --all ### 操作：日志 1.询问哪个任务 2. 运行： uv run /scripts/scheduler.py 日志 --id "{task_id}" 3. 显示最近的日志条目 ### 操作：清理删除旧的日志和结果文件以回收磁盘空间： uv run /scripts/scheduler.py cleanup --max-days 30 `--max-days` 标志控制保留期（默认值：30 天）。日志文件按修改时间进行清理；结果日期目录按目录名称进行清理。 **提示**：您可以将清理本身安排为重复任务： uv run /scripts/scheduler.py 添加 \ --id 调度程序清理 \ --name“调度程序清理”\ --输入脚本\ --target "/scripts/cleanup-wrapper.sh" \ --cron“0 3 * * 0”\ --工作目录“{cwd}” ### 操作：修复重新生成丢失或过时的包装器脚本并为所有活动任务安排工件。在插件更新、权限更改或包装器被意外删除后很有用。 1. 询问是强制重新生成所有包装器还是仅生成缺失的包装器。 2. 运行： uv run /scripts/scheduler.py 修复或者用武力： uv run /scripts/scheduler.py Repair --force 3. 报告已修复的问题数量。 ### 操作：立即运行 **重要**：`scheduler.py run` 生成 `claude -p` 作为子进程，该子进程在活动的 Claude Code 会话中失败（“无法在另一个 Claude Code 会话中启动”）。由于用户通常从 Claude Code 中调用此技能，因此请改用延迟调度方法。 **程序：** 1. 询问要测试哪个任务。 2. 读取注册表以保存任务当前的 cron 计划： uv run /scripts/scheduler.py get --id "{task_id}" 记下当前的“cron”值。 3. 计算从现在起约 2 分钟的 cron 表达式（例如，如果当前时间是 10:03，则使用 `5 10 {day} {month} *`）。包括日期和月份，以避免在后续几天再次触发任务。 4.暂停任务，编辑注册表中的cron，然后重新加载： uv run /scripts/scheduler.py 暂停 --id "{task_id}" 然后直接编辑`.claude/scheduler/registry.json` - 通过ID找到任务并将其`cron`字段更改为近期表达式。然后继续： uv run /scripts/scheduler.pyresume--id“{task_id}” 最后，重新生成包装器并使用新的 cron 进行调度： uv run /scripts/scheduler.py Repair --force 5. 告诉用户：“任务已重新安排在大约 2 分钟内运行。正在等待它触发...” 6. 每 30 秒轮询一次结果（直到任务超时 + 2 分钟）： uv run /scripts/scheduler.py 结果 --id "{task_id}" 比较时间戳以确认重新安排后出现了新结果。 7. 一旦结果出现（或超时），恢复原来的cron。编辑 `.claude/scheduler/registry.json` 将 `cron` 字段设置回原始值，然后重新加载： uv run /scripts/scheduler.py Repair --force 8. 向用户显示输出的结果，并确认原始日程已恢复。 ## Cron 表达式参考将自然语言转换为 cron：自然语言|克朗表达式 ---|--- 每天上午 9 点 | `0 9 * * *` 每周一上午 8 点 | `0 8 * * 1` 每个工作日上午 7:30 | `30 7 ** 1-5` 每个周日午夜 | `0 0 * * 0` 每小时 | `0 * * * *` 每月 1 日上午 6 点 | `0 6 1 * *` 每天两次（上午 9 点、下午 5 点）|需要两个任务 ## 错误恢复 **“任务已存在”**：建议使用不同的 ID 或先删除现有的 ID。 **“无效的 cron 表达式”** ：显示 cron 引用表并再次询问。 **“找不到包装器”**：运行修复： uv run /scripts/scheduler.py 修复 **“任务失败（检查日志）”**：使用日志操作来显示出了什么问题。 **“任务成功但输出为空”**：可能是权限问题。计划任务以非交互方式运行，并且无法提示工具批准。添加权限预设（例如，用于只读任务的“--permission-preset readonly”）并使用“repair --force”重新生成包装器。 **“包装器需要权限更新”**：在注册表中更改任务的权限后，运行“repair --force”以使用新设置重新生成所有包装器。 ## 注释有关权限、锁定文件、睡眠行为、存储和平台细节的实现详细信息，请参阅“references/implementation-notes.md”。 ## 质量检查表 * 正确识别任务类型（技能/提示/脚本） * Cron 表达式经过用户验证和确认 * 创建前呈现的汇总表 * Scheduler.py命令执行成功 * 用户被告知下次运行时间（用于添加/恢复） * 破坏性操作前要求确认（删除）

管理

包含技能