juliaz-tool-builder

juliaz-tool-builder 技能為致力於 Julia 多代理系統的開發者提供專業的工程指導。它聚焦於代理意圖與功能實作之間的關鍵橋樑，強調大型語言模型完全依賴架構與說明文件來與軟體工具互動。若缺乏清晰且結構化的定義，代理容易產生模糊不清的行為或幻覺。本技能專為維護調度器 (orchestrator)、前端 (frontend) 以及各類內部代理的架構師與開發者所設計，協助他們縮短工具邏輯設計與執行階段效能之間的差距。它確保工具定義不僅具備功能性，且足夠明確以利模型做出準確決策。

• 針對調度器架構中 Anthropic 與 OpenAI 格式的工具定義提供專業設計模式。

• 使用 Vercel AI SDK 與 Zod 架構實作前端工具的標準，確保型別安全的互動。

• 制定五階段工具說明編寫指南，定義工具目的、觸發情境、負面限制、必要輸入以及預期輸出格式。

• 錯誤處理最佳實踐，強調回傳字串而非拋出例外，以利模型順利恢復狀態。

• 防止常見反模式的策略，例如描述模糊、靜默失敗、工具過度膨脹以及功能說明重疊。

• 支援與 bridge (MCP)、後端 API 及 Antigravity 開發環境等多元元件的整合。

• 在開發調度器 (julia/orchestrator/src/tools.ts) 或前端 (julia/frontend/server.ts) 模組的新工具時觸發此技能。

• 當代理持續誤用、忽略或難以呼叫特定函式時使用此技能進行偵錯。

• 遵循五問題檢查清單，確保每個工具都具備明確定義、使用觸發條件與排除標準。

• 遵守既定的錯誤處理模式，確保模型接收到可操作的意見回饋而非晦澀的堆疊追蹤。

• 維持每個代理的工具數量精簡（例如調度器維持 2-4 個），以減輕模型的認知負荷。

• 在參數說明中提供具體範例，顯著提高函式呼叫成功的機率。