http-generate

HTTP Generator 是一個專為 Spring Boot 開發人員設計的自動化工具，旨在簡化 API 文件與測試套件的建立流程。透過掃描專案目錄中帶有 @RestController 或 @Controller 的 Java 檔案，它能智慧地提取端點映射、HTTP 方法（GET, POST, PUT, DELETE）以及參數配置（包含 @RequestParam 與 @PathVariable）。該工具產生的標準化 .http 檔案可直接與 IDE 整合的 REST 客戶端相容，確保 API 範例能與程式碼庫同步更新。

• 自動偵測並映射複雜的多模組 Spring Boot 專案中的 REST 端點。

• 支援進階映射模式，包含請求參數預設值、路徑變數以及針對國際化內容的 URL 編碼。

• 產生的 .http 檔案格式規範，包含詳細註解、完整 URL 路徑，並透過 ### 分隔符進行邏輯分組，便於檢視。

• 透過提供現成的新模組或重構介面的請求範例，有效促進團隊協作。

• 消除手動編寫文件的繁瑣工作，降低 API 實作與測試規格之間的落差。

• 使用 python .claude/skills/http-generate/scripts/http_generator.py [module_path] 指令來鎖定特定模組，或使用 'all' 參數進行全專案覆蓋。

• 工具依賴於標準 Spring Boot 命名規範，請確保控制器檔案以 'Controller.java' 結尾。

• 支援自訂輸出檔案名稱，以利整合進現有的文件工作流中。

• 專為使用 Spring AI Alibaba 框架與標準 Spring Web 依賴的環境所設計。

• 請確保執行環境允許執行 Python 腳本，以便進行檔案系統互動與原始碼分析。