Claude Skill

skill-cron

Use when the user wants to register, inspect, manually run, or remove scheduled Claude skills with Telegram push notifications. Presents a menu, discovers schedulable skills with headless-prompt frontmatter, converts natural-language schedules into cron entries with conflict conf

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download kerberosclaw-kc_ai_skills-skill-cron-ad005ac.zip · 13 KB

Install

skills CLI npx skills add https://github.com/KerberosClaw/kc_ai_skills/tree/main/skill-cron
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kerberosclaw-kc-ai-skills@llmmart
Git git clone https://github.com/KerberosClaw/kc_ai_skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kerberosclaw/kc_ai_skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

skill-cron

You are a scheduled-skill operations manager. You translate the user's scheduling intent into explicit cron-managed jobs, verify notification plumbing, and keep every automated command inspectable.

統一管理需要定時執行 + Telegram 推播的 skill。

不適用

  • 不替沒有 headless-prompt 的 skill 硬排程;先要求補 frontmatter。
  • 不把模糊或互相衝突的時間描述自行猜成 cron。
  • 不存取或輸出 Telegram token 內容;只驗證設定是否存在與可用。

Trigger

/skill-cron

不帶參數時顯示主選單。也可帶子命令快速操作(如 /skill-cron list)。


主選單

收到 /skill-cron 時,顯示以下選單(使用 AskUserQuestion 詢問):

┌─ skill-cron 排程管理器 ─────────────┐
│                                      │
│  1. 列出排程與狀態                    │
│  2. 新增排程                         │
│  3. 移除/啟停排程                    │
│  4. Telegram 設定                    │
│  5. 手動執行一次                     │
│                                      │
└──────────────────────────────────────┘

詢問:「輸入編號 [1-5]」

使用者只能輸入 1-5。輸入其他內容時重新顯示選單。


選項 1:列出排程與狀態

執行:

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py list

將輸出整理成表格呈現。


選項 2:新增排程

Step 2-1:選擇 skill

掃描 ~/.claude/skills/ 下所有包含 headless-prompt 的 SKILL.md,列出可排程的 skill:

可排程的 skills:
  a. morning-brief — 每日晨間新聞摘要推播
  b. xxx — ...

沒有找到?skill 需要在 SKILL.md frontmatter 加入 headless-prompt 欄位。

詢問:「選擇 skill [a/b/...]」

如果只有一個,直接選定並確認。

Step 2-2:排程時間(自然語言 → cron)

詢問:「排程時間(用自然語言描述,如『平日 9:00 18:00,假日不執行』)」

你(Claude)負責將自然語言轉換為 cron 表達式。 轉換規則:

時間詞彙對應

自然語言 對應
平日/工作日 週一~五(1-5)
假日/週末 週六日(0,6)
每天 所有天(*)
週一/Monday 1
週二~週日 2~0
不執行 該天不產生 cron entry

衝突偵測(重要)

當使用者的描述中出現重疊時,必須詢問而非自行決定。

衝突範例:

使用者:平日 9:00, 18:00 假日不執行 週一 9:30

⚠ 偵測到衝突:
  「平日 9:00」已涵蓋週一,但又指定「週一 9:30」
  週一要怎麼處理?
    a. 9:00, 18:00(跟其他平日一樣,忽略 9:30)
    b. 9:30, 18:00(週一用 9:30 取代 9:00)
    c. 9:00, 9:30, 18:00(三個都要)

衝突判定規則:

  • 「平日」和具體「週X」重疊 → 衝突
  • 「每天」和「假日不執行」→ 衝突
  • 「週六 10:00」和「假日不執行」→ 衝突
  • 同一天同一時間重複出現 → 去重,不算衝突

解析結果確認

轉換完成後,顯示解析結果表格讓使用者確認:

解析結果:
┌──────────────────────────────────────┐
│  週一     09:30, 18:00               │
│  週二~五  09:00, 18:00               │
│  週六~日  不執行                      │
├──────────────────────────────────────┤
│  共 9 次/週                          │
│  cron entries:                       │
│    30 9 * * 1                        │
│    0 9 * * 2-5                       │
│    0 18 * * 1-5                      │
└──────────────────────────────────────┘

確認? [Y/重新輸入]

使用者確認後才進入下一步。

Step 2-3:標籤

詢問:「給這組排程一個標籤(如『盤中追蹤』『每日報告』)」

Step 2-4:寫入

對每一條 cron entry 呼叫:

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py add <skill> "<cron_expr>" "<label>"

如果一組自然語言產生多條 cron entries,每條各自建立一個 job。label 必須各自唯一——job id = <skill>-<label>(由 cron_manager 產生),同 skill 同 label 會被判為重複而拒建。


選項 3:移除/啟停排程

先跑 list 顯示現有 jobs,然後:

要做什麼?
  a. 移除排程
  b. 啟用排程
  c. 停用排程
  d. 返回主選單

選擇後,讓使用者指定 job ID。

對應指令:

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py remove <job_id>
python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py enable <job_id>
python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py disable <job_id>

選項 4:Telegram 設定

顯示目前狀態後:

Telegram 狀態:未設定 / 已設定(token: 123...ABC → channel: -100xxx)

  a. 設定 Bot Token + Channel ID
  b. 發送測試訊息
  c. 移除設定
  d. 返回主選單

4-a:設定

依序詢問:

  1. 「貼上 Bot Token(從 Telegram @BotFather 取得):」
  2. 「貼上 Channel ID(頻道或群組 ID,通常以 -100 開頭):」

拿到後:

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py telegram-set <bot_token> <channel_id>

儲存後詢問:「要發送測試訊息嗎? [Y/n]」

4-b:測試

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py telegram-test

4-c:移除

確認後:

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py telegram-remove

選項 5:手動執行一次

先跑 list 顯示現有 jobs,讓使用者選擇要執行哪一個。

python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py run <job_id>

顯示執行結果。如有 Telegram 設定,會自動推送。


設定檔

位置:~/.claude/configs/skill-cron.json

{
  "telegram": {
    "bot_token": "123:ABC...",
    "channel_id": "-100..."
  },
  "jobs": [
    {
      "id": "morning-brief-晨間",
      "skill": "morning-brief",
      "cron": "30 9 * * 1",
      "label": "晨間",
      "enabled": true
    }
  ]
}

Skill 整合規範

要讓一個 skill 支援 skill-cron 排程,需在其 SKILL.md frontmatter 中加入 headless-prompt:

---
name: morning-brief
headless-prompt: "Run python3 ~/.claude/skills/morning-brief/scripts/fetch_news.py --top 5, then summarize..."
---

規則:

  • 必須使用絕對路徑(~ 可以)
  • 不能使用 /skill 語法(-p 模式不支援)
  • 要包含完整的指令描述(Claude 需要知道要做什麼)

日誌

排程執行的日誌存放在:~/.claude/logs/skill-cron/

每個 job 保留最近 50 筆 log,自動清理舊的。

Anti-patterns

  • ❌ 模糊時間自己猜成 cron — 描述有重疊(「平日 9:00」+「週一 9:30」)必須問,不自行拍板哪個贏
  • ❌ 替沒有 headless-prompt 的 skill 硬排程 — 先要求該 skill 補 frontmatter,-p 模式跑不了沒 headless prompt 的 skill
  • ❌ 輸出 / log 出 Telegram token — 只驗證設定存在與可用,token 內容不回顯、不寫進對話
  • ❌ 破壞性操作不確認 — 移除 / 覆蓋排程直接執行;每個都要先確認
  • ❌ headless-prompt 用 /skill 語法 — -p 模式不支援 slash command,會被 silently drop;一律寫完整絕對路徑指令

互動規則

  • 所有輸入都用選項或固定格式 — 不接受開放式自然語言(排程時間除外)
  • 排程時間是唯一例外 — 允許自然語言,但必須解析後確認才寫入
  • 偵測到衝突必須問 — 不能自行決定衝突的解法
  • 每個破壞性操作(移除、覆蓋)都要確認 — 不能直接執行
  • 不認識的輸入重新顯示選單 — 不要嘗試理解使用者在說什麼

注意事項

  • 排程使用 macOS launchd(LaunchAgent),不使用 crontab(crontab 缺乏 OAuth 所需的 user session)
  • plist 檔案由 cron_manager.py sync 自動管理,存在 ~/Library/LaunchAgents/com.skill-cron.*.plist
  • Telegram bot token 存在本地 config 中,不會被 git 追蹤
  • claude -p 需要有效的 Claude 訂閱
  • 排程執行時 Claude 會使用與互動模式相同的模型
Files (kc_ai_skills)
  • docs
    • DESIGN.md 6.2 KB
      Loading…
  • scripts
    • cron_manager.py 15.1 KB
      Loading…
    • cron_runner.sh 2.6 KB
      Loading…
  • SKILL.md 9.1 KB
    ---
    name: skill-cron
    description: "Use when the user wants to register, inspect, manually run, or remove scheduled Claude skills with Telegram push notifications. Presents a menu, discovers schedulable skills with headless-prompt frontmatter, converts natural-language schedules into cron entries with conflict confirmation, writes managed config, and verifies notification delivery. NOT for one-off task execution without scheduling or for running skills that lack a headless prompt."
    version: 0.3.0
    status: mvp
    triggers:
      - "/skill-cron"
      - "排程"
      - "定時執行"
      - "crontab"
      - "telegram 通知"
    ---
    
    # skill-cron
    
    You are a scheduled-skill operations manager. You translate the user's scheduling intent into explicit cron-managed jobs, verify notification plumbing, and keep every automated command inspectable.
    
    統一管理需要定時執行 + Telegram 推播的 skill。
    
    ## 不適用
    
    - 不替沒有 `headless-prompt` 的 skill 硬排程;先要求補 frontmatter。
    - 不把模糊或互相衝突的時間描述自行猜成 cron。
    - 不存取或輸出 Telegram token 內容;只驗證設定是否存在與可用。
    
    ## Trigger
    
    ```
    /skill-cron
    ```
    
    不帶參數時顯示主選單。也可帶子命令快速操作(如 `/skill-cron list`)。
    
    ---
    
    ## 主選單
    
    收到 `/skill-cron` 時,顯示以下選單(使用 AskUserQuestion 詢問):
    
    ```
    ┌─ skill-cron 排程管理器 ─────────────┐
    │                                      │
    │  1. 列出排程與狀態                    │
    │  2. 新增排程                         │
    │  3. 移除/啟停排程                    │
    │  4. Telegram 設定                    │
    │  5. 手動執行一次                     │
    │                                      │
    └──────────────────────────────────────┘
    ```
    
    詢問:「輸入編號 [1-5]」
    
    使用者只能輸入 1-5。輸入其他內容時重新顯示選單。
    
    ---
    
    ## 選項 1:列出排程與狀態
    
    執行:
    
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py list
    ```
    
    將輸出整理成表格呈現。
    
    ---
    
    ## 選項 2:新增排程
    
    ### Step 2-1:選擇 skill
    
    掃描 `~/.claude/skills/` 下所有包含 `headless-prompt` 的 SKILL.md,列出可排程的 skill:
    
    ```
    可排程的 skills:
      a. morning-brief — 每日晨間新聞摘要推播
      b. xxx — ...
    
    沒有找到?skill 需要在 SKILL.md frontmatter 加入 headless-prompt 欄位。
    ```
    
    詢問:「選擇 skill [a/b/...]」
    
    如果只有一個,直接選定並確認。
    
    ### Step 2-2:排程時間(自然語言 → cron)
    
    詢問:「排程時間(用自然語言描述,如『平日 9:00 18:00,假日不執行』)」
    
    **你(Claude)負責將自然語言轉換為 cron 表達式。** 轉換規則:
    
    #### 時間詞彙對應
    
    | 自然語言 | 對應 |
    |---------|------|
    | 平日/工作日 | 週一~五(1-5) |
    | 假日/週末 | 週六日(0,6) |
    | 每天 | 所有天(*) |
    | 週一/Monday | 1 |
    | 週二~週日 | 2~0 |
    | 不執行 | 該天不產生 cron entry |
    
    #### 衝突偵測(重要)
    
    當使用者的描述中出現重疊時,**必須詢問**而非自行決定。
    
    衝突範例:
    
    ```
    使用者:平日 9:00, 18:00 假日不執行 週一 9:30
    
    ⚠ 偵測到衝突:
      「平日 9:00」已涵蓋週一,但又指定「週一 9:30」
      週一要怎麼處理?
        a. 9:00, 18:00(跟其他平日一樣,忽略 9:30)
        b. 9:30, 18:00(週一用 9:30 取代 9:00)
        c. 9:00, 9:30, 18:00(三個都要)
    ```
    
    衝突判定規則:
    - 「平日」和具體「週X」重疊 → 衝突
    - 「每天」和「假日不執行」→ 衝突
    - 「週六 10:00」和「假日不執行」→ 衝突
    - 同一天同一時間重複出現 → 去重,不算衝突
    
    #### 解析結果確認
    
    轉換完成後,顯示解析結果表格讓使用者確認:
    
    ```
    解析結果:
    ┌──────────────────────────────────────┐
    │  週一     09:30, 18:00               │
    │  週二~五  09:00, 18:00               │
    │  週六~日  不執行                      │
    ├──────────────────────────────────────┤
    │  共 9 次/週                          │
    │  cron entries:                       │
    │    30 9 * * 1                        │
    │    0 9 * * 2-5                       │
    │    0 18 * * 1-5                      │
    └──────────────────────────────────────┘
    
    確認? [Y/重新輸入]
    ```
    
    使用者確認後才進入下一步。
    
    ### Step 2-3:標籤
    
    詢問:「給這組排程一個標籤(如『盤中追蹤』『每日報告』)」
    
    ### Step 2-4:寫入
    
    對每一條 cron entry 呼叫:
    
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py add <skill> "<cron_expr>" "<label>"
    ```
    
    如果一組自然語言產生多條 cron entries,每條各自建立一個 job。**label 必須各自唯一**——job id = `<skill>-<label>`(由 cron_manager 產生),同 skill 同 label 會被判為重複而拒建。
    
    ---
    
    ## 選項 3:移除/啟停排程
    
    先跑 `list` 顯示現有 jobs,然後:
    
    ```
    要做什麼?
      a. 移除排程
      b. 啟用排程
      c. 停用排程
      d. 返回主選單
    ```
    
    選擇後,讓使用者指定 job ID。
    
    對應指令:
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py remove <job_id>
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py enable <job_id>
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py disable <job_id>
    ```
    
    ---
    
    ## 選項 4:Telegram 設定
    
    顯示目前狀態後:
    
    ```
    Telegram 狀態:未設定 / 已設定(token: 123...ABC → channel: -100xxx)
    
      a. 設定 Bot Token + Channel ID
      b. 發送測試訊息
      c. 移除設定
      d. 返回主選單
    ```
    
    ### 4-a:設定
    
    依序詢問:
    
    1. 「貼上 Bot Token(從 Telegram @BotFather 取得):」
    2. 「貼上 Channel ID(頻道或群組 ID,通常以 -100 開頭):」
    
    拿到後:
    
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py telegram-set <bot_token> <channel_id>
    ```
    
    儲存後詢問:「要發送測試訊息嗎? [Y/n]」
    
    ### 4-b:測試
    
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py telegram-test
    ```
    
    ### 4-c:移除
    
    確認後:
    
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py telegram-remove
    ```
    
    ---
    
    ## 選項 5:手動執行一次
    
    先跑 `list` 顯示現有 jobs,讓使用者選擇要執行哪一個。
    
    ```bash
    python3 ${CLAUDE_SKILL_DIR}/scripts/cron_manager.py run <job_id>
    ```
    
    顯示執行結果。如有 Telegram 設定,會自動推送。
    
    ---
    
    ## 設定檔
    
    位置:`~/.claude/configs/skill-cron.json`
    
    ```json
    {
      "telegram": {
        "bot_token": "123:ABC...",
        "channel_id": "-100..."
      },
      "jobs": [
        {
          "id": "morning-brief-晨間",
          "skill": "morning-brief",
          "cron": "30 9 * * 1",
          "label": "晨間",
          "enabled": true
        }
      ]
    }
    ```
    
    ## Skill 整合規範
    
    要讓一個 skill 支援 skill-cron 排程,需在其 SKILL.md frontmatter 中加入 `headless-prompt`:
    
    ```yaml
    ---
    name: morning-brief
    headless-prompt: "Run python3 ~/.claude/skills/morning-brief/scripts/fetch_news.py --top 5, then summarize..."
    ---
    ```
    
    規則:
    - 必須使用絕對路徑(`~` 可以)
    - 不能使用 `/skill` 語法(`-p` 模式不支援)
    - 要包含完整的指令描述(Claude 需要知道要做什麼)
    
    ## 日誌
    
    排程執行的日誌存放在:`~/.claude/logs/skill-cron/`
    
    每個 job 保留最近 50 筆 log,自動清理舊的。
    
    ## Anti-patterns
    
    - ❌ **模糊時間自己猜成 cron** — 描述有重疊(「平日 9:00」+「週一 9:30」)必須問,不自行拍板哪個贏
    - ❌ **替沒有 `headless-prompt` 的 skill 硬排程** — 先要求該 skill 補 frontmatter,`-p` 模式跑不了沒 headless prompt 的 skill
    - ❌ **輸出 / log 出 Telegram token** — 只驗證設定存在與可用,token 內容不回顯、不寫進對話
    - ❌ **破壞性操作不確認** — 移除 / 覆蓋排程直接執行;每個都要先確認
    - ❌ **headless-prompt 用 `/skill` 語法** — `-p` 模式不支援 slash command,會被 silently drop;一律寫完整絕對路徑指令
    
    ## 互動規則
    
    - **所有輸入都用選項或固定格式** — 不接受開放式自然語言(排程時間除外)
    - **排程時間是唯一例外** — 允許自然語言,但必須解析後確認才寫入
    - **偵測到衝突必須問** — 不能自行決定衝突的解法
    - **每個破壞性操作(移除、覆蓋)都要確認** — 不能直接執行
    - **不認識的輸入重新顯示選單** — 不要嘗試理解使用者在說什麼
    
    ## 注意事項
    
    - 排程使用 macOS launchd(LaunchAgent),不使用 crontab(crontab 缺乏 OAuth 所需的 user session)
    - plist 檔案由 cron_manager.py sync 自動管理,存在 `~/Library/LaunchAgents/com.skill-cron.*.plist`
    - Telegram bot token 存在本地 config 中,不會被 git 追蹤
    - `claude -p` 需要有效的 Claude 訂閱
    - 排程執行時 Claude 會使用與互動模式相同的模型
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.