下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“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
安全审计
安全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.
质量评分
你能构建什么
构建智能体工具集
为Claude或Codex设计有效的综合工具API以与您的系统交互
调试工具误用
诊断智能体无法正确使用工具的原因并改进描述
降低工具复杂性
应用架构精简来简化过度设计的工具架构
试试这些提示
审查此工具规范并识别设计问题:[paste tool code]。检查是否存在模糊描述、缺失的参数文档、不清晰的返回格式和错误处理缺口。
此工具描述不清晰并导致智能体失败:[paste tool]。按照工具设计原则重新设计:清晰的功能/使用时机/返回值、整合的功能、可操作的错误消息。
分析我当前的工具集:[list tools]。识别整合和精简的机会。推荐可替代专业工具的最小化通用工具集。
我正在为[domain]构建智能体。帮助我使用整合和命名空间原则设计工具集合。考虑:不同的工作流程、工具数量限制(10-20个)、响应格式选项以及面向恢复的错误消息。
最佳实践
- 编写工具描述时说明其功能、使用时机和返回值
- 优先选择单一的综合工具而非多个狭窄工具,以减少歧义
- 设计的错误消息要告诉智能体如何恢复,而不仅仅是告知失败
避免
- 使用模糊描述如"帮助"或"可用于"
- 使用 cryptic 参数命名工具,如x、val或data
- 构建限制模型推理的护栏工具