# 自動化端點

排程執行的端點。

Cron 與一次性任務合併為同一組介面。原本分離的 `/v1/cron*` 與 `/v1/task*` 已於 v0.33.6 由 `/v1/schedule` 取代，以 `type=cron|task` 區分。

| Method | 路徑 | 說明 |
|---|---|---|
| `GET` | `/v1/schedule` | **local** — 將 cron 條目與一次性任務合併成一個 `schedules` 陣列，各自標記 `type=cron\|task`；`?type=` 可只取其一 |
| `GET` | `/v1/schedule/*skill` | **local** — 讀取 scheduler skill：`name` 與 `body`，其中 `body` 自 v1.0.2 起是**含 frontmatter 的原始** SKILL.md，不再是解析掉 frontmatter 的主體。`files` 以與 `GET /v1/skill/*name` 相同的規則附上該 skill 的 `scripts/`／`references/`／`assets/` 內容。`description` 欄位已移除 |
| `POST` `PATCH` | `/v1/schedule` | **local** — 以 `name` / `content` 建立或更新 scheduler skill，並把整組條目重新綁到 `type=cron\|task`；切換 type 會丟棄該 skill 在另一種型別下持有的條目。`description` 已於 v1.0.2 移除。`content` 若本身就以 `---` frontmatter 開頭則原樣寫入；否則由 server 端補上最小的 `---\nname: <name>\n---` 標頭 |
| `DELETE` | `/v1/schedule` | **local** — 刪除某 skill 的條目（`type` 可縮限其一，省略則兩者皆移除）；若無其他綁定則一併把 skill 移入垃圾桶 |
| `POST` | `/v1/schedule/run` | **local** — 立即觸發一則排程（`202 Accepted`） |