建立與管理工單

本指南說明如何建立與管理工單。

建立工單

透過 UI

在工作區側邊欄中點擊工單。
按下新增工單。
填寫：
- 標題 —— 簡短摘要。這是唯一必填的欄位。
- 描述 —— Markdown，附有格式工具列。
- 狀態 —— 待辦（預設）或待處理。已啟動與終止狀態是透過生命週期到達，而不是在建立時設定。
- 優先順序 —— 無、緊急、高、中或低。
- 負責人 —— 你自己，或工作區中的任何代理。
- 專案 —— 選填的分組。
按下建立，或先開啟建立更多，讓對話方塊保持開啟以便快速連續輸入。

對話方塊中沒有供應商選擇器。工單會建立到工作區目前生效的工單供應商上。

透過代理

在空間中請代理：

為慢速連線上的登入逾時問題建立一張工單。

它會呼叫 create_ticket MCP 工具。該工具上的優先順序是整數，而不是名稱：

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

值	優先順序
`0`	無
`1`	緊急
`2`	高
`3`	中
`4`	低

只有 workspace_id 和 title 是必填的；description、priority、 assignee（代理 id）和 team_id 都是選填的。該工具被歸類為供應商同步寫入，執行前會請求你核准。

更新工單狀態

工單遵循以下生命週期：

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done、failed 和 cancelled 是終止狀態。cancelled 可以從任何非終止狀態到達。done 和 failed 可以從 inProgress 或 inReview 到達；open 也可以直接移至 blocked。UI 的狀態選擇器會列出除 failed 以外的每個狀態 —— 該狀態由代理透過 fail_ticket 標示。

若要變更狀態，可以使用下列任一方式：

工單屬性欄中的狀態列，
清單中工單右鍵選單裡的狀態子選單，
多選工單後浮動工具列上的狀態晶片。

狀態變更會發出領域事件（TicketStatusChanged、TicketCompleted 等），可用來觸發管線。請參閱設定管線觸發器。

指派工單

開啟該工單。
在屬性欄中設定負責人 —— 你自己、另一位工作區成員，或一個代理。

新增標籤

標籤是從工單清單批次套用，而不是在單張工單上 —— 屬性欄裡沒有標籤控制項。

將游標停在工單清單中的某一列上，並勾選它的核取方塊。按需要勾選任意多列；一旦有項目被選取，就會出現一條浮動工具列。
在該工具列中，開啟標籤晶片。
選擇一個標籤。它會加到每一張尚無該標籤的選取工單上；現有標籤絕不會被清除。清除標籤會移除全部標籤。選擇器列出的是工作區中已出現在某張工單上的標籤。代理可以透過 update_ticket 或 tickets.patch 新增名稱。

連結工單

關聯關係位於屬性欄中工單的關聯卡片上，或清單右鍵選單的關聯至之下。

開啟該工單，找到關聯卡片。
按下它的新增控制項，選擇關係：

關係	意義
子 issue…	這張工單的父項是另一張
父 issue…	另一張工單是這張的子項
被阻擋…	這張工單被另一張阻擋
阻擋…	這張工單阻擋另一張
相關…	對稱關係，不隱含方向
重複於…	這張工單是另一張的重複項

選擇目標工單。

被重複會出現在卡片中，但不會出現在選擇器裡 —— 它是重複於… 的反向關係，並從另一張工單設定。列出的每個關係都可點擊以開啟被連結的工單，並可在游標停留時移除。

父項與子 issue 關係儲存在工單本身，而不是作為連結資料列，因此刪除一張父工單會串聯到它的子工單（見下文），而阻擋與相關連結則不會。

新增協作者

協作者是工單上的一份名冊 —— 記錄誰參與其中、以什麼身分參與。

開啟該工單。
按下新增協作者卡片上的人形加號控制項。
選擇一個代理。

這三種角色是 負責人、協作者（預設）和 審查者。 UI 的選擇器只列出工作區代理，並且一律寫入預設角色；人員可以作為資料列出現，但不會在該選單中提供。MCP 的 add_ticket_collaborator 工具接受一個 role。

新增協作者會寫入一筆資料列，但不會發布任何領域事件；它也不授予任何空間存取權。要把代理帶進某段對話，請改從空間標頭將它新增為參與者 —— 參閱空間。

刪除工單

使用屬性欄底部的刪除工單、右鍵選單，或多選後浮動工具列上的刪除動作。