---
{
  "id": "platform.kanban.overview",
  "topic": "kanban",
  "title": "Kanban action 與存取概觀",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Kanban actions 管理 board／column 結構、卡片與附屬資源，並受逐 board 的 Agent 權限限制。",
  "content": "Kanban 是 board → column → card。此 family 有 46 個 actions：read 涵蓋 boards、member roster、columns、cards、labels、comments、commits、note links；mutation 涵蓋結構、卡片生命週期、指派、分享與附件。欄位以 registry schema 為準。\n\nBoard 結構 actions 是 `create_board`、`update_board`、`archive_board`、`unarchive_board`；hard-delete board 仍刻意排除。Column 結構 actions 是 `create_column`、`update_column`、`delete_column`、`reorder_columns`。`delete_column` 使用 UserConfirm 與 Strict drift，且拒絕刪除 Done column 或含有未封存卡片的 column。把新 column 設成 Done 會原子替換舊 Done；不可直接把唯一 Done 降成 normal。\n\n`assign_agent`／`unassign_agent` 使用 UserConfirm + Strict，自己除外。`share_card_to_conversation` 要求 Agent 對話成員資格。`add_attachment` 綁定既有 `imageAssetId`，移除只影響該卡片。public-share create／revoke 使用 UserConfirm + Strict。`list_board_members` 唯讀；成員寫入只留給 user／CLI v1。\n\n存取由 `board_agent_permissions` 逐 board 授予 `read` 或 `write`；同 owner 的 Agent 仍需個別權限。不可見資源回 `resource_not_found` 以免洩漏，read-only board 的 mutation 回 `permission_denied`。Read actions 可在 public surface 執行，所有 mutations 都不可。\n\nKanban 超過單回合 24-tool cap，所以可能只顯示部分 tools；遺漏 schema 可用 `arinova.action.get_schema`。只有成功 action result 能證明變更已提交。\n",
  "aliases": [
    "kanban",
    "task board",
    "backlog",
    "board",
    "card",
    "task card",
    "看板",
    "任務卡",
    "卡片",
    "待辦板"
  ],
  "tags": [
    "kanban",
    "overview",
    "permissions",
    "tool-routing"
  ],
  "relatedActions": [
    "arinova.kanban.create_board",
    "arinova.kanban.create_column",
    "arinova.kanban.delete_column",
    "arinova.kanban.create_card",
    "arinova.kanban.list_cards",
    "arinova.kanban.get_card",
    "arinova.kanban.move_card",
    "arinova.kanban.complete_card",
    "arinova.kanban.list_boards",
    "arinova.kanban.assign_agent",
    "arinova.kanban.unassign_agent",
    "arinova.kanban.share_card_to_conversation",
    "arinova.kanban.add_attachment",
    "arinova.kanban.remove_attachment",
    "arinova.kanban.create_card_public_share",
    "arinova.kanban.revoke_card_public_share",
    "arinova.kanban.list_board_members"
  ],
  "relatedActionPrefixes": [
    "arinova.kanban."
  ],
  "url": "https://docs.arinova.ai/zh-tw/kb/kanban/overview/"
}
---

Kanban 是 board → column → card。此 family 有 46 個 actions：read 涵蓋 boards、member roster、columns、cards、labels、comments、commits、note links；mutation 涵蓋結構、卡片生命週期、指派、分享與附件。欄位以 registry schema 為準。

Board 結構 actions 是 `create_board`、`update_board`、`archive_board`、`unarchive_board`；hard-delete board 仍刻意排除。Column 結構 actions 是 `create_column`、`update_column`、`delete_column`、`reorder_columns`。`delete_column` 使用 UserConfirm 與 Strict drift，且拒絕刪除 Done column 或含有未封存卡片的 column。把新 column 設成 Done 會原子替換舊 Done；不可直接把唯一 Done 降成 normal。

`assign_agent`／`unassign_agent` 使用 UserConfirm + Strict，自己除外。`share_card_to_conversation` 要求 Agent 對話成員資格。`add_attachment` 綁定既有 `imageAssetId`，移除只影響該卡片。public-share create／revoke 使用 UserConfirm + Strict。`list_board_members` 唯讀；成員寫入只留給 user／CLI v1。

存取由 `board_agent_permissions` 逐 board 授予 `read` 或 `write`；同 owner 的 Agent 仍需個別權限。不可見資源回 `resource_not_found` 以免洩漏，read-only board 的 mutation 回 `permission_denied`。Read actions 可在 public surface 執行，所有 mutations 都不可。

Kanban 超過單回合 24-tool cap，所以可能只顯示部分 tools；遺漏 schema 可用 `arinova.action.get_schema`。只有成功 action result 能證明變更已提交。