tool-design
Herramientas de diseño para uso efectivo de agentes
也可从以下获取: sickn33,muratcankoylan,ChakshuGautam
Los sistemas de agentes luchan con herramientas mal diseñadas que causan fallos que ninguna ingeniería de prompts puede resolver. Esta habilidad proporciona patrones probados para crear APIs de herramientas que los agentes pueden entender, seleccionar correctamente y usar de manera confiable.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“tool-design”。 Diseña una herramienta para recuperar información de clientes
预期结果:
- Nombre de herramienta: get_customer
- Description: Recuperar información del cliente por ID o email
- When to use: Cuando el usuario pregunta sobre detalles, historial o estado del cliente
- Parameters: customer_id (requerido, formato CUST-######), format (concise/detailed)
- Returns: Objeto de cliente con id, name, email, account_status, historial de pedidos opcional
- Errors: INVALID_CUSTOMER_ID, CUSTOMER_NOT_FOUND, RATE_LIMITED
正在使用“tool-design”。 Revisa esta herramienta: search(query) - Search the database
预期结果:
- Issue: El nombre 'search' es ambiguo - buscar qué, con qué propósito?
- Issue: Faltan descripciones de parámetros - qué base de datos, qué formato?
- Issue: No hay descripción de retorno - qué devuelve esta función?
- Issue: No hay contexto de uso - cuándo usar versus otras herramientas
- Issue: No hay guía de manejo de errores
正在使用“tool-design”。 Cómo debo nombrar las herramientas MCP?
预期结果:
- Usa nombres completamente calificados: formato ServerName:tool_name
- Ejemplo: 'Usa BigQuery:bigquery_schema para recuperar esquemas de tablas'
- Evita nombres no calificados que pueden fallar con múltiples servidores MCP
- Incluye contexto de servidor en todas las referencias de herramientas
安全审计
安全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.
风险因素
质量评分
你能构建什么
Diseñar nuevas herramientas para agentes
Crear APIs de herramientas desde cero con descripciones que los agentes puedan usar y entender de manera confiable
Depurar fallos de herramientas
Diagnosticar por qué los agentes mal utilizan las herramientas y rediseñar las descripciones para mejores resultados
Optimizar colecciones de herramientas
Evaluar y mejorar conjuntos de herramientas existentes para reducir la confusión de los agentes y mejorar el rendimiento
试试这些提示
Diseña una herramienta llamada [name] que [functionality]. Incluye la descripción, parámetros, retornos y casos de error siguiendo las mejores prácticas.
Revisa esta descripción de herramienta para verificar claridad y completitud. Identifica problemas y proporciona una versión mejorada: [tool description]
Diseña mensajes de error para [tool name] que permitan a los agentes recuperarse de: [list of error scenarios].
Analiza esta colección de herramientas e identifica oportunidades de consolidación usando el principio de consolidación: [list of tools with descriptions].
最佳实践
- Escribe descripciones que respondan claramente qué hace la herramienta, cuándo usarla y qué devuelve
- Usa el principio de consolidación: si un humano no puede elegir definitivamente una herramienta, un agente tampoco puede
- Diseña mensajes de error con la recuperación del agente como consideración principal, no la depuración del desarrollador
避免
- Descripciones vagas como 'Buscar en la base de datos' que dejan demasiadas preguntas sin respuesta
- Nombres de parámetros crípticos como x, val o param1 que obligan a los agentes a adivinar el significado
- Falta de manejo de errores o errores genéricos que no proporcionan guía de recuperación accionable