AI 代理

Linear

把 Linear issue 指派給 Comma，或在留言裡 @Comma。Comma 會在 issue 裡回答，把工作當成任務在你的工作區裡執行，並把進度與結果回報到 issue。

開始之前

• 一個 Comma 工作區，桌面 app 或 app.comma.surf 皆可。
• 你要使用 Comma 的那個 Linear 工作區裡的帳號。第一個在 Linear 工作區連接的人會把 Comma 安裝進去，這需要 Linear 工作區管理員；之後的人只需連結自己的帳號。
• 一個執行工作的地方：連到 Comma 的你自己的 Codex 或 Claude Code，或用 Comma 點數執行雲端 Worker。只在 issue 裡回答問題不需要 Worker。

連接 Linear

1. 在 Comma 裡開啟設定，進入訊息管道，在 Linear 卡片上按連接。
2. Linear 會請你以本人身分授權 Comma 讀取工作區，這一步讓 Comma 知道你是哪個 Linear 使用者。
3. 如果 Comma 尚未安裝到該 Linear 工作區，Linear 會再問一次：這一步把 Comma 作為 agent 安裝到你選的團隊。
4. 回到 Comma，卡片顯示已連接，並帶出 Linear 組織與你的帳號。

選擇 issue 如何執行

• 任務完成後。 issue 保持原狀；移到 In Review（團隊有這個狀態時才會移）；或移到 Done。

指派一個 issue

1. 在 Linear 裡把 issue 指派給 Comma，或在留言裡寫 @Comma 加上你的需求。
2. Comma 會在幾秒內於 issue 的 agent 工作階段裡回答。提問、分類、出方案都直接在那裡回答，不會開任務。
3. 當 issue 需要實際動手時，Comma 會開一個任務：issue 移到團隊的第一個「已開始」狀態（多數團隊叫 In Progress），已經開始或已關閉的不動；工作階段裡出現「Task in Comma」連結，Worker 的進度與結果會發到工作階段；Worker 開的 pull request 也會連結上。
4. 在工作階段裡回覆可以修正方向或追加需求；目前任務結束後，Comma 才會開新的任務。

停止或關閉

• 在工作階段裡按 Stop：正在執行的任務結束，已完成的部分保留。
• 把 issue 標為 Done 或 Canceled，或把它從 Comma 改派給別人：正在執行的任務結束，Comma 會在工作階段裡說明。已交付結果的任務不受影響。
• 刪除 issue：正在執行的任務結束，說明只寫在 Comma 裡的任務中；工作階段隨 issue 一起消失，那裡不會再有任何內容。

在 Comma 裡繼續

每個工作階段都有「Open in Comma」連結，每個被指派的任務都有「Task in Comma」連結。在 Comma 裡可以看完整紀錄、繼續工作，或審閱並驗收結果。你在 Comma 裡寫的內容只留在 Comma；只有 Comma 對 Linear 裡提問的回答會回到 issue。

管理或中斷連接

• 這些操作都在 Linear 卡片的「管理」選單裡。
• Linear 登入變了就「重新連接」，會先跳出確認框。
• 「中斷連接」只解除你自己的帳號連結，同事的不受影響。
• 「從組織移除」只對安裝了 Comma 的那個 Comma 工作區顯示；Linear 管理員也可以在 Linear 的設定 › Applications 裡移除。