Community寫作與編輯github.com

Ticket Fetcher

僅擷取(不分析、不規劃)票務工具中的工作項目,輸出獨立且完整的 .TICKET.md 檔案。

Ticket Fetcher 是什麼?

Ticket Fetcher 是一個專為 AI 編碼代理設計的最小化技能,專注於從 Azure DevOps、Jira、GitHub Issues 等多個專案管理工具中「僅擷取」票務內容。它不接受任何分析、需求探索或規劃工作。它的輸出是一個完全自包含的 .TICKET.md 檔案,包含完整的欄位、備註、附件和相關票務鏈接。該技能會自動識別票務來源(基於 URL 主機或 ID 格式),使用對應的 MCP 伺服器(如 Azure DevOps MCP、Atlassian MCP、GitHub MCP)進行取回。如果無法使用 MCP,它會嘗試以公開 URL 備份方式抓取,若失敗則要求使用者安裝並認證合適的 MCP 伺服器。擷取下來的票務會以結構化的 Markdown 格式儲存,包含元資料標頭、描述、驗收標準、備註、相關票務清單、下載的附件(含圖片嵌入)以及設計參考(如 Figma)。它永遠不會覆蓋現有目錄,而是透過增加版本尾碼(-v2、-v3)來處理重複。完成後,它會輸出一個可複製貼上的啟動指令,以便在另一個代理階段中進行後續的 refine 工作。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add FrancescoBorzi/agent-toolkit

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

attachment-1
figma-<nodeId>

說明文件

Ticket Fetcher 是做什麼的?

僅擷取——不含分析、需求或規劃。輸出是一個自包含的 .TICKET.md。

來源與存取

從輸入(URL 主機或 ID 形狀)識別追蹤器,並透過相符的 MCP 伺服器擷取——例如 Azure DevOps MCP 用於 ADO 工作項目、Atlassian MCP 用於 Jira 問題、GitHub MCP / gh 用於 GitHub 問題。使用任何已連接的等效工具;工具名稱前綴因配置而異。一次解析出 MCP 所需的任何控制代碼(例如 Atlassian cloudId、ADO 專案)並重複使用。如果輸入有歧義,詢問使用者——不要猜測。如果沒有連接相符的 MCP:公開票務可能從其 URL 抓取作為備份(當相符的 MCP 能做得更好時,您仍可以建議安裝它);私人票務則無法抓取——URL 會回傳登入頁面,而非票務——因此請停止並告知使用者安裝並認證相符的 MCP 伺服器,然後重新執行。

您的任務

  1. 解析輸入。 接受完整的票務 URL 或純 ID/金鑰;提取識別碼。如果追蹤器使用金鑰前綴(例如 XX-1234),保留它;否則使用純數字。如果輸入無法識別,詢問。
  2. 擷取票務。 取得工作項目/問題,包含完整欄位集、內嵌備註以及展開的相關鏈結/關係。捕捉票務攜帶的所有內容——不要預先過濾成固定的欄位集。將您獲得的任何豐富文字格式(HTML、ADF 等)轉換為乾淨的 Markdown。
  3. 挑選一個簡稱。 從標題/摘要中取出簡短的 kebab-case 簡稱,3–5 個單詞——可 grep 搜尋,不要想太多。
  4. 決定輸出目錄。 在專案的規劃目錄(例如 .claude/plans/)內建立一個專案相對的 <id>-<slug>/ 子目錄——遵循專案/使用者的規劃目錄慣例;如果未定義,詢問使用者。切勿猜測。如果已存在,建議 <id>-<slug>-v2、-v3 等——永遠不要覆寫現有的規劃目錄;每次重新擷取的歷史記錄是有意保留的。
  5. 寫入票務檔案 至 <output-dir>/<id>-<slug>.TICKET.md。
  6. 下載附件 到輸出目錄中;對任何失敗的附件發出警告(請參閱「附件」)。
  7. 輸出結果——專案相對路徑以及下一步行(請參閱「下一步」)。

票務檔案結構

必須獨立存在:一個完整、可讀取的票務版本,包含足夠的元資料,讓全新的工作階段無需重新擷取即可識別來源。

標頭

純 Markdown 標頭,包含來源元資料;省略任何值為空的行。包含追蹤器提供的所有內容。範例:

# <標題/摘要>

> **來源** [<id>](<url>)
> **類型** {type}
> **狀態** {status}
> **負責人** {display name 或 "—"}
> **報告者/建立者** {display name}
> **標籤/標記** {joined 或 "—"}
> **擷取時間** {today YYYY-MM-DD}

主體區段

按此順序輸出,僅當存在且非空時:

  1. ## 說明
  2. ## 驗收標準——如果追蹤器有專用且已填入的 AC 欄位
  3. ## <其他欄位>——每個其他包含實際內容的已填入欄位(技術備註、自訂欄位等)各一個區段,標題為該欄位的顯示名稱。捕捉票務包含的所有內容。
  4. ## 備註——最早的在前,每個 ### <作者> — <日期>,接著是內容。盡力而為:如果備註未回傳,簡短說明或省略該區段。
  5. ## 相關票務——請參閱下方
  6. ## 附件——請參閱下方
  7. ## 設計參考——請參閱下方

保留標題層級、項目符號結構、強調和程式碼區塊;將欄位內的子標題對應到 ####。省略空區段。逐字引用使用者面向的字串、程式碼識別碼、檔案路徑、i18n 金鑰和 URL——永遠不要修改或翻譯它們。

相關票務

從回應的鏈結/關係(以及任何遠端鏈結工具)中,對於每個唯一的已鏈結票務(不包括此票務),僅透過低成本呼叫擷取標題 + 狀態 + 類型——而不是完整內容。主要目標是留下所有相關票務的追蹤,以便日後需要時可以擷取它們。每個一條項目符號,並附上關係(如果可用):

- [<id>](<url>) — (<type>, <status>) <title>

對於非票務的遠端鏈結(例如 wiki/Confluence 頁面),以純項目符號輸出標題和 URL。如果擷取失敗,列出鏈結並加上 (無法擷取),而不是讓整個執行失敗。

附件

識別每個附件以及說明/欄位中引用的每個內嵌圖片,按照首次出現的順序編號為 attachment-<N>.<ext>,保留原始副檔名。<N> 在兩者組合中連續編號。

始終嘗試擷取——跨越每個連接的 MCP。 除了追蹤器託管的附件外,票務可能鏈結外部資產(例如 Confluence/ADO 資源——對於設計工具鏈結如 Figma 或 Zeplin,請參閱下方的「設計參考」),這些資產可透過其自己的 MCP 存取,包括已鏈結 git 儲存庫中的規格/文件檔案(透過 git 或儲存庫 MCP 擷取其內容,以它們自己的檔案名稱儲存到輸出目錄中)。使用適合來源的任何 MCP 來拉取它們;不要預先宣告一個鏈結為無法擷取。如果合適的 MCP 已連接但未認證,不要默默跳過——主動執行其認證流程(顯示登入 URL,完成握手),無需等待被要求,然後擷取。當不清楚某個資產是否可以或應該下載時,詢問使用者。

將每個直接下載到磁碟——curl -fSL <url> -o attachment-<N>.<ext>,或 MCP 附件工具的 save-to-path 變體。永遠不要將附件作為內嵌 base64 透過模型路由並重新發出:輸出上限(約 100k 字元)會靜默截斷它——有效的標頭,缺少結尾,無法開啟。某些附件 MCP 工具僅回傳base64,沒有 save-to-path 選項(例如 ADO wit_get_work_item_attachment)——不要將它們用於二進位檔案;改為從追蹤器的 REST API 直接使用 bearer token 下載到磁碟(ADO:az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query accessToken -o tsv,然後 curl -H "Authorization: Bearer <token>" "<attachmentUrl>" -o attachment-<N>.<ext>)。(內容 URL 通常與 MCP 共享認證;在收到 401 時,如果可取得,則使用追蹤器的 bearer token 重試。)

驗證完整性,而不僅僅是傳輸——非空;符合傳送的 Content-Length;類型結尾存在(PNG IEND、JPEG FFD9、PDF %%EOF)。一個大小是 3 的倍數且接近整數字元邊界的大小,表示 base64 截斷。失敗時,重新下載到磁碟;如果仍然有問題,將其視為未下載並發出警告——永遠不要引用損毀的檔案。然後,對於每個檔案:

  • 已下載 → 引用本地檔案。
  • 未下載(沒有合適的 MCP/附件工具、無法完成的認證等)→ 仍然引用本地檔案和來源 URL,並將其加入要警告的清單。不要阻塞——無論如何票務都是可用的。

圖片 → 嵌入;非圖片(PDF、.docx 等)→ 改為連結:

### 附件 1

![attachment-1](attachment-1.png)
_原始檔案名稱:image.png_

### 附件 2

[attachment-2.pdf](attachment-2.pdf) — _原始檔案名稱:design-spec.pdf_

對於無法下載的檔案,附加其來源,以便使用者可以手動擷取:— 未下載;請從 <url> 取得並儲存於此為 attachment-<N>.<ext>。

設計參考

對於說明/備註中的設計工具鏈結(Figma、Zeplin、Sketch、Adobe XD 等),不要將它們編號為 attachment-<N>——它們是活的參考,不是附加的檔案。透過該工具的 MCP(例如 Figma MCP get_screenshot)捕捉每個被引用的影格/畫面,將回傳的短期 URL 直接下載到磁碟,儲存為 <tool>-<id>-<slug>.png(如果需要,先認證其 MCP——請參閱「附件」)。如果沒有連接該工具的 MCP,仍然記錄該條目,包含其名稱和來源 URL,並將其加入警告清單——與未下載的附件相同。每個鏈結記錄一個條目,包含本地預覽以及重新在該工具中開啟所需的識別碼:

### <設計名稱>

![figma-<nodeId>](figma-<nodeId>-<slug>.png)
_Figma · 檔案 `<fileKey>` · 節點 `<nodeId>` · [來源](<url>)_

界限

  • 不要分析、規劃或探索程式碼庫以取得上下文——這不豁免票務明確鏈結的檔案,您仍然要擷取這些檔案(請參閱「附件」)。
  • 不要在追蹤器中修改票務——擷取是唯讀的(沒有備註、轉換、編輯、工作日誌)。
  • 您唯一建立的檔案:.TICKET.md、其附件以及您擷取到的任何鏈結文件。

下一步

完成時清楚說明,使用專案相對路徑(永遠不要使用絕對路徑):輸出目錄、票務檔案以及任何附件。如果有任何附件無法下載,首先發出明確警告,列出每個遺失的 attachment-<N>.<ext> 及其來源 URL,指示使用者下載它並以該確切名稱儲存,以便嵌入能解析。然後將下一階段移交為一個單一可複製貼上的啟動指令——工作階段名稱和提示結合在一起,因此一次貼上即可啟動工作階段。使用正在使用的代理工具的啟動語法(與供應商無關——下面的 claude 僅是範例),將工作階段命名為 refine-<slug>:

claude --name refine-<slug> "/refine-ticket <output-dir>/<id>-<slug>.TICKET.md"

然後提供替代方案——清除目前工作階段(與供應商無關——下面的 /clear 僅是範例;使用正在使用的代理工具的清除指令):

或者執行 /clear 並執行:

/refine-ticket <output-dir>/<id>-<slug>.TICKET.md

相關技能