情境:因為使用GEMINI CLI神器開發 變形金剛，偶有出錯情形(如:橫向間，程式版次需要對齊，但不明原因無法做對齊)，可以依不同情境，請出下面常見除錯大師AGENT協助)
Delegate to Agent 'codebase_investigator'
Generalist Agent Delegating to agent 'generalist'
CLI Help Agent Delegating to agent 'cli_help'
🚨因為Generalist除錯大師處理較長，故建議需預先告知AI_AGENT 顯式進度(如下:)
💜EXPLICIT_PROGRESS_PROTOCOL (顯式進度協議):
- **強制顯式輸出**: 凡涉及大檔案讀取、複雜運算、多步驟指令（Chain of Commands），AI_TUTOR 必須強制輸出 `🚀 執行進度：Phase X - [內容] (Y/100)` 格式之進度報告。
- **低延遲回報**: 首個進度信號必須於指令開始後 **5 秒內** 產生，杜絕因系統轉圈圈，進而讓使用者，誤以為系統當機的錯誤認知。
💟(以下為呼叫generalist除錯大師之範例:上半段為您的提示詞需求，最後2列，補上呼叫大師上場自動化除錯)
請評估是否比照 io_adapter 已物理阻斷 attrib 等外部 Shell 依賴 ,進行檢討 頻繁使用 `run_shell_command 執行 (Get-Content) -replace ... | Set-Content`，從而屢次引發系統級的編碼災難。
以及 導致 SyntaxError 之阻斷偵測阻擋? 另外,亦需評估對系統是否會造成阻塞進行評估?如何因應 ?
請嚴格遵守 顯式進度協議!!!! (嚴禁黑箱執行,以顯式執行進度呈現)
Generalist Agent Delegating to agent 'generalist'
|
Agent 名稱 |
核心職責 (Core Focus) |
適用場景 (Use Cases) |
運作邏輯 |
|
Codebase Investigator (程式碼庫調查員) |
全域搜索與索引。負責理解專案的整體架構、類別關係與函數調用。 |
詢問「某個變數在哪裡定義？」、「這整個登入流程是怎麼跑的？」或「修改這裡會影響到哪些檔案？」。 |
會掃描整個專案的向量索引 (Embeddings)，找出跨檔案的關聯性。 |
|
Generalist (通用型代理) |
邏輯實作與推理。處理具體的程式碼撰寫、重構或解釋複雜邏輯(模型規模最大、上下文處理量大(「深度思考」需要消耗更多 Token 和運算時間)、多步驟推理(「理解 -> 計畫 -> 撰寫 -> 檢查」的內部分解過程)。 |
「幫我寫一個處理 API 回傳資料的函數」、「解釋這段演算法的時空複雜度」、「幫我重構這段冗長的 If-Else」。 |
專注於當前編輯的檔案或具體的上下文，進行高質量的文本/程式碼生成。 |
|
CLI Help (終端機助手) |
指令環境與操作。處理 Shell指令、環境配置、Git 操作或建置工具。 |
「如何用 Git 把這兩個 Commit 合併？」、「幫我寫一個找出專案中超過 100MB 檔案的指令」。 |
專精於不同作業系統（Linux/Mac/Windows）的指令語法，輸出可執行的命令。 |
其它Agent參考資訊 (資料來源：GEMINI)
- Test Architect (測試架構師)：專門負責生成單元測試 (Unit Tests) 或集成測試，它會尋找邊界條件並試圖「寫壞」你的程式碼。
- Architect (由generalist扮演⌈架構師⌋ )：用於高層級的系統設計，例如「我想建立一個微服務系統，該選什麼技術棧？」，它不寫具體代碼，而是給出規劃。 (Delegate to Agent 'Architect' 繼承關係分析 (Inheritance Analysis)) ;使用案例:調整 MYRAG 架構時，詢問系統依賴性進一步檢討。
- Debugger / Log Analyst (由generalist 扮演⌈除錯專才⌋ )：當您貼上一長串 Stack Trace (報錯日誌) 時，這種 Agent 會專門分析錯誤模式，找出導致 Crash 的那一行代碼。 (Delegate to Agent 'Log Analyst ' 提取異常模式與系統足跡)，所以當我需要進行RCA根因分析、SYS日誌歷史查找時，可經由 generalist 扮演⌈除錯專才⌋協助除錯，而且如涉及上述架構性探討優化時，也可以同時再呼叫 generalist扮演⌈架構師⌋一同出席檢核評估等任務。
- 除Delegate委派Sub-agents子代理人(如:generalist)外，除錯進階處理作法是：「Atomic Hotfix (原子化修正)」。因此如系統有迭代自癒修復機制者，可以評估進行優化，可提昇除錯LEVEL，所以這不僅僅是委派，而是包含： (-> 右側紅色為筆者系統內之範例，供參照解說)
1. 調查 (Investigate) -> 調用 codebase_investigator 獲取 SSOT(Single Source of Truth唯一事實來源)。
2. 設計 (Strategy) -> 撰寫 Strategic Intent 並執行。
3. 執行 (Execution) -> 主代理人直接執行 replace。
4. 硬化 (Hardening) -> 同步 manifest.json 與 OS 鎖定。
