---
{
  "id": "platform.kanban.labels-commits-and-notes",
  "topic": "kanban",
  "title": "Labels、commit attachments 與 note links",
  "locale": "zh-TW",
  "version": "2026-07-24",
  "summary": "Label 受 board scope 限制，commit 使用受驗證的 hash 與 attachment ID，note link 則要求相同 owner。",
  "content": "Label 隸屬單一 board。`add_label_to_card` 只能掛卡片同 board 已存在的 label；跨 board 會回 `resource_not_found`。新 label 用 `create_label`，registry schema 要求 name 與 color，handler 要求 board write。`delete_label` 會從所有卡移除並需要 UserConfirm + Strict drift。\n\nAdd/remove label 與 link/unlink note 都是 idempotent、可逆且不需確認。被連結 note 必須屬於同 owner，否則回 `resource_not_found`。`list_card_notes` 與 `list_note_cards` 提供雙向查詢。\n\n`add_commit` 的 SHA 必須正好是 40 或 64 個 hex 字元。格式錯誤目前顯示 missing required `sha`，應檢查格式而非只判定漏欄位。`delete_commit` 使用 `list_commits` 回傳的 attachment row `commitId`，不是 SHA；刪除需要 UserConfirm + Strict drift。\n\nLabel、commit、note-link 操作只更新 board 畫面，不發 Trigger events。不可承諾以這些附件變更觸發自動化；應依 Kanban events 卡改用可用的 card lifecycle event。\n",
  "aliases": [
    "卡片標籤",
    "建立標籤",
    "commit 附件",
    "commitId",
    "git sha",
    "卡片連結筆記"
  ],
  "tags": [
    "kanban",
    "label",
    "commit",
    "note",
    "confirmation"
  ],
  "relatedActions": [
    "arinova.kanban.list_labels",
    "arinova.kanban.create_label",
    "arinova.kanban.add_label_to_card",
    "arinova.kanban.remove_label_from_card",
    "arinova.kanban.delete_label",
    "arinova.kanban.add_commit",
    "arinova.kanban.list_commits",
    "arinova.kanban.delete_commit",
    "arinova.kanban.link_note",
    "arinova.kanban.unlink_note",
    "arinova.kanban.list_card_notes",
    "arinova.kanban.list_note_cards"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/kanban/labels-commits-and-notes/"
}
---

Label 隸屬單一 board。`add_label_to_card` 只能掛卡片同 board 已存在的 label；跨 board 會回 `resource_not_found`。新 label 用 `create_label`，registry schema 要求 name 與 color，handler 要求 board write。`delete_label` 會從所有卡移除並需要 UserConfirm + Strict drift。

Add/remove label 與 link/unlink note 都是 idempotent、可逆且不需確認。被連結 note 必須屬於同 owner，否則回 `resource_not_found`。`list_card_notes` 與 `list_note_cards` 提供雙向查詢。

`add_commit` 的 SHA 必須正好是 40 或 64 個 hex 字元。格式錯誤目前顯示 missing required `sha`，應檢查格式而非只判定漏欄位。`delete_commit` 使用 `list_commits` 回傳的 attachment row `commitId`，不是 SHA；刪除需要 UserConfirm + Strict drift。

Label、commit、note-link 操作只更新 board 畫面，不發 Trigger events。不可承諾以這些附件變更觸發自動化；應依 Kanban events 卡改用可用的 card lifecycle event。