---
{
  "id": "platform.kanban.events-and-automation",
  "topic": "kanban",
  "title": "Kanban events 與 Trigger automation 邊界",
  "locale": "zh-TW",
  "version": "2026-07-24",
  "summary": "卡片生命週期 mutations 只發固定的 Trigger events；archive 與附屬資源操作完全不發事件。",
  "content": "Kanban 對以下生命週期操作發 Trigger events：create → `card.created`；有內容變更且非搬移的 update → `card.updated`；delete → `card.deleted`；跨欄 update、move 或 complete → `card.moved`、`card.moved_into_column`、`card.moved_out_of_column`。搬移後若來源欄清空可再發 `column.cleared`；所有非 archived 卡都在 Done-type 欄時可發 `board.all_done`。\n\nArchive、unarchive、comment、label、commit attachment、note link 都不發 Trigger events。「卡片封存時執行」目前做不到，必須明說並提供可用替代，例如監聽 `card.moved`。\n\n「卡片移到 Done 就……」跨兩個 domains：Kanban 提供卡片操作，Trigger 提供事件監聽。`sourceScope` 與 lifecycle 應讀 `platform.trigger.events-and-scopes` 等 Trigger cards，不在本卡重複；本卡只負責 Kanban 發射邊界。\n\nAgent action 造成的變更也可能 match triggers。Runtime 會增加並保護 chain depth，因此需提醒 automation loop 風險，但不可虛構數值上限；實際 delivery、scope 與 action result 優先。\n",
  "aliases": [
    "Kanban trigger events",
    "卡片搬移自動化",
    "卡片移到 Done",
    "卡片封存觸發",
    "column cleared",
    "board all done"
  ],
  "tags": [
    "kanban",
    "trigger",
    "event",
    "automation"
  ],
  "relatedActions": [
    "arinova.kanban.create_card",
    "arinova.kanban.update_card",
    "arinova.kanban.move_card",
    "arinova.kanban.complete_card",
    "arinova.kanban.delete_card",
    "arinova.trigger.create_trigger",
    "arinova.trigger.update_trigger"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/kanban/events-and-automation/"
}
---

Kanban 對以下生命週期操作發 Trigger events：create → `card.created`；有內容變更且非搬移的 update → `card.updated`；delete → `card.deleted`；跨欄 update、move 或 complete → `card.moved`、`card.moved_into_column`、`card.moved_out_of_column`。搬移後若來源欄清空可再發 `column.cleared`；所有非 archived 卡都在 Done-type 欄時可發 `board.all_done`。

Archive、unarchive、comment、label、commit attachment、note link 都不發 Trigger events。「卡片封存時執行」目前做不到，必須明說並提供可用替代，例如監聽 `card.moved`。

「卡片移到 Done 就……」跨兩個 domains：Kanban 提供卡片操作，Trigger 提供事件監聽。`sourceScope` 與 lifecycle 應讀 `platform.trigger.events-and-scopes` 等 Trigger cards，不在本卡重複；本卡只負責 Kanban 發射邊界。

Agent action 造成的變更也可能 match triggers。Runtime 會增加並保護 chain depth，因此需提醒 automation loop 風險，但不可虛構數值上限；實際 delivery、scope 與 action result 優先。