Chronos - Universal Periodic Task Manager

What this skill controls

• - 周期任务表：periodic_tasks + periodic_occurrences（默认使用共享 todo.db）
• 原 todo 表：entries（仅兼容 legacy inbox / 未迁移旧任务）
• 统一入口：INLINECODE4

Capabilities

周期类型

• - once：一次性（有明确 --start-date 时走 canonical task/occurrence）
• INLINECODE7：每天
• INLINECODE8：每 N 小时（--interval-hours + --time 作为锚点）
• INLINECODE11：每周（指定星期几）
• INLINECODE12：每月固定日期（如15号）
• INLINECODE13：每月区间（如11号→5号，跨月）
• INLINECODE14：每月限次（如每周三每月最多2次，或 weekday 留空表示“每天都可提醒，但本月完成满额后停止”）
• INLINECODE16：每月多个固定日期（如 1,15,31）

智能配额

• - 仅 completed 计数，skip 不计
• INLINECODE20 若 weekday 为空，则按“每日可提醒”展开，但仍受每月配额约束
• 配额用满后自动完成当月剩余活动日
• 每月1号自动重置计数器

自动提醒

• - Cron 任务自动生成（未来事件）
• 每日自动清理过期 cron
• 提醒投递必须显式指定目标 chat
• 若时间已过，会走补发提醒分支
• INLINECODE22 任务会在当天展开为多个 occurrence，按 scheduled_time 各自提醒/补完成

统一视图

• - todo.py list：合并显示周期任务和普通任务
• INLINECODE25：智能路由（scheduled recurring / scheduled once → canonical task；无日期的一次性便签 → entries）
• INLINECODE26：完成单个 occurrence 或普通任务
• INLINECODE27：优先基于 occurrence 补完成；legacy entries 仅保留兼容兜底
• INLINECODE28：查看详情
• INLINECODE29：跳过任务且不消耗 monthlyntimes 配额

显式 system handler

• - special_handler 元数据挂在 periodic_tasks 上，不再只能靠 entries.text 正则猜测
• 当前已支持：meta_review_fallback、INLINECODE34
• INLINECODE35 从 memory/subagent_sync_ledger.json 读取待同步 subagent session；现在应由 OpenClaw 在 subagent 完成路径自动写入 ledger，memory_manager.py record-subagent <session_id> 仅保留给补录/回填场景，成功后标记 handled
• overdue completion 会把 handler 结果写回 occurrence：completion_mode / INLINECODE39
• 对同一天同一 hourly 任务的多个 overdue occurrence，如存在 special_handler，complete-overdue 只执行一次 handler，再把所有相关 occurrence 标记为 fallback_handler_merged，并写入 merged trace（merge_key / merged occurrence index/count）

Configuration

• - Chat ID: Reminder notifications target a specific chat. Configure via:

• - No implicit routing: Chronos does not fall back to last or any implicit delivery target
• Workspace/DB overrides:

Usage

CODEBLOCK0

Verification

CODEBLOCK1