skill-cron

Files (4)

• SKILL.md
• DESIGN.md · docs/
• cron_manager.py · scripts/
• cron_runner.sh · scripts/

SKILL.md (first lines)

# 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」和「假日不執行」→ 衝突
- 同一天同一時間重複出現 → 去重，不算衝突

#### 解析結果確認

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

```

From KerberosClaw/kc_ai_skills, MIT.

More from KerberosClaw/kc_ai_skills