Jira 匯入

你的 Jira 議題,
交給你選的代理處理

衝刺是在 Jira 裡規劃的。分配給你的工單都在那裡,帶著規格說明、截圖和驗收標準。你想要的,是每一個都有一個代理在處理,就在你自己的機器上,用最適合這項任務的 CLI。

AgentsRoom 把這些議題匯入專案的 backlog,連同它們的描述、型別、標籤和附件。每個議題都變成一張工單,你把它交給 Claude Code、Codex、GitHub Copilot CLI、Cursor 或其他代理 CLI,一張工單一個代理。匯入唯讀取:任何內容都不會寫回 Jira。

從 Jira 到你的代理
Jira 專案
ACME
MOB
assignee = currentUser()
Backlog · TODO
ACME-412Claude Code
ACME-415Codex
MOB-88Cursor
唯讀:不寫回任何內容

兩個 Jira 專案,一個 JQL 查詢,一張工單一個代理:匯入讀取 Jira,從不寫入。

很多團隊在 Jira 裡規劃工作:backlog、衝刺、今天早上分給你的議題。而越來越多的工作,是在 Claude Code、Codex 和其他代理 CLI 裡完成的。兩者之間,常見的做法是複製貼上:把摘要貼進提示詞,再貼上描述,截圖在路上丟了。

Jira 匯入替你完成這一步。你用 Atlassian 信箱和一個 API 令牌連線你的 Jira Cloud 站點,選擇一個專案或寫一個 JQL 查詢,預覽議題,然後匯入。它們作為普通工單落到專案 backlog 的 TODO 列,描述已轉換成 Markdown,附件也已下載,你像對待其他任何工單一樣,在每張上啟動一個代理。

這不是雙向同步。AgentsRoom 只向 Jira 傳送讀取請求:不做狀態流轉,不留評論,不改任何欄位。如果你想讓代理評論某個議題,或者把它移到 Done,那是 Atlassian 自己的 MCP 伺服器要做的事,而且兩者可以配合使用,下文會說明。

Jira 匯入能做什麼

backlog 又多了一個來源,與 Linear、GitHub Issues 和 Notion 並列。

一個專案,或你自己的 JQL

從列表中選一個專案,查詢會自動替你填好;專案有幾十個時還有搜尋框。或者自己寫 JQL:assignee = currentUser()、某個衝刺、某個元件、某個標籤。只要 Jira 能搜尋到,匯入就能帶進來。

單個議題,按編號匯入

只需要剛分給你的那個議題?用 TODO 列的匯入按鈕貼上 PROJ-123 或 Jira 連結。它會單獨進來,放在列的頂部,不會動到已儲存的匯入。

可讀的描述

Jira 把描述存成結構化文件,而不是文字。匯入會把它們轉換成 Markdown(標題、列表、程式碼塊、表格、連結),這樣代理讀到的是寫出來時的規格說明,而不是原始資料。

代理打得開的附件

議題的附件要登入 Jira 才能看到,所以給代理一個連結毫無用處。匯入會把它們下載到你的電腦上,附到工單裡:截圖、PDF 規格說明、匯出檔案。

說得通的型別和狀態

Bug、Story、Task、Epic:已知的議題型別會對應到工單型別,Jira 型別還會保留為標籤,你們自己的叫法不會丟。狀態跟隨 Jira 在各個工作流程之間共用的狀態類別,所以 Done 的議題進來時就是已完成。

唯讀,令牌留在你的機器上

到達 Jira 的只有讀取請求。API 令牌在你的電腦上加密儲存,絕不會到達我們的伺服器;只有查詢會跟著專案去到你的其他機器,你在那裡再貼上一次令牌。

工作原理

四個步驟。前兩步每台機器只做一次。

  1. 1

    建立一個 API 令牌

    在你的 Atlassian 帳戶中開啟 Security,再進入 API tokens,建立一個令牌。要用經典令牌:帶作用域的令牌可能導致專案列表返回為空。

  2. 2

    連線你的 Jira 站點

    在專案的 backlog 中點選「匯入工單」,選擇 JIRA。輸入你的站點地址(只寫團隊名也可以)、Atlassian 信箱和令牌。

  3. 3

    選擇並預覽

    選一個專案或寫一個 JQL 查詢,然後點選「預覽」。按編號或標題搜尋列表,勾選你想要的議題並匯入,一次最多 500 個。

  4. 4

    把每張工單交給一個代理

    這些議題現在是 TODO 裡的工單,每張都帶有指回 Jira 的連結。分配一個代理和一個模型,如果想讓它有自己的分支,就勾選「為此任務在獨立的工作樹中編碼」,然後把工單拖到 In Progress。之後點「重新匯入」,看板就會重新同步。

Atlassian 和代理 CLI 本身已經能做什麼

Atlassian 為 Jira 和 Confluence 提供了一個官方遠端 MCP 伺服器,地址是 https://mcp.atlassian.com/v2/mcp,用 OAuth 登入。Atlassian 為 Claude Code 給出的文件是 claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp,再用 /mcp 登入;為 Codex 給出的是 codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp。之後代理就能在會話中使用工具來搜尋、讀取、建立和更新議題。

Jira 還允許你在經辦人欄位裡把工作項分配給一個代理:Atlassian 自己的 Rovo 代理,以及從其他平台連線進來的代理,比如 GitHub Copilot 和 Cursor。代理處理這個工作項,並在那裡報告進展,執行在承載它的平台上,而不是你電腦上的終端裡。

AgentsRoom 匯入滿足的是另一種需求:議題放在看板上,和你其餘的工單在一起,每個議題一個代理,在你自己的機器上,用你選的 CLI,包括那些完全沒有 Jira 整合的 CLI。兩者並不互斥:匯入議題來規劃和推進工作,當某個代理需要自己評論或流轉它的議題時,再給它 Atlassian 的 MCP 伺服器。

需要知道的事

  • 僅支援 Jira Cloud。不支援 Jira Server 和 Data Center。
  • 只有一個方向:任何內容都不會回到 Jira,即使這邊的工單已經交付。自己流轉議題,或者給代理 Atlassian 的 MCP 伺服器。
  • 令牌留在連線它的那台電腦上。在另一台機器上,看板按鈕會顯示「重新連線」,並帶有「JIRA 未連線」標記,直到你在那裡也貼上令牌。
  • 每次匯入最多 500 個議題,每個議題最多 10 個附件,每個 8 MB 以內。
  • 優先順序、經辦人、評論、元件、版本、史詩連結和故事點不會被匯入:工單帶的是摘要、描述、型別、標籤和檔案。
  • 連線 Jira 和編寫查詢都在桌面版完成。在手機上你可以重新匯入,或者按編號匯入單個議題;兩者都在你的電腦上執行,電腦必須開著。

常見問題

這和 Atlassian 的 MCP 伺服器是一回事嗎?

不是。Atlassian 的 MCP 伺服器在支援 MCP 的 CLI 上,給單個代理提供在會話內讀取和修改 Jira 的工具。AgentsRoom 匯入則在任何代理啟動之前,把議題放到專案的 backlog 上,這樣你可以規劃它們,把每一個交給不同的代理,並在看板上跟進。兩者可以一起用:匯入用來組織工作,MCP 伺服器給需要評論或關閉自己議題的代理。

代理完成後,AgentsRoom 會更新 Jira 議題嗎?

不會。匯入只傳送讀取請求:不做狀態流轉,不留評論,不改任何欄位。這邊的工單交付後,你自己在 Jira 裡移動議題,或者讓代理透過 Atlassian 的 MCP 伺服器去做。正因為只申請讀取權限,匯入才能適用於任何工作流程,不管它的流轉和條件是什麼樣的。

可以只匯入分配給我的議題嗎?

可以,用 JQL:assignee = currentUser() AND statusCategory != Done 會帶進你能看到的所有專案中你未完成的議題。加上 project = ABC、某個衝刺或某個標籤來縮小範圍。查詢會隨專案一起儲存,之後點「重新匯入」就會重放它。

可以只匯入剛分配給我的那個議題嗎?

可以。用 TODO 列的匯入按鈕,貼上它的編號(PROJ-123)或 Jira 連結。它會落到 TODO 的頂部,不會改動已儲存的匯入,之後還可以從工單上單獨重新整理它。

我的 Jira API 令牌會離開我的電腦嗎?

不會。它加密儲存在連線它的那台電腦上,絕不會到達我們的伺服器。你的帳戶裡只儲存匯入查詢(站點和 JQL),這樣匯入會跟著專案去到你的其他機器,你在那裡再貼上一次令牌即可。

哪些代理 CLI 可以處理匯入的 Jira 議題?

AgentsRoom 支援的全部 17 個代理 CLI(Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 13 個)。匯入的議題就是一張普通工單:它在你分配的代理和模型上執行,在共享檢出裡,或者在它自己的 git worktree 裡。

支援 Jira Server 或 Data Center 嗎?

目前不支援。匯入透過 Atlassian API 令牌與 Jira Cloud REST API 通訊,而 Jira Server 和 Data Center 並不以同樣的方式提供它。自託管 Jira 的使用者仍然可以給代理一個支援其安裝方式的 Jira MCP 伺服器。

你可能還會喜歡

把你的 Jira 議題交給你的代理

下載 AgentsRoom,把你的儲存庫作為專案開啟,然後在它的 backlog 中點選「匯入工單」,選擇 JIRA。

免費下載 AgentsRoom

配套應用:隨時隨地監控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

獲取擴充功能
Chrome Web Store

把 Bug 和需求直接傳送到您的公開待辦清單。

多專案管理
多供應商
多代理執行
即時狀態
檔案差異與提交
行動應用
即時預覽
代理團隊
瀏覽器自動化
Backlog 驅動開發
提示詞庫
技能庫
檢視所有功能