waza

Waza es una colección de ocho habilidades de hábitos de ingeniería para agentes de programación con IA. La premisa es que los buenos ingenieros hacen más que escribir código: someten los requisitos a prueba, depuran hasta la causa raíz, revisan sus propios diffs y leen fuentes primarias. Waza empaqueta esos hábitos como habilidades que un agente puede ejecutar, cada una con una sola tarea y un disparador claro. ## Las ocho habilidades - /think — se usa antes de construir algo nuevo. Cuestiona el problema, somete el diseño a prueba y produce un plan completo para la toma de decisiones que otro agente puede implementar. - /ui — se usa al construir interfaces frontend. Apunta a una UI distintiva con una dirección comprometida, incluida la iteración estética guiada por capturas de pantalla. - /check — se usa después de una tarea y antes de fusionar o publicar. Revisa el diff frente a las restricciones del proyecto, verifica el resultado y gestiona las acciones aprobadas de publicación y mantenimiento. - /hunt — se usa para cualquier error, regresión o comportamiento inesperado. Depuración sistemática que confirma la causa raíz antes de aplicar una corrección. - /write — se usa al escribir o editar prosa. Reescribe la prosa para que suene natural en chino e inglés y elimina el fraseo rígido y formulario. - /learn — se usa al adentrarse en un dominio desconocido. Un flujo de trabajo de investigación de seis fases: recopilar, digerir, esquematizar, completar, refinar y luego autoevaluar y publicar. - /read — se usa para cualquier URL o PDF. Devuelve un resumen conciso o Markdown limpio para conversión, citas, referencias, guardado o investigación adicional. - /health — audita la salud del agente: Codex, Claude Code, instrucciones del proyecto, salida del verificador y mantenibilidad de IA, con una pasada de resumen consciente del presupuesto antes de la inspección profunda. Cada habilidad es una carpeta que contiene documentos de referencia, scripts auxiliares y notas sobre dificultades extraídas de fallos reales. ## Instalación Para Claude Code, Codex, Cursor y otros agentes, un solo comando npx instala las habilidades en el directorio compartido `~/.agents/skills`, con Claude Code enlazado simbólicamente. Los agentes que leen ese directorio recogen las habilidades como comandos de barra; los agentes con un directorio de habilidades privado se especifican después del indicador `-a`. Las actualizaciones usan `npx skills update -g -y`. También se admiten plugins de host para Claude Code y Codex, donde las habilidades tienen espacio de nombres (por ejemplo, `/waza:check`). Los usuarios de Claude Desktop pueden descargar un ZIP desde releases y subirlo en Customize > Skills. También hay disponible un paquete Pi. ## Encadenamiento y contexto Los usuarios deciden cómo se encadenan las habilidades. Los flujos de trabajo documentados incluyen planificar una función (/think y luego /check), publicar una corrección (/hunt, corregir, /check), investigación y escritura (/read, /learn, /write) y depurar y verificar (/hunt y luego /check). Waza solo incluye hábitos genéricos. La habilidad /check se vuelve consciente del proyecto en tiempo de ejecución al leer el contexto público del repositorio objetivo, como READMEs, manifiestos de paquetes, Makefiles y flujos de trabajo de CI, además de las restricciones de la tarea — no rutas privadas, credenciales ni tokens. ## Extras Una statusline mínima para Claude Code muestra la ventana de contexto, la cuota de 5 horas y la cuota de 7 días, codificadas por colores según el uso sin barras de progreso. Codex tiene elementos de statusline nativos configurados en `~/.codex/config.toml`. Se pueden instalar tres alternadores de reglas opcionales: entrenamiento de inglés que añade una breve corrección cuando un prompt tiene un error en inglés, barreras anti-patrón siempre activas y una sugerencia de enrutamiento que indica a los hosts que no son Claude que prefieran las habilidades de Waza cuando una solicitud coincida con sus disparadores. ## Antecedentes Waza (技) es un término japonés de artes marciales que significa técnica. El proyecto se posiciona como deliberadamente pequeño en comparación con colecciones de habilidades más pesadas, y afirma que las habilidades se construyeron a partir de proyectos reales y se refinaron a lo largo de más de 300 sesiones en 7 proyectos. Se describe como parte de una trilogía junto con Kaku (código) y Kami (documentos). Con licencia MIT.