---
{
  "id": "platform.kanban.cards-create-update-and-move",
  "topic": "kanban",
  "title": "建立、更新、搬移、列出與搜尋卡片",
  "locale": "zh-TW",
  "version": "2026-08-13",
  "summary": "卡片 actions 採 board-local 解析、頂部插入與 patch 更新，普通讀取只顯示未封存卡。",
  "content": "`create_card` 只要求 `title`；省略 board/column 時套用既定 defaults，因此落點非 explicit 時要確認並揭露解析結果。Priority 預設 `medium`。新卡以 `sort_order = 0` 插在欄頂並把其他卡後移，呼叫 Agent 會記入 authorship metadata，但不改變權限。Action 沒有同欄 position/reorder 參數，精細排序只能在 UI 拖拉。\n\n`update_card` 是欄位級 patch：省略欄位維持原值，也可一次改欄位並搬欄。`move_card` 委派同一套 update 行為；schema 雖只 required `cardId`，runtime 仍要求至少提供 `columnId` 或 `columnName`。\n\n目的 column 一律在卡片目前 board 內解析，所以不支援跨 board 搬移。跨板需求應在目的板建立新卡，再於使用者確認後刪除舊卡；不可聲稱 `move_card` 能跨板。\n\n`list_cards` 適合 board/column 掃描、substring filter 與 pagination，並排除 archived；`search_cards` 做 title/description substring 搜尋、不支援 wildcard，也會排除 archived。直接 `get_card` 對 archived 卡回 not found；需要歷史卡片時應使用封存專用 UI/API。Mutations 支援 `dry_run`，只回 resolved resources 與 `wouldRequireConfirmation`，不套用變更。\n",
  "aliases": [
    "建立任務卡",
    "更新卡片",
    "搬卡",
    "卡片排序",
    "跨看板搬卡",
    "搜尋未封存卡",
    "card dry run"
  ],
  "tags": [
    "kanban",
    "card",
    "create",
    "move",
    "search"
  ],
  "relatedActions": [
    "arinova.kanban.create_card",
    "arinova.kanban.update_card",
    "arinova.kanban.move_card",
    "arinova.kanban.list_cards",
    "arinova.kanban.search_cards",
    "arinova.kanban.delete_card"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/kanban/cards-create-update-and-move/"
}
---

`create_card` 只要求 `title`；省略 board/column 時套用既定 defaults，因此落點非 explicit 時要確認並揭露解析結果。Priority 預設 `medium`。新卡以 `sort_order = 0` 插在欄頂並把其他卡後移，呼叫 Agent 會記入 authorship metadata，但不改變權限。Action 沒有同欄 position/reorder 參數，精細排序只能在 UI 拖拉。

`update_card` 是欄位級 patch：省略欄位維持原值，也可一次改欄位並搬欄。`move_card` 委派同一套 update 行為；schema 雖只 required `cardId`，runtime 仍要求至少提供 `columnId` 或 `columnName`。

目的 column 一律在卡片目前 board 內解析，所以不支援跨 board 搬移。跨板需求應在目的板建立新卡，再於使用者確認後刪除舊卡；不可聲稱 `move_card` 能跨板。

`list_cards` 適合 board/column 掃描、substring filter 與 pagination，並排除 archived；`search_cards` 做 title/description substring 搜尋、不支援 wildcard，也會排除 archived。直接 `get_card` 對 archived 卡回 not found；需要歷史卡片時應使用封存專用 UI/API。Mutations 支援 `dry_run`，只回 resolved resources 與 `wouldRequireConfirmation`，不套用變更。