reminder-notifier — Runtime Architecture（手動 HTML）

來源：/opt/data/skills/reminder-notifier/｜生成時間：2026/10/15 12:15 (+08:00)

一、技能概要

名稱：reminder-notifier｜類別：創意/排程｜用途：透過原生 cronjob create 建立一次性提醒（One-shot），時間到自動通知，完成後自動清理。
二、執行期架構（Mermaid 流程圖）
graph TD A["使用者提出提醒需求"] --> B{"LLM 解析意圖"} B --> C["cronjob create
一次性任務 + 08:00 時區"] C --> D["cron 排程系統
靜默等待到時間"] D --> E{"到達預約時間 -1hr?"
例如 20:00 會議 → 19:00 提醒} E -->|是| F["發送通知到 origin
（Telegram / 對話）"] E -->|否| D F --> G["任務完成 state=completed"] G --> H["週日 12:00 清理
cleanup_completed_crons.py
移除已完成一次性任務"] H --> I["維持 jobs.json 簡潔"] I --> J["使用者收到提醒
可手動取消或修改"]

三、關鍵規則（從 SKILL.md 提取）

面向規則
時區預設 Asia/Taipei (+08:00)；必須含偏移量
任務類型once（單次）；非重複
命名中文描述（例如「提醒：XXX 會議」）
靜默時間未到前完全不執行，不佔用資源
清理週日 12:00 自動掃描 completed + once + 過期 並刪除
管理cronjob list 查看；hermes cron remove <id> 取消

四、執行期組件關係（Mermaid）

graph LR U["User Prompt"] --> L["LLM / Hermes Agent"] L --> C["cronjob create API"] C --> J["cron daemon
jobs.json / run queue"] J --> T["Trigger at scheduled time"] T --> D["Deliver to origin
Telegram / Chat"] J --> P["Periodic clean
cron: 0 4 * * 0"] P --> R["Remove completed
once jobs"]

五、驗證清單