Horace-Maxwell/horosa-skill

解決的問題

Horosa Skill 為 AI 代理提供一個本地優先的介面，使其能存取 106 種專業占星術與神秘學技術。透過以決定性、本地執行的執行環境取代 AI 從記憶中嘗試計算星盤或解釋規則的做法，防止 AI 在神秘學解讀中產生「幻覺」。

工作原理

此專案作為 MCP（模型上下文協定）伺服器與 CLI，橋接 AI 客戶端（如 Claude Desktop 或 Cursor）與無頭 JS 引擎，以及 Java/Python 後端。

• 決定性執行環境：演算法在本地（離線）執行，確保計算結果與專業 Horosa 桌面應用程式完全一致。
• 澄清門檻：若關鍵參數（時間、地點、時區）遺漏，系統會攔截呼叫，強制 AI 向使用者確認，而非猜測。
• 結構化輸出：每個工具皆返回統一的「信封」，包含星盤快照與記錄特定規則與版本的「技術卡」。
• 可追溯性：內建 31 個領域的知識庫，共 408 筆引用條目，確保 AI 提供的任何解讀皆可追溯至特定手冊或規則書。
• 忠實度基準測試：決定性驗證器會將 AI 解讀與實際星盤資料比對，標記出虛構或矛盾的事實。

適用對象

• 建構專業神秘學或占星術代理的 AI 開發者。
• 希望將專業級、本地優先的占星計算整合至其 LLM 工作流程中的 AI 客戶端高階使用者。
• 在神秘學解讀中需要高精度與可追溯性的實務者。

主要亮點

• 106 項整合技術：涵蓋西方占星術、中國神秘學（八字、紫微、奇門等）以及 14 種「神數」（神數）。
• 本地優先且離線運作：所有計算皆在使用者機器上完成，資料不會上傳至雲端。
• MCP 兼容：可輕鬆整合至 Claude Code、Claude Desktop、Cursor 與 Open WebUI。
• 防幻覺套件：結合澄清門檻、引用知識庫與忠實度評估器，確保 AI 的準確性。
• 多技術綜合分析：horosa_hecan 工具支援並行執行多項技術，比較結果並明確揭露差異。