analyzing-projects

analyzing-projects 技能是一款強大的診斷工具，專為需要快速掌握陌生程式碼庫狀況的軟體工程師與開發人員所設計。它作為自動化專家指南，有系統地審核專案架構，識別核心技術、依賴項與既定開發規範。透過執行結構化工作流程，代理程式能將原始目錄資料與設定檔綜合為連貫且可執行的摘要，大幅減輕理解程式碼運作邏輯或尋找特定邏輯所在位置所需的認知負擔。

• 自動偵測並分類技術堆疊，包括套件管理工具 (npm, pip, cargo, gomod)、框架 (Next.js, FastAPI, Spring Boot) 以及基礎設施即程式碼工具 (Terraform, Kubernetes)。

• 產生全面的架構概覽，將原始程式碼目錄、進入點與測試套件映射為視覺化樹狀結構。

• 識別關鍵架構模式 (Monolith, Microservices, Serverless)、API 風格 (REST, GraphQL, gRPC) 與資料庫選擇。

• 評估開發工作流程，檢查 lint 工具、格式化工具、Git hooks (Husky) 與建置指令碼 (Makefile, npm scripts)。

• 產生標準化且易於閱讀的 Markdown 摘要，涵蓋架構、目錄用途、進入點、開發指令與專案特定的程式碼規範。

• 提供強大的驗證清單，確保調查期間不會遺漏任何關鍵元件。

• 非常適合在加入新專案、執行程式碼稽核，或需要快速回答「這是如何運作的？」或「架構是什麼？」時使用。

• 輸入通常為本地目錄路徑，輸出為結構化的摘要報告。

• 可與其他工作流程外掛程式或代理程式結合使用，以加速開發、偵錯或文件編寫任務。

• 在擁有專案根目錄與設定檔的讀取權限時運作效果最佳。

• 請注意，雖然此工具為自動化，但它在專案保持標準規範時效果最好；非標準結構可能需要手動驗證建議的報告。