技能 tool-design
🛠️

tool-design

安全

为AI智能体设计有效的工具API

也可从以下获取: ChakshuGautam,Asmayaseen,muratcankoylan

糟糕的工具设计会产生即使提示工程也无法修复的故障模式。本技能提供构建优化AI智能体推理和使用的工具接口的原则。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“tool-design”。 Review this tool: def search(query): "Search the database."

预期结果:

  • Issues found: (1) Vague name - search what? (2) Missing parameter docs - what format? (3) No return description (4) No error handling (5) No usage context
  • Recommended: Rename to search_customers(query, fields), document query syntax, specify return format, add INVALID_QUERY and RATE_LIMITED error cases

正在使用“tool-design”。 How do I reduce 50 specialized tools to a simpler set?

预期结果:

  • Apply consolidation: Group related tools by workflow, not by data entity
  • Consider architectural reduction: Can file system access + standard utilities replace custom tools?
  • Target 10-20 tools with namespacing: database.query, database.schema, web.search, web.fetch

安全审计

安全
v1 • 2/25/2026

Static analysis flagged 73 potential issues but all are false positives. The SKILL.md file is documentation-only containing conceptual explanations and Python code examples in markdown blocks. No executable code, network calls, or system commands exist. External command patterns (8) are markdown code snippets, network patterns (3) are documentation URLs, cryptographic warnings (62) are text matches in prose, and reconnaissance flags (6) reference conceptual discussions.

1
已扫描文件
319
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

构建智能体工具集

为Claude或Codex设计有效的综合工具API以与您的系统交互

调试工具误用

诊断智能体无法正确使用工具的原因并改进描述

降低工具复杂性

应用架构精简来简化过度设计的工具架构

试试这些提示

初学者:评估工具设计
审查此工具规范并识别设计问题:[paste tool code]。检查是否存在模糊描述、缺失的参数文档、不清晰的返回格式和错误处理缺口。
中级:重新设计糟糕的工具
此工具描述不清晰并导致智能体失败:[paste tool]。按照工具设计原则重新设计:清晰的功能/使用时机/返回值、整合的功能、可操作的错误消息。
高级:应用架构精简
分析我当前的工具集:[list tools]。识别整合和精简的机会。推荐可替代专业工具的最小化通用工具集。
专家:设计工具集合策略
我正在为[domain]构建智能体。帮助我使用整合和命名空间原则设计工具集合。考虑:不同的工作流程、工具数量限制(10-20个)、响应格式选项以及面向恢复的错误消息。

最佳实践

  • 编写工具描述时说明其功能、使用时机和返回值
  • 优先选择单一的综合工具而非多个狭窄工具,以减少歧义
  • 设计的错误消息要告诉智能体如何恢复,而不仅仅是告知失败

避免

  • 使用模糊描述如"帮助"或"可用于"
  • 使用 cryptic 参数命名工具,如x、val或data
  • 构建限制模型推理的护栏工具

常见问题

我应该向智能体提供多少个工具?
研究表明,大多数应用需要10-20个工具。更多的工具会增加混淆和token消耗。使用命名空间来组织相关工具。
什么是架构精简?
用原始的、通用化的能力替代专业工具。例如:文件系统访问+Unix工具替代自定义数据探索工具。
我什么时候应该整合工具?
当人类无法明确判断应该使用哪个工具时进行整合。当工具具有根本不同的行为或安全要求时避免整合。
如何编写有效的工具描述?
回答四个问题:它做什么(具体而非模糊)、何时使用它(触发条件和上下文)、它接受什么输入(类型和约束)、它返回什么(格式和结构)。
什么是整合原则?
如果人类工程师无法说出应该使用哪个工具,就不能期望智能体做得更好。这导致优先选择综合工具而非多个狭窄工具。
我如何测试工具设计?
使用智能体在各种任务中测试工具,收集故障模式,分析摩擦点,并迭代描述。智能体反馈可将任务完成时间减少40%。

开发者详情

文件结构

📄 SKILL.md