建立、更新、搬移、列出與搜尋卡片

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，不套用變更。

Related actions

arinova.kanban.create_card, arinova.kanban.update_card, arinova.kanban.move_card, arinova.kanban.list_cards, arinova.kanban.search_cards, arinova.kanban.delete_card

Also known as

建立任務卡, 更新卡片, 搬卡, 卡片排序, 跨看板搬卡, 搜尋未封存卡, card dry run

---

Machine-readable Markdown · Knowledge index