health

Visão geral da skill de saúde

O que a skill de saúde faz

health executa uma auditoria de saúde de agente com foco em orçamento para Codex, Claude Code, Pi, instruções do agente, hooks/MCP, superfícies de verificação e manutenibilidade de IA. Ela é indicada para quem precisa de um guia prático de saúde para entender por que um agente ignora instruções, pula a verificação ou escorrega para um comportamento difícil de manter.

Melhor encaixe e principal função

Use esta skill de saúde quando você precisar de uma verificação rápida de configuração e fluxo de trabalho, não de uma revisão de código. Ela é especialmente útil em trabalhos no estilo Security Audit, porque mostra se a pilha de agentes é confiável o bastante para depender dela antes de você analisar a lógica da aplicação, o tratamento de segredos ou a conformidade com políticas.

O que a torna diferente

A skill tem uma visão opinativa sobre a saúde em camadas do agente: superfícies de configuração, arquivos de instrução, ferramentas/runtime, verificadores e manutenibilidade. Isso torna o resultado mais pronto para decisão do que um prompt genérico, porque ele consegue apontar a camada desalinhada em vez de apenas dizer que “algo parece errado”.

Como usar a skill de saúde

Contexto de instalação e primeiros arquivos

Instale a skill de saúde com npx skills add tw93/Waza --skill health. Depois da instalação, leia primeiro SKILL.md e, em seguida, examine agents/inspector-context.md, agents/inspector-control.md e agents/inspector-maintainability.md para entender o que a auditoria espera e que tipo de evidência ela prioriza.

Que entrada a skill precisa

A skill de saúde funciona melhor quando você fornece sinais específicos do repositório: arquivos de instruções do agente, configurações de hooks ou MCP, comandos de verificação e sintomas como “Claude ignora AGENTS.md” ou “a configuração do Codex parece certa, mas o comportamento é inconsistente”. Se você quer um resultado útil de uso da health, inclua o caminho exato do repositório, a plataforma de agente e o modo de falha que você observou.

Como formular uma solicitação forte

Um pedido fraco é “verifique a saúde”. Um pedido mais forte é: “Execute uma auditoria de saúde neste repositório para Claude Code e Codex. Foque no encadeamento das instruções, nos hooks, na cobertura dos verificadores e em se a manutenibilidade de IA tende a se degradar. Aponte caminhos quebrados, referências desatualizadas ou superfícies de verificação ausentes.” Isso dá à skill contexto suficiente para produzir uma auditoria útil para decisão.

Fluxo de trabalho e ordem de leitura do repositório

Use primeiro os scripts de coleta do repositório, se eles estiverem disponíveis, e só depois examine as saídas da auditoria antes de ler o código-fonte bruto. Neste repositório, os caminhos práticos são scripts/check_agent_context.py, scripts/check_doc_refs.py, scripts/check_maintainability.py e scripts/check_verifier_output.py. Essa ordem ajuda a identificar onde está o problema antes de você inspecionar manualmente cada arquivo.

Perguntas frequentes sobre a skill de saúde

Isso serve só para checagens de configuração?

Não. A skill de saúde serve para auditorias de configuração de agentes, desvio de instruções, lacunas de verificação e risco de manutenibilidade. Ela não foi feita para depurar bugs da aplicação nem para revisar um diff de pull request.

Quando não devo usar a skill de saúde?

Não use se você só quer uma correção em nível de código, um diagnóstico de bug ou uma reescrita pontual de prompt. Se o repositório for pequeno e não tiver superfícies de agente, um prompt simples costuma bastar; a skill de saúde é mais valiosa quando há vários arquivos de agente, hooks ou camadas de verificação.

A skill de saúde é amigável para iniciantes?

Sim, desde que você consiga informar o repositório e o sintoma. O principal erro de quem está começando é pedir uma “checagem de saúde” vaga, sem dizer qual agente, qual superfície de instrução ou qual etapa de verificação parece quebrada. Quanto mais preciso for o input, mais acionável será a saída.

Como ela se compara a um prompt genérico?

Um prompt genérico consegue resumir preocupações, mas a skill de saúde foi criada para inspecionar as superfícies do agente de forma sistemática e distribuir sua atenção de modo orçado. Isso importa quando você precisa tomar uma decisão de instalação da health para fluxos de trabalho de Security Audit, em que validação ausente ou instruções desatualizadas podem corroer a confiança sem chamar atenção.

Como melhorar a skill de saúde

Dê o sintoma e o limite certos

Especifique se o seu foco é Claude Code, Codex, Pi ou os três, e nomeie a falha: instruções ignoradas, hooks ausentes, cobertura fraca de verificadores ou desvio na manutenibilidade de IA. Se você definir o limite, a skill evita desperdiçar atenção com a estrutura do repositório que não tem relação com o problema.

Forneça evidências, não só uma conclusão

Entradas mais fortes incluem os arquivos relevantes ou trechos deles: AGENTS.md, camadas locais de instrução, settings, configuração de hooks e qualquer saída de comando que mostre a falha. Por exemplo, “AGENTS.md diz para verificar com make test, mas o repositório só tem pytest -q” é muito melhor do que “os testes parecem errados”.

Itere depois da primeira auditoria

Use o primeiro resultado para decidir se o problema está no encadeamento das instruções, em incompatibilidade de ferramentas/runtime ou em fragilidade do verificador; depois, rode novamente com um alvo mais estreito. Se a skill disser que a pilha de agentes está saudável, mas a manutenibilidade está fraca, peça uma segunda passada focada em densidade de TODOs, ownership de pontos quentes e referências desatualizadas na documentação, em vez de auditar tudo de novo.