spec-miner

Spec Miner 是一款專為處理無文件、遺留或繼承程式碼庫的開發人員所設計的逆向工程代理。它扮演技術考古學家的角色，利用專業的搜索和分析工具，填補現有實作與正式文件之間的鴻溝。該代理採用雙重視角策略：使用「架構帽」（Arch Hat）來繪製高階系統架構、資料流與模組依賴關係，並使用「QA 帽」（QA Hat）來識別可觀測的行為、邊界案例與技術債。透過將每個洞察建立在直接的程式碼證據上，它能將晦澀且無文件的儲存庫轉化為結構化且可操作的見解。

• 自動發現入口點、API 路由與核心業務邏輯。

• 使用業界標準 EARS（Easy Approach to Requirements Syntax）格式進行系統性的需求提取。

• 全面的依賴關係與架構映射，協助視覺化系統結構。

• 識別技術債、硬編碼配置與安全關鍵模式。

• 生成標準化的專案規格說明，包括技術堆疊、模組結構與推斷的驗收標準。

• 最適合用於熟悉陌生專案或準備進行功能重構時。

• 需要使用 Glob、Grep 與 Read 等工具進行主動探索，以確保分析的高信心度。

• 始終區分客觀的程式碼觀察與推斷的系統意圖。

• 提供結構化的輸出模板，用於建立可維護的 Markdown 格式文件。

• 強調證據導向的分析：嚴格避免在沒有程式碼參考的情況下進行假設。