---
{
  "id": "platform.kanban.comments",
  "topic": "kanban",
  "title": "Comment 作者、限制與安全",
  "locale": "zh-TW",
  "version": "2026-08-13",
  "summary": "Kanban comment 可由作者 Agent 或觸發 action 的 board owner 更新或刪除。",
  "content": "卡片 comment 的作者可能是 Agent 或 user，read response 會在可解析時帶 `authorName`。`get_comment`、`list_comments` 是可在 public surface 使用的 read actions；comment writes 不可。\n\nRuntime 的 `update_comment`、`delete_comment` 會在呼叫 Agent ID 等於儲存的 `author_id`，或 triggering user 是 board owner 時放行。非作者 Agent 若替其他 user 執行會回 `permission_denied`；只有 board membership 不足以管理留言。Action 仍同時要求即時 board Agent grant 與 triggering-user owner 邊界。\n\nComment content 上限 10,000 字元，超限回 `invalid_arguments`。`add_comment`、`update_comment` 不需確認；永久的 `delete_comment` 需要 UserConfirm + Strict drift。\n\n`update_comment` 將 `arguments.content` 標為 redacted，action telemetry 不保留正文。Knowledge examples 與 routing telemetry 不可放真實 comment 全文；應使用假內容，並以 action result 為真相。\n",
  "aliases": [
    "卡片留言",
    "comment 作者",
    "編輯留言",
    "刪除留言",
    "comment permission denied",
    "留言內容上限"
  ],
  "tags": [
    "kanban",
    "comment",
    "authorship",
    "redaction",
    "permission"
  ],
  "relatedActions": [
    "arinova.kanban.add_comment",
    "arinova.kanban.get_comment",
    "arinova.kanban.list_comments",
    "arinova.kanban.update_comment",
    "arinova.kanban.delete_comment"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/kanban/comments/"
}
---

卡片 comment 的作者可能是 Agent 或 user，read response 會在可解析時帶 `authorName`。`get_comment`、`list_comments` 是可在 public surface 使用的 read actions；comment writes 不可。

Runtime 的 `update_comment`、`delete_comment` 會在呼叫 Agent ID 等於儲存的 `author_id`，或 triggering user 是 board owner 時放行。非作者 Agent 若替其他 user 執行會回 `permission_denied`；只有 board membership 不足以管理留言。Action 仍同時要求即時 board Agent grant 與 triggering-user owner 邊界。

Comment content 上限 10,000 字元，超限回 `invalid_arguments`。`add_comment`、`update_comment` 不需確認；永久的 `delete_comment` 需要 UserConfirm + Strict drift。

`update_comment` 將 `arguments.content` 標為 redacted，action telemetry 不保留正文。Knowledge examples 與 routing telemetry 不可放真實 comment 全文；應使用假內容，並以 action result 為真相。