用途：管理 Claude Code 的自动化定时任务，可调度市场技能、自由提示词或 shell 脚本，按 cron 周期运行或作为一次性任务运行，并提供安全控制与桌面通知。
主要能力：添加、列出、暂停、恢复、删除任务；查看结果与执行日志；立即测试任务；清理旧日志与结果；修复包装脚本与调度产物。平台自动检测：macOS 用 launchd，Linux 用 systemd 用户定时器，Windows 用任务计划程序；通知与 API 密钥存储也按平台处理。
使用方式：需 macOS/Linux/Windows、PATH 中有 claude CLI、已安装 uv；Linux 需 systemctl --user，Windows 需 PowerShell 5.1+。首次使用先验证 claude 已认证：claude -p "hello" --max-turns 1 --output-format text。任务状态默认存于 <project>/.claude/scheduler/，可用 SCHEDULER_DIR 覆盖。添加任务示例：uv run <skill_dir>/scripts/scheduler.py add --id "weekly-note-ideas" --name "Weekly note ideas" --type skill --target "creator-stack:generate-note-ideas" --cron "0 8 * * 1" --max-turns 20 --timeout-minutes 15 --working-directory "{cwd}"。一次性任务加 --run-once，还可指定 --output-directory 与 --permission-preset。
适用场景：定期生成内容、研究汇总、代码维护、脚本执行等需要无人值守运行的 Claude Code 任务。
限制：定时任务非交互运行，无法弹出工具授权，需预先设置权限预设，否则需授权的工具会静默失败；scheduler.py run 在活动 Claude Code 会话内会失败，测试需改用延迟调度方式；暂停后若 OS 层任务仍加载，需手动卸载。具体实现细节见 references/implementation-notes.md。