tool-design
Ferramentas de design para uso eficaz de agentes
也可從以下取得: sickn33,ChakshuGautam,muratcankoylan
Sistemas de agentes têm dificuldades com ferramentas mal projetadas que causam falhas que nenhuma engenharia de prompt pode corrigir. Esta habilidade fornece padrões comprovados para criar APIs de ferramentas que agentes podem entender, selecionar corretamente e usar de forma confiável.
下載技能 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.
風險因素
品質評分
你能建構什麼
Projetar novas ferramentas de agentes
Criar APIs de ferramentas do zero com descrições que agentes podem usar e entender de forma confiável
Depurar falhas de ferramentas
Diagnosticar por que agentes usam mal ferramentas e redescrever descrições para melhores resultados
Otimizar coleções de ferramentas
Avaliar e melhorar conjuntos de ferramentas existentes para reduzir confusão de agentes e melhorar desempenho
試試這些提示
Projete uma ferramenta chamada [name] que [functionality]. Inclua a descrição, parâmetros, retornos e casos de erro seguindo as melhores práticas.
Revise esta descrição de ferramenta quanto à clareza e completude. Identifique problemas e forneça uma versão melhorada: [tool description]
Projete mensagens de erro para [tool name] que permitam agentes a recuperar de: [list of error scenarios].
Analise esta coleção de ferramentas e identifique oportunidades de consolidação usando o princípio de consolidação: [list of tools with descriptions].
最佳實務
- Escreva descrições que respondam claramente o que a ferramenta faz, quando usar e o que retorna
- Use o princípio de consolidação: se um humano não pode escolher definitivamente uma ferramenta, um agente também não pode
- Projete mensagens de erro com recuperação de agentes como consideração primária, não depuração para desenvolvedores
避免
- Descrições vagas como 'Pesquisar no banco de dados' que deixam muitas perguntas sem resposta
- Nomes de parâmetros crípticos como x, val ou param1 que forçam agentes a adivinhar significados
- Tratamento de erros ausente ou erros genéricos que não fornecem orientação de recuperação acionável