tool-design

tool-design 技能概览

tool-design 的作用

tool-design 技能帮助你设计面向 agent 的工具，让模型能够正确地选择并调用。它最适合用于你正在构建新工具、精简一个过载的工具集，或者审查第三方工具接口是否适合 agent 使用的时候。这个技能聚焦的是一个很实际的问题：把工具描述写得足够具体，避免 agent 猜错。

什么时候最适合用

当 Design Implementation 的主要难点在于工具选择、命名、职责重叠，或者 agent 边界上的行为不清晰时，适合使用 tool-design 技能。它非常适合 MCP 工具设计、工具收敛，以及 agent 调用了错误函数或忽略了正确函数的排查场景。如果你只是需要给人看的通用 API 文档，它就没那么有用。

它有什么不同

这个 tool-design 技能对“收缩”有明确立场：只要工具之间有重叠，agent 就会误用。它强调的是清晰无歧义的工具契约、明确的触发规则，以及围绕描述本身的工程化处理，而不是泛泛的提示词建议。这也意味着，当你需要的是更少但更好的工具，而不是更多说明时，它会特别有帮助。

如何使用 tool-design 技能

安装并检查源文件

使用 npx skills add muratcankoylan/Agent-Skills-for-Context-Engineering --skill tool-design 安装 tool-design 技能。然后先阅读 skills/tool-design/SKILL.md，再看 references/best_practices.md、references/architectural_reduction.md 和 scripts/description_generator.py。这些文件展示了设计逻辑、收缩取舍，以及对输出质量最关键的辅助模式。

先给出正确的问题陈述

当你的提示词明确了工具边界，而不只是功能名称时，tool-design usage 的效果会更好。好的输入应该说明工具必须做什么决策、会接收到什么输入，以及当前设计在哪里失效。例如：“设计一个 agent 工具，用于从日历数据中查找可用会议室；它不应与预订或搜索工具重叠。”这比“创建一个会议室工具”要强得多。

使用带约束的提示词

想获得最佳结果，请提供工具的用途、预期调用者、输入类型、失败场景，以及对自主性的任何限制。如果你正在重构一组工具，把所有候选工具都列出来，并要求做收敛。如果你是在创建单个工具，请给出参数名、数据类型，以及有效和无效调用的示例。tool-design guide 在模型能够比较备选方案时效果最好，而不是让它自己推断。

Design Implementation 的实用流程

先列出 agent 能采取的每一种动作，然后把意图相同的动作合并起来。接着，为每个工具写一句话，说明它做什么、以及何时应该使用。最后，用可能引发混淆的场景去检验措辞：如果两个工具听起来可以互换，说明描述还没准备好。对于 Design Implementation 来说，这是在加更多逻辑之前，先减少工具选择错误的最快方式。

tool-design 技能 FAQ

tool-design 只适用于新工具吗？

不是。tool-design 技能在现有工具过于细碎、命名不一致，或者经常被 agent 误用时同样有价值。在很多团队里，真正更大的收益往往不是再发明一个函数，而是重新设计一套混乱的工具集。

这和普通提示词有什么不同？

普通提示词可以让你提出工具点子，但 tool-design 技能关注的是让 agent 能执行的工具契约。这意味着更紧的范围、更强的描述、更明确的激活规则，以及对重叠问题的关注。当输出必须经得起真实的 agent 选择行为，而不只是让人看着顺眼时，它会更合适。

这对初学者友好吗？

可以，只要你能描述用户任务和工具预期输入，就能上手。使用 tool-design 技能并不需要你深入了解 agent 内部机制，但你确实需要把边界说清楚。含糊的请求只会导出含糊的工具。

什么时候不该用它？

如果你是在写面向终端用户的 API 文档、构建纯 UI 流程，或者已经有一套足够精简、分工清晰且调用稳定的工具集，就可以跳过 tool-design。当主要问题是模型推理，而不是工具设计时，它也不是正确选择。

如何改进 tool-design 技能

提供更锋利的源材料

最好的 tool-design 输出来自具体示例：工具名、确切动作、预期参数，以及两到三个常见误用案例。只给一个功能名称，结果通常会过于泛化，不适合 agent 使用。只要你希望做收敛，就把当前工具列表一起提供，因为重叠正是这个技能最想阻止的主要失败模式。

要求明确说明取舍

当你想要更好的工具设计时，要求这个技能说明哪些内容被合并了、哪些被删掉了，以及原因是什么。这样得到的 Design Implementation 指导，比单纯重写更有用。例如，可以要求输出一份改动前后工具映射、推荐描述，以及对每个改动消除的主要歧义的简短说明。

从错误调用迭代，不要凭猜测

如果 agent 已经在出错，把失败的工具调用、选错的工具，或者含糊的描述带进下一轮提示词。tool-design 技能在修复真实失败模式时最强。第一次处理后，围绕 agent 已经表现出的那种具体混淆去收紧措辞，然后再测试一次。