Waza (技) (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Mais de 10 skills moldadas em hábitos (commit, refactor, debug, review)
Cada skill tem 1 página de markdown — sem proliferação de framework
Composíveis — encadeie skills em uma única sessão do Claude
Instruções bilíngues EN/中文
MIT, sem telemetria

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "waza-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "waza-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/tw93/Waza",
          "~/.claude/skills/waza"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add waza-skill -- git clone https://github.com/tw93/Waza ~/.claude/skills/waza

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Waza (技)

Fazer o Claude escrever commits pequenos e atômicos em vez de um blob gigante

👤 Qualquer pessoa cujos PRs do Claude terminam como 1 commit com 600 linhas alteradas ⏱ ~30 min intermediate

Quando usar: A revisão do PR é um inferno porque o commit é impossível de revisar.

Pré-requisitos

Skill instalada — git clone https://github.com/tw93/Waza ~/.claude/skills/waza

Fluxo

Planejar commits

Use a skill de commit do Waza. Planeje o trabalho como uma sequência de commits atômicos antes de escrever qualquer código.✓ Copiado

→ Plano de commits numerado; cada um é um resumo de uma linha
Executar um de cada vez

Faça o commit 1. Pare. Mostre-me o diff e a mensagem.✓ Copiado

→ Único commit pequeno; mensagem segue a convenção
Continuar ou revisar

Continue com o próximo commit, ou revise o plano se o passo 1 mudou seu entendimento.✓ Copiado

→ Próximo commit ou plano revisado

Resultado: PRs que você consegue realmente revisar.

Armadilhas

Plano é granular demais (10 commits para uma mudança trivial) — Padrão da skill é de 3 a 7 commits por PR; passe --target N para substituir

Combine com: github

Aplicar red-green-refactor em uma refatoração que vale a pena fazer

👤 Devs refatorando código legado ⏱ ~90 min intermediate

Quando usar: Você quer refatorar; também não quer quebrar nada.

Fluxo

Cobrir com testes

Use a skill de refactor do Waza em /src/<module>.ts. Primeiro passo: caracterize o comportamento atual com testes.✓ Copiado

→ Testes para o comportamento atual; passando
Refatorar

Agora refatore incrementalmente. Os testes devem ficar verdes a cada passo.✓ Copiado

→ Série de commits de refatoração, todos verdes

Resultado: Código mais limpo com prova de que não quebrou.

Armadilhas

'Testes para comportamento atual' inclui bugs existentes — A skill sinaliza testes suspeitos; marque e refatore-os separadamente

Executar uma revisão de código estruturada em um PR

👤 Revisores que querem consistência ⏱ ~30 min beginner

Quando usar: Revisando um PR que você não escreveu — fácil perder coisas.

Fluxo

Percorrer o diff

Use a skill de review do Waza no PR #123. Percorra o diff hunk por hunk; verifique: correção, nomenclatura, tratamento de erros, testes, segurança.✓ Copiado

→ Notas por hunk; qualquer problema identificado
Resumo

Escreva o resumo da revisão — 3 pontos fortes, 3 preocupações, 1 pergunta.✓ Copiado

→ Resumo no estilo de uma revisão publicada

Resultado: Revisões que encontram problemas, não teatro de 'lgtm'.

Armadilhas

Skill faz críticas de estilo quando há problemas maiores — Reordena por severidade; confie na ordem

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

waza-skill + github

Emparelhar com o MCP do GitHub para o ciclo de vida completo de PR

Planejar, commitar, fazer push, abrir PR, solicitar revisão — encadeie waza commit + github.✓ Copiado

waza-skill + ccpm-skill

O CCPM gerencia o ciclo de vida da issue, o Waza gerencia a disciplina de engenharia dentro dela

/start na issue 42 e execute waza commit.plan dentro do worktree.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
commit.plan	task_description	Início de qualquer trabalho não trivial
refactor.tdd	path, target	Refatorar com rede de segurança
debug.systematic	symptom, context	Bug que resiste ao chute
review.checklist	pr_url	Revisando um PR

Custo e limites

O que custa rodar

Cota de API: N/A
Tokens por chamada: Leve — skills são markdown curto
Monetário: Gratuito
Dica: Hábitos se acumulam — aplique de forma consistente em vez de apenas quando estiver preso

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum

Saída de dados: Local

Solução de problemas

Erros comuns e correções

Skill continua dividindo commits quando um único seria adequado

A menor unidade de mudança varia; passe um PR de exemplo para calibrar

Testes de refatoração cobrem pouco

A skill avisa quando a cobertura está abaixo de 30% no módulo tocado — adicione sementes manuais

Alternativas

Waza (技) vs. outros

Alternativa	Quando usar	Troca
wshobson/agents	Você quer agentes baseados em papéis (frontend, backend) em vez de skills de hábito	Formato diferente; ambos são válidos — níveis de abstração diferentes
addyosmani/agent-skills	Você quer profundidade específica em web-perf/a11y	O conjunto do Addy é para web-frontend; o Waza é para engenharia geral

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills