技能包

IDD Skill：議題驅動開發工作流範本

最適合讓 AI 編程代理在自己的 Git 儲存庫裡跑通從認領議題到合併 PR 的完整開發循環；使用前需備妥 git、已認證的 gh CLI、jq 和 curl，並確認預設的全自動合併策略符合團隊規範。

官方來源 · IDD Skill

安裝

Import and onboard github:kurone-kito/idd-skill's IDD into this repository.

適合誰

  • 在自己的 Git 儲存庫裡推進日常開發、希望把「從 issue 到合併」固定成一套可重複流程的開發者與小團隊：匯入後，儲存庫內的 AI 編程代理會按官方描述的工作流發現就緒議題、認領歸屬、在分支上實作、開 PR、處理審查回饋、等待 CI、按儲存庫選定的合併策略合併並清理。官方將其描述為「可攜」的工作流，隨儲存庫匯入使用，而非綁定單一工具。
  • 同時使用多種 AI 編程工具、不想把流程鎖在單一用戶端上的開發者：官方說明核心循環跨 GitHub Copilot、Claude Code、OpenAI Codex CLI、OpenCode、Antigravity CLI（原 Gemini CLI）運行。
  • 需要多個工作階段並行推進不同議題的團隊：官方說明分散式模式的預設策略是 fully_autonomous_merge，允許工作階段直接推進到合併；工作階段之間如何協調、如何避免衝突，官方未說明。
  • 引入前需要先確認的情況：官方頁面未說明是否支援 GitHub 之外的託管平台，這一點未經確認；若團隊不接受全自動合併，需要先評估或調整該預設策略，官方未展開調整方法。

3 分鐘完成第一次嘗試

  • 前提：一個你有權建分支、開 PR 的 Git 儲存庫；環境裡備妥官方列出的完整循環依賴——git、已認證的 gh CLI（或改用等價的 GitHub MCP 整合，兩者滿足其一即可）、jq、curl 等 REST 用戶端。
  • 安裝位置與方式：不需要手動複製檔案。官方給出的接入方式是在目標儲存庫內對 AI 代理直接下達匯入指令，由 onboarding 指引完成範本複製。
  • 觸發：在儲存庫中開啟受支援的代理，逐字輸入下方這句官方指令：
Import and onboard github:kurone-kito/idd-skill's IDD into this repository.
  • 第一次嘗試建議控制在低風險動作：讓代理閱讀工作流指引，列出現有就緒議題並說明下一步計畫，先不認領、不改程式碼。官方描述的循環起點正是「閱讀指引、發現就緒議題、認領」，在認領發生前你都可以隨時叫停。
  • 成功訊號：代理能複述工作流要點並準確列出現有議題，說明匯入與指引讀取已生效；範本檔案被複製進儲存庫即 onboarding 完成。官方未給出具體落盤路徑，確切位置以代理實際輸出為準（未經確認）。

使用案例

案例一：完整交付一個就緒議題。 情境：backlog 裡已有標註就緒的 issue，想驗證從認領到合併的閉環。向代理發起：「認領一個就緒議題並完成實作。」它會走官方完整循環——閱讀工作流指引、認領議題、分支實作、開 PR、處理審查回饋、等待 CI、按儲存庫選定的合併策略合併並清理。過程中可觀察的節點依序是：分支出現、PR 建立、CI 狀態變化、合併與分支清理，每一步都對應官方循環的固定環節。在預設的 fully_autonomous_merge 策略下，工作階段可一直推進到合併；因此首次執行前應確認 CI 門檻與分支保護已就位，或在指令中明確本次止步於 PR。

案例二：只發現與規劃，不改動任何東西。 情境：想先評估這套流程是否適合儲存庫，還不打算讓它動手。向代理發起：「閱讀工作流指引，列出所有就緒議題並為每個議題寫實作思路，不要認領。」這只會用到循環的前半段（閱讀指引、發現議題），不會建立分支或 PR。官方未說明議題如何被標記為「就緒」，若代理回報清單為空，先確認儲存庫中議題的狀態標註方式。可期待的結果是一份議題清單和實作計畫文字，是否進入實作由你的下一條指令決定；確認計畫可行後，可挑選其中一個議題按案例一走完整流程。

使用邊界

  • 副作用與確認點：匯入會向儲存庫複製範本檔案，複製範圍是僅新增檔案還是也會改動現有檔案，官方未說明，匯入後建議先查看代理給出的變更清單；完整循環會建立分支、提交程式碼、開 PR，並在預設策略 fully_autonomous_merge 下推進到合併。官方未逐項說明哪些動作會先徵求確認，建議在每條指令中顯式劃定允許範圍。
  • 網路與命令存取：完整循環要求已認證的 gh CLI 或等價的 GitHub MCP 整合，並點名 curl 等 REST 用戶端，即代理在循環中會經由這些工具存取 GitHub 介面（讀取議題、建立與合併 PR 等）；具體呼叫哪些介面、有無其他網路存取，官方未逐項列出。
  • 執行環境與用戶端前提：官方列出核心循環跨 GitHub Copilot、Claude Code、OpenAI Codex CLI、OpenCode、Antigravity CLI（原 Gemini CLI）運行；清單之外的代理能否使用、對作業系統有無額外要求、依賴缺失時能否降級運行，官方均未說明。
  • 官方明確限制與未知：官方素材未提及 GitHub 之外託管平台的支援情況，也未說明 fully_autonomous_merge 之外還有哪些合併策略及切換方法；CI 失敗後代理的重試行為同樣未經確認，以上細節應以匯入到儲存庫內的工作流指引原文為準。