你的 MCP Server 为什么 Claude 用不好？——工具设计才是关键

你辛辛苦苦写了一个 MCP Server，功能完整、逻辑严谨，结果 Claude 调的时候就是听不懂——工具选错了、参数乱传、错误也不报。

问题往往不在代码，而在工具设计本身。

工具 schema 烂，LLM 就烂

Agent Tool Builder 这个 Skill 讲的就是这件事：LLM 永远看不到你的代码，它只看到 JSON Schema 和描述。

一个功能完美但 schema 写得模糊的工具，会让 Agent 幻觉、循环、或静默失败。而一个简单但文档清晰的工具，Agent 用起来就是顺。

它教什么

这个 Skill 覆盖了构建 AI 工具的全链路设计问题：

• JSON Schema 最佳实践：怎么写出 LLM 能准确理解的参数定义
• Description 写法：不是写给人看的文档，是写给模型的指令
• 错误处理：返回什么样的错误信息，Agent 才能真正恢复而不是卡死
• MCP 标准：Model Context Protocol 现在是 AI 工具互联的事实标准，这个 Skill 帮你从一开始就对齐
• 反模式警示：模糊描述、静默失败、工具过多——这三个坑基本涵盖了 80% 的 Agent 调试问题

适合谁用

如果你在：

• 写 MCP Server 给 Claude 或其他 Agent 用
• 设计 function-calling 的工具接口
• 做 multi-agent 系统的工具编排

这个 Skill 就是你欠缺的工具设计 checklist。

怎么安装

一行搞定：

npx skills add https://github.com/davila7/claude-code-templates --skill agent-tool-builder

装完之后，每次 Claude Code 需要设计新工具时它会自动激活，帮你从 schema 开始把关。

开发者的 AI 工具链现在越来越长，但工具设计能力这个环节大多数人都还没意识到自己缺。这个 Skill 就是补那块短板的。

GitHub：https://github.com/davila7/claude-code-templates

GitHub: https://github.com/davila7/claude-code-templates