tool-design

tool-design 技能提供了一套严谨的方法论，用于创建、优化和维护代理工具。它将工具说明视为提示工程的延伸，每个字词都直接影响代理的推理过程和工具选择。其核心理念在于“整合原则”：减少工具的复杂性和歧义，以确保代理能够可靠地分辨不同功能。透过标准化命名空间、强制执行基于合约的设计，并采用架构缩减策略，开发者可以构建出避免复杂工具架构中常见“选择错误”的系统。此技能适用于正在构建代理工作流程、实作 MCP (Model Context Protocol) 工具，或希望提高工具调用代理可靠性的 AI 工程师与开发者。它为调试工具误用、重构臃肿的工具集，以及将 API 介面与现有语言模型的推理限制对齐提供了可执行的策略。

• 工具即合约原则：设计自包含的介面，无需人工介入进行说明。

• 整合策略：将冗余函数合并为综合工具，以最大限度地减少上下文预算的浪费。

• 架构缩减：应用类似文件系统的原语，作为过于具体、高维护成本代理工具的可扩展替代方案。

• 命名空间与组织标准：建立层次化分组以提高模型路由准确度。

• 工具选择优化：制作能作为“提示注入”的说明技巧，在决策阶段引导模型行为。

• 务必优先考虑明确、描述性的参数文件，而非晦涩的技术术语。

• 当绩效指标显示频繁出现工具选择失败、幻觉或过度的“思维链”退化时，请使用此技能。

• 推荐用于管理 MCP 工具集、构建强大的代理系统或标准化工程团队间的 API 通讯模式。

• 评估建议：定期审查工具说明与模型混淆率的关系；若模型频繁选择错误工具，说明内容可能缺乏足够的上下文，或与命名空间中的其他工具存在冲突。

• 限制：避免过度整合，以免单一工具变得过于多模态或参数过于繁重，导致模型无法有效解析。