/ Directorio / Playground / Waza (技)
● Comunidad tw93 ⚡ Instantáneo

Waza (技)

por tw93 · tw93/Waza

Hábitos de ingeniero senior empaquetados como skills de Claude Code — commits pequeños, refactorizaciones precisas, depuración enfocada, revisiones deliberadas. Cosas que ya sabes, hechas repetibles.

Waza (japonés 技 — 'técnica') es un conjunto curado de skills de disciplina de ingeniería por tw93, mantenedor del ecosistema eSheep / Pake / Waza. Cada skill encapsula un hábito específico: 'commit atómico pequeño', 'red-green-refactor', 'bisect sistemático', 'revisión de código con checklist'. No son funciones llamativas — son las pequeñas disciplinas que separan la salida de un ingeniero senior de la de un junior, aplicadas automáticamente.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Waza (技)

Hacer que Claude escriba commits pequeños y atómicos en lugar de un blob gigante

👤 Cualquiera cuyos PRs de Claude terminan como 1 commit con 600 líneas cambiadas ⏱ ~30 min intermediate

Cuándo usarlo: La revisión de PR es un infierno porque el commit es irrevisable.

Requisitos previos
  • Skill instalada — git clone https://github.com/tw93/Waza ~/.claude/skills/waza
Flujo
  1. Planificar commits
    Usa la skill de commit de waza. Planifica el trabajo como una secuencia de commits atómicos antes de escribir cualquier código.✓ Copiado
    → Plan de commits numerados; cada uno es un resumen de una línea
  2. Ejecutar uno a uno
    Haz el commit 1. Para. Muéstrame el diff y el mensaje.✓ Copiado
    → Un solo commit pequeño; el mensaje sigue la convención
  3. Continuar o revisar
    Continúa con el siguiente commit, o revisa el plan si el paso 1 cambió tu comprensión.✓ Copiado
    → Siguiente commit o plan revisado

Resultado: PRs que realmente puedes revisar.

Errores comunes
  • El plan es demasiado granular (10 commits para un cambio trivial) — El objetivo predeterminado de la skill es 3-7 commits por PR; pasa --target N para anularlo
Combinar con: github

Aplicar red-green-refactor en una refactorización que vale la pena hacer

👤 Desarrolladores refactorizando código legado ⏱ ~90 min intermediate

Cuándo usarlo: Quieres refactorizar; también no quieres romper cosas.

Flujo
  1. Cubrir con tests
    Usa la skill de refactor de waza en /src/<module>.ts. Primer paso: caracteriza el comportamiento actual con tests.✓ Copiado
    → Tests para el comportamiento actual; pasando
  2. Refactorizar
    Ahora refactoriza incrementalmente. Los tests deben permanecer en verde en cada paso.✓ Copiado
    → Serie de commits de refactor, todos en verde

Resultado: Código más limpio con prueba de que no se rompió.

Errores comunes
  • 'Tests para el comportamiento actual' incluye bugs existentes — La skill señala tests sospechosos; márcalos y refactoriza esos por separado

Ejecutar una revisión estructurada de código en un PR

👤 Revisores que quieren consistencia ⏱ ~30 min beginner

Cuándo usarlo: Revisando un PR que no escribiste — fácil perderse cosas.

Flujo
  1. Recorrer el diff
    Usa la skill de revisión de waza en el PR #123. Recorre el diff hunk por hunk; verifica: corrección, nomenclatura, manejo de errores, tests, seguridad.✓ Copiado
    → Notas por hunk; cualquier problema señalado
  2. Resumen
    Escribe el resumen de la revisión — 3 puntos fuertes, 3 preocupaciones, 1 pregunta.✓ Copiado
    → Resumen al estilo publicación

Resultado: Revisiones que encuentran cosas, no teatro de 'lgtm'.

Errores comunes
  • La skill se centra en el estilo cuando hay problemas mayores — Reordena por severidad; confía en el orden
Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

waza-skill + github

Combinar con el MCP de GitHub para el ciclo de vida completo del PR

waza-skill + ccpm-skill

CCPM gestiona el ciclo de vida del issue, Waza gestiona la disciplina de ingeniería dentro

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
commit.plan task_description Al inicio de cualquier trabajo no trivial 0
refactor.tdd path, target Refactorizar con red de seguridad 0
debug.systematic symptom, context Bug que resiste las suposiciones 0
review.checklist pr_url Revisando un PR 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
N/A
Tokens por llamada
Ligero — las skills son markdown corto
Monetario
Gratis
Consejo
Los hábitos se componen — aplícalos consistentemente en lugar de solo cuando estés atascado

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno
Salida de datos: Local

Resolución de problemas

Errores comunes y soluciones

La skill sigue dividiendo commits cuando uno solo estaría bien

La unidad mínima de cambio varía; pasa un PR de ejemplo para calibración

Los tests del refactor cubren muy poco

La skill advierte cuando la cobertura es <30% en el módulo tocado — añade semillas manuales

Alternativas

Waza (技) vs otros

AlternativaCuándo usarlaContrapartida
wshobson/agentsQuieres agentes basados en roles (frontend, backend) en lugar de skills de hábitosForma diferente; ambas están bien — distintos niveles de abstracción
addyosmani/agent-skillsQuieres profundidad específica en perf web/a11yEl conjunto de Addy es para frontend web; Waza es ingeniería general

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills