Scheduler Skill Creator

本 Skill 為 Agenvoy 內部最佳化版本，依 Agenvoy 的執行環境撰寫（run_command 的 CWD、~/.config/agenvoy/skills/.system/ 安裝位置、edit_skill／schedules／find_edit_tool 等工具、subagent 與排程的觸發路徑），不保證適配其他 AI harness。

Scheduler Skill 建立器

目的

scheduler 採 skill-based 觸發：到時間時，daemon 讀 scheduler/<short>/SKILL.md body 並起 in-process subagent 跑（always-allow）。本 skill 的職責 = 「從使用者意圖建出 skill 並綁定時間」，完整跑完 6 步即完成排程。

重要：scheduler 用 skill 與一般 skill 隔離

成功標準

• 生成檔案: ~/.config/agenvoy/skills/scheduler/<short>-<hash8>/SKILL.md，frontmatter name: <short>-<hash8>（無前綴）
• skill body 描述任務行為、引用具體 tool
• 呼叫 schedules(mode=write, target=task, time, skill_name=<short>-<hash8>) 或 schedules(mode=write, target=cron, time, skill_name=<short>-<hash8>) 綁定時間成功
• 回報生成位置、full name（含 hash）、排程類型（one-shot／recurring）、下次觸發時間

步驟

0. 時間檢查門檻（強制首動作）

在呼叫任何其他 tool（特別是 run_command 跑 init script）之前，先檢查使用者訊息是否含明確時間 token。時間 token 定義：

判定流程（兩個 yes／no 各自獨立檢查；缺項一律走 ask_user tool call）：

1. 任務 token 存在？（訊息含可執行動作描述）
   • 否 → 呼叫 ask_user tool：{"questions":[{"question":"要做什麼？例：抓 HN 頭條 / 提醒我喝水"}]}
2. 時間 token 存在？（上表任一）
   • 否 → 呼叫 ask_user tool：{"questions":[{"question":"什麼時候執行？例：5 分鐘後 / 每 5 分鐘 / 明天 9 點"}]}

兩項都缺時，同一個 ask_user 的 questions 帶兩題送出。收到回傳的 answers 後，把答案併入原訊息重跑步驟 0；兩者都齊才進步驟 1。

問題一律用 ask_user tool call 送出：ask_user 走 pending.Ask 阻塞等待 reply，harness 開 popup／prompt 收答案，agent 收到結構化 answers 後接著執行。TUI／CLI／Web／Telegram／Discord 都支援；只有 chat completions 端點沒有這個通道。

需要補問的例子：

時間以使用者說的為準：沒說就用 ask_user 問，不用預設值（+10m、09:00）或推測補齊。

1. 解析需求

步驟 0 通過後（任務與時間都齊全），抽兩元素：

• 任務：要做什麼（行為描述）
• 時間：何時觸發

範例解析：

缺項一律以 ask_user tool call 補齊；questions 是 array，當下所有缺項寫成多題一起送。

2. 時間正規化 + 選 tool

決定走 schedules(mode=write) target=task（一次性）或 target=cron（週期）。

3. 初始化 skill 目錄（強制走 init 腳本）

腳本路徑：run_command 的 CWD 是使用者的工作目錄，不是本 skill 目錄，相對路徑 scripts/... 必定找不到（實測會讓 agent 反覆 glob 找檔案，白燒數輪）。本 skill 只服務 Agenvoy、安裝位置固定，一律用絕對路徑 ~/.config/agenvoy/skills/.system/scheduler-skill-creator/scripts/。

禁止直接用 edit_skill(mode=write)／edit_file(mode=write) 建立 SKILL.md —— LLM 容易寫成 <short>.md 而非 <short>/SKILL.md，或誤加 scheduler- 前綴；也無法自行產生 hash suffix。必須先跑 init 腳本。

用 run_command 執行：

python3 ~/.config/agenvoy/skills/.system/scheduler-skill-creator/scripts/init_scheduler_skill.py <short-name>

<short-name> 由步驟 1 的任務描述推導（kebab-case、不含 scheduler- 前綴、不含 hash）。腳本會：

• 正規化 short name（lowercase、hyphen-case）
• 產生 8-char hex random suffix（secrets.token_hex(4)），組成 full name <short>-<hash8>
• 建立 ~/.config/agenvoy/skills/scheduler/<short>-<hash8>/SKILL.md，寫入含 frontmatter name: <short>-<hash8> 的 TODO 模板

捕捉 full name：stdout 會印一行 [OK] skill name: <short>-<hash8>，完整字串（含 hash）是後續步驟 4／5 要用的 skill_name。極罕見 hash 碰撞時印 [ERROR] collision exit 1，重跑一次即可。

重綁定既有 skill 的時間（user 說「把那個 X 改成 Y」）：不再跑 init 腳本，直接用既存 full name 進步驟 5；既存 full name 可從先前回報訊息找，或 find_files(mode=list) 列出 ~/.config/agenvoy/skills/scheduler/ 選擇。

4. 建構 skill 內容（委派 /skill-creator）

目錄與名稱在步驟 3 已經定案，這一步只做內容。呼叫 /skill-creator，用它的「編輯現有 Skill」路徑填內容，不要在這裡自己重寫一套設計流程。

/skill-creator 編輯現有 skill：~/.config/agenvoy/skills/scheduler/<short>-<hash8>/
任務：<步驟 1 收集到的行為細節>

交給 /skill-creator 的部分（照它的步驟走）：

這裡的額外約束（/skill-creator 不知道排程的規則，必須由你把關）：

• 不准跑 init_skill.py（它會用自己的命名規則在 skills/ 底下另開一個目錄）。目錄已存在，走「編輯現有 Skill」路徑
• 不准改名、不准搬位置 —— 名稱固定 <short>-<hash8>，位置固定 ~/.config/agenvoy/skills/scheduler/<short>-<hash8>/
• 不准跑步驟五（打包） —— 排程 skill 不外流
• body 引用的 skill／tool 必須確認存在：skill 以 system prompt 的 ## Skills 清單為準（那份清單已在 context 裡，不要用 run_skill activate 驗證 —— 每次 activate 都是一輪往返加一整份 SKILL.md 進 context）；tool 名稱以 find_edit_tool(mode=search) 的回傳為準。觸發時 subagent 找不到會直接 abort，使用者拿不到結果也看不到原因
• scripts/ 寫進 scheduler/<short>-<hash8>/scripts/，不用 edit_tool 產全域工具

必填欄位：

• description: ← 步驟 1 的「一句話描述」
• ## 任務 ← 步驟 1 的「行為細節」，引用已確認存在的 skill／tool
• ## 輸出格式 ← 期望輸出形式

禁止在 skill body 內加任何「推送到 channel」「呼叫 http_request 給 Discord」「呼叫 MCP discord tool」之類的 notify 指令 —— scheduler 觸發後 runtime 自動把輸出送回原 caller channel（Discord 來源送回原頻道、CLI／HTTP 來源送回 action.log）。Skill body 只需專注產出任務結果文字。