oracle

Oracle 是一款專為軟體開發環境與大型語言模型之間搭建橋樑的 CLI 工具。它允許開發者選取特定的檔案集、目錄或符合模式的檔案，製作高上下文的「一次性」請求。透過自動化處理專案上下文提取，Oracle 確保 AI 模型能夠獲取技術架構、建置工具、設定檔與錯誤日誌等必要資訊，進而產出精確的除錯、重構或架構設計建議。此工具針對如 GPT-5.2 Pro 等具備深度思考能力的模型進行了優化，並提供受管理的對話階段生命週期。

• 透過自動聚合基於使用者自訂模式的程式碼庫上下文，簡化提示詞工程流程。

• 支援雙模式執行：針對需要長上下文的任務，提供瀏覽器自動化模式並支援持久化對話階段；針對程式化需求，則提供標準 API 模式。

• 內建強大的預覽與報告工具，讓使用者在發送請求前即可檢視檔案載荷與權杖（Token）消耗，有效控制成本。

• 提供完善的階段管理系統，若發生連線中斷或逾時，使用者可隨時重新附加（Reattach）至正在進行的分析任務。

• 遵循開發環境慣例（如 .gitignore），同時允許使用者精確控制納入或排除的檔案與目錄。

• 在提示詞中務必包含專案簡介，說明技術棧、程式進入點以及期望的輸出格式（如補丁計劃、單元測試）。

• 在執行正式查詢前，使用 --dry-run 與 --files-report 旗標來審核 Token 使用量並確認檔案範圍。

• 工具預設會忽略 node_modules 與 coverage 等編譯產物，確保 AI 能聚焦於原始碼邏輯。

• 對於複雜的問題分析，建議使用「窮舉式提示」模式，提供明確的重現步驟、完整錯誤訊息與操作邊界。

• Oracle 屬於一次性上下文工具，請確保檔案集中已明確包含所有必要設定檔與進入點，以取得最佳的模型回應效果。