tool-design

此技能提供了一套系统化的方法论，用于创建健壮且适合代理使用的工具。它将每个工具视为确定性系统与非确定性代理之间的严格合约，确保描述作为关键的提示工程，以最大限度地减少选择错误和幻觉。对于那些在构建生产级代理系统时遇到工具混淆、功能冗余或路由性能不佳的开发者来说，这是一个必备的技能。

该框架的核心在于「整合原则」，倡导通过将狭窄、重叠的工具合并为全面且无歧义的功能来降低复杂性。通过优化工具命名空间、参数格式和使用情境，该技能帮助开发者实现更高的可靠性和更低的上下文预算消耗，直接解决在工具选择过程中常见的「中间丢失」等问题。

• 设计作为清晰、独立合约的代理专用 API。

• 优化工具描述，使其作为推理模型的关键提示输入。

• 实施架构精简，利用文件系统操作等标准化原语取代复杂的专用工具。

• 应用命名空间和层次化组织，提高代理路由的效率。

• 调试与工具相关的失败，包括误用、参数格式错误和选择歧义。

• 标准化工具惯例，确保在不同模型后端之间保持一致的行为。

• 适用对象：AI 工程师、平台架构师以及在 Claude Code、Cursor 或自定义 MCP（模型上下文协议）实作中构建代理工作流的开发者。

• 输入：需要定义工具目标、预期的输入输出以及潜在的失败模式。

• 输出：高度结构化、无歧义的工具定义，可最大程度减少猜测并提高成功率。

• 使用建议：专注于回答「工具做什么」、「何时使用」以及「回传什么」，以对齐代理内部的推理过程。

• 约束：避免过度整合而导致单一工具参数过于复杂；应在平衡性和可维护性之间取得权衡。