Openclaw Skill Debugger

# OpenClaw Skill Debugger

## Visão Geral

Esta skill foi projetada para auxiliar na depuração e análise de problemas em `AgentSkills` do OpenClaw. Ela fornece ferramentas e um fluxo de trabalho estruturado para identificar a causa raiz de falhas de instalação, erros de execução, problemas de dependência e outras inconsistências que podem impedir o funcionamento correto de uma skill.

## Workflow de Uso

Ao depurar uma skill, siga estas etapas:

1.  **Entender o Problema**: Comece coletando o máximo de informações possível sobre o erro: mensagens de erro, logs, passos para reproduzir o problema e o comportamento esperado da skill.
2.  **Verificação Inicial**: Use os scripts de verificação rápida e consulte os documentos de referência para identificar problemas comuns.
    *   **Caminhos Absolutos/Hardcoded**: Execute `scripts/check-hardcoded-paths.sh <caminho-da-skill>` para procurar paths que podem causar problemas de portabilidade.
    *   **Dependências**: Consulte `references/common-skill-issues.md` e execute `scripts/verify-dependencies.sh <caminho-da-skill>` (se implementado) para confirmar que todos os pré-requisitos estão satisfeitos e corretamente documentados.
    *   **Scripts Auxiliares Ausentes**: Verifique se todos os scripts referenciados no `SKILL.md` da skill alvo existem no seu diretório `scripts/`.
3.  **Análise Detalhada**: Se as verificações iniciais não resolverem, siga o `references/debug-workflow.md` para uma análise mais aprofundada, incluindo a revisão do código-fonte da skill, logs do OpenClaw e testes em ambiente isolado.
4.  **Correção e Validação**: Implemente as correções necessárias e teste a skill exaustivamente para garantir que o problema foi resolvido.

## Scripts

### `scripts/check-hardcoded-paths.sh`

Este script recebe o caminho para uma skill e varre seus arquivos em busca de padrões que indicam o uso de caminhos absolutos ou "hardcoded" (ex: `/home/usuario/`, `/var/`, `/etc/`).
*   **Uso:** `bash scripts/check-hardcoded-path...