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 个），以减轻模型的认知负荷。

• 在参数说明中提供具体示例，显着提高函数调用成功的机率。