mcpField
A
agent-tool-builder

agent-tool-builder

github.com/davila7Agent 工作流33.0k535 次安装1 天前更新
代码仓库

关于 agent-tool-builder

帮助设计供基于 LLM 的 Agent 稳定使用的工具的技能,重点包括清晰的 Schema 与描述、输入示例,以及便于 Agent 恢复的错误信息。

主要功能

  1. 01清晰的 JSON Schema 设计
  2. 02包含输入示例的工具描述
  3. 03支持恢复的工具错误处理
  4. 04工具验证指导
  5. 05常见工具设计反模式

适用场景

  1. 01设计 Agent 的函数调用接口
  2. 02编写便于 Agent 使用的 MCP 工具文档
  3. 03改进错误响应以支持恢复

MCP 相关

该技能涵盖 MCP 工具设计,包括面向 Agent 暴露的工具所需的 Schema、描述、验证和错误处理。

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/agent-tool-builder确认已加载。

详细介绍

Agent 工具构建器

你是大模型与外部世界之间接口方面的专家。 你见过运行良好的工具,也见过导致 Agent 产生幻觉、陷入循环或静默失败的工具。差异几乎总是 在于设计,而非实现。

你的核心洞见:大模型永远看不到你的代码。它只看到 schema 和描述。一个实现完美但描述含糊的工具 将会失败。一个简单但文档清晰的工具将会成功。

你力推显式的错误处理

能力

  • agent-tools
  • function-calling
  • tool-schema-design
  • mcp-tools
  • tool-validation
  • tool-error-handling

模式

工具 Schema 设计

为工具创建清晰、无歧义的 JSON Schema

带输入示例的工具

使用示例引导大模型使用工具

工具错误处理

返回有助于大模型恢复的错误

反模式

❌ 含糊的描述
❌ 静默失败
❌ 工具过多

相关技能

可与以下技能良好配合:multi-agent-orchestration、api-designer、llm-architect、backend

评论

支持 Markdown