tool-design
Инструменты дизайна для эффективного использования агентами
也可从以下获取: sickn33,ChakshuGautam,muratcankoylan
Агентные системы страдают от плохо спроектированных инструментов, которые вызывают сбои, неустранимые никакой промпт-инженерией. Этот навык предлагает проверенные паттерны создания API инструментов, которые агенты могут понимать, корректно выбирать и надежно использовать.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“tool-design”。 Design a tool for retrieving customer information
预期结果:
- Tool name: get_customer
- Description: Retrieve customer information by ID or email
- When to use: User asks about customer details, history, or status
- Parameters: customer_id (required, format CUST-######), format (concise/detailed)
- Returns: Customer object with id, name, email, account_status, optional order history
- Errors: INVALID_CUSTOMER_ID, CUSTOMER_NOT_FOUND, RATE_LIMITED
正在使用“tool-design”。 Review this tool: search(query) - Search the database
预期结果:
- Issue: Name 'search' is ambiguous - search what, for what purpose?
- Issue: Missing parameter descriptions - what database, what format?
- Issue: No return description - what does this function return?
- Issue: No usage context - when to use versus other tools
- Issue: No error handling guidance
正在使用“tool-design”。 How should I name MCP tools?
预期结果:
- Use fully qualified names: ServerName:tool_name format
- Example: 'Use BigQuery:bigquery_schema to retrieve table schemas'
- Avoid unqualified names that may fail with multiple MCP servers
- Include server context in all tool references
安全审计
安全Documentation and guidance skill with no dangerous capabilities. All 225 static findings are FALSE POSITIVES. The analyzer incorrectly flagged documentation examples, common technical terms, and metadata file paths as security risks. This skill contains only guidance content about tool design patterns - no network access, no command execution, no file system operations beyond its own directory validation.
风险因素
质量评分
你能构建什么
Проектирование новых инструментов для агентов
Создавайте API инструментов с нуля с описаниями, которые агенты могут надежно использовать и понимать
Отладка сбоев инструментов
Диагностируйте, почему агенты неправильно используют инструменты, и переработайте описания для лучших результатов
Оптимизация коллекций инструментов
Оцените и улучшите существующие наборы инструментов, чтобы снизить путаницу у агентов и повысить производительность
试试这些提示
Design a tool called [name] that [functionality]. Include the description, parameters, returns, and error cases following best practices.
Review this tool description for clarity and completeness. Identify issues and provide an improved version: [tool description]
Design error messages for [tool name] that enable agents to recover from: [list of error scenarios].
Analyze this tool collection and identify consolidation opportunities using the consolidation principle: [list of tools with descriptions].
最佳实践
- Пишите описания, которые четко отвечают на то, что делает инструмент, когда его использовать и что он возвращает
- Используйте принцип консолидации: если человек не может однозначно выбрать инструмент, агент тоже не сможет
- Проектируйте сообщения об ошибках с приоритетом восстановления агента, а не отладки разработчика
避免
- Расплывчатые описания вроде 'Search the database', которые оставляют слишком много вопросов без ответа
- Загадочные имена параметров вроде x, val или param1, заставляющие агентов угадывать смысл
- Отсутствующая обработка ошибок или общие ошибки, не дающие практических рекомендаций по восстановлению