建立與管理工單

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

建立工單

透過介面

在工作區側邊欄中點擊工單。
按新增工單。
填寫：
- 標題 —— 簡短摘要。這是唯一必填的欄位。
- 描述 —— 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。介面的狀態選擇器列出除 failed 以外的每一個狀態 —— 代理會用 fail_ticket 標記該狀態。

如要變更狀態，可使用以下任何一種方式：

工單屬性欄中的狀態列，
清單中工單右鍵選單上的狀態子選單，
多選工單後，浮動欄上的狀態按鈕。

狀態變更會發出領域事件（TicketStatusChanged、TicketCompleted 等），這些事件可以觸發管線。參見設定管線觸發器。

指派工單

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

新增標籤

標籤是從工單清單批量套用的，而不是在單張工單上 —— 屬性欄中沒有任何標籤控制項。

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

連結工單

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

開啟工單，找到關聯卡片。
按其新增控制項，然後選擇關係：

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

選擇目標工單。

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

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

新增協作者

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

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

三種角色分別是 assignee、collaborator（預設）和 reviewer。介面中的選擇器只列出工作區代理，而且一律寫入預設角色；人員可以作為列出現，但不會在該選單中提供。MCP 的 add_ticket_collaborator 工具接受一個 role。

新增協作者會寫入一列記錄，但不會發佈任何領域事件；它也不授予任何空間存取權限。要把代理帶進某段對話，請改為從空間頂部把它新增為參與者 —— 參見空間。

刪除工單

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