itscloud0/issue-to-agent

issue-to-agent 是做什麼的？

當使用者要求 Codex 從 GitHub Issue、Issue 網址、OWNER/REPO#123、貼上的 Issue 文字或本機 Issue 檔案準備實作計畫、任務包或代理交接時，使用此技能。

目標

建立一個精簡且可執行的任務包，讓編碼代理無需重新探索基本上下文即可開始執行。

必要輸入

• Issue 來源：本機 Issue 檔案、貼上的 Issue 文字、標準輸入、GitHub Issue 網址或 OWNER/REPO#123。
• 本機儲存庫路徑。若使用者未指定，則預設為目前工作目錄。

工作流程

1. 確認你已在目標儲存庫中，或僅在無法推斷時詢問儲存庫路徑。

2. 若已安裝 CLI，請執行：

   issue-to-agent ISSUE_SOURCE --repo REPO_PATH --output ISSUE_AGENT_TASK.md
   

3. 若使用者需要自動化輸出，請同時執行：

   issue-to-agent ISSUE_SOURCE --repo REPO_PATH --format json --output ISSUE_AGENT_TASK.json
   

4. 若使用者需要維護者可讀的報告，請執行：

   issue-to-agent ISSUE_SOURCE --repo REPO_PATH --format html --output issue-agent-task.html
   

5. 在呈現任務包前，先閱讀生成的內容。檢查建議的檔案、指令、驗收條件與風險是否合理。

6. 若檔案排名看起來不可靠，請使用儲存庫搜尋檢查相關詞彙，並指出其弱點。切勿假設任務包具有權威性。

7. 回傳生成的任務包路徑，並摘要說明：

   • Issue 摘要
   • 可能相關的檔案
   • 建議的指令
   • 驗收條件
   • 風險區域
   • 尚待解決的開放問題

界限

• 除非使用者明確要求，否則不要實作該 Issue。
• 除非被要求，否則不要發佈、推送或評論 GitHub。
• 不要呼叫 LLM 或外部服務。issue-to-agent 以本機優先；GitHub Issue 載入僅使用本機的 gh CLI。
• 將安全、驗證、帳務與資料遷移相關的 Issue 視為高風險，並建議在代理執行前進行人工審查。

良好的輸出格式

已建立 ISSUE_AGENT_TASK.md。

可能相關的檔案：
- src/...
- tests/...

執行指令：
- ...

風險：
- ...