waza

Waza est une collection de huit compétences liées aux habitudes d'ingénierie pour les agents de codage IA. Le postulat est que les bons ingénieurs font plus qu'écrire du code : ils testent les exigences sous pression, déboguent jusqu'à la cause racine, relisent leurs propres diffs et lisent les sources primaires. Waza regroupe ces habitudes sous forme de compétences qu'un agent peut exécuter, chacune avec une seule fonction et un déclencheur clair. ## Les huit compétences - /think — utilisé avant de construire quoi que ce soit de nouveau. Remet en question le problème, teste la conception sous pression et produit un plan complet de décision qu'un autre agent peut mettre en œuvre. - /ui — utilisé lors de la construction d'interfaces frontend. Vise une UI distinctive avec une direction affirmée, y compris une itération esthétique pilotée par captures d'écran. - /check — utilisé après une tâche et avant la fusion ou la publication. Examine le diff par rapport aux contraintes du projet, vérifie le résultat et gère les actions approuvées de publication et de maintenance. - /hunt — utilisé pour tout bug, régression ou comportement inattendu. Débogage systématique qui confirme la cause racine avant d'appliquer un correctif. - /write — utilisé lors de la rédaction ou de l'édition de prose. Réécrit la prose pour qu'elle sonne naturelle en chinois et en anglais et supprime les formulations rigides et stéréotypées. - /learn — utilisé pour plonger dans un domaine inconnu. Un flux de recherche en six phases : collecter, digérer, esquisser, compléter, affiner, puis auto-réviser et publier. - /read — utilisé pour toute URL ou PDF. Renvoie un résumé concis ou un Markdown propre pour conversion, citations, sauvegarde ou recherche ultérieure. - /health — audite la santé de l'agent : Codex, Claude Code, instructions du projet, sortie du vérificateur et maintenabilité de l'IA, avec un passage de résumé tenant compte du budget avant une inspection approfondie. Chaque compétence est un dossier contenant des documents de référence, des scripts d'assistance et des notes sur les pièges tirés d'échecs réels. ## Installation Pour Claude Code, Codex, Cursor et d'autres agents, une seule commande npx installe les compétences dans le répertoire partagé `~/.agents/skills`, avec Claude Code lié par lien symbolique. Les agents qui lisent ce répertoire récupèrent les compétences sous forme de commandes slash ; les agents disposant d'un répertoire de compétences privé sont spécifiés après le drapeau `-a`. Les mises à jour utilisent `npx skills update -g -y`. Des plugins hôtes sont également pris en charge pour Claude Code et Codex, où les compétences sont dotées d'un espace de noms (par exemple `/waza:check`). Les utilisateurs de Claude Desktop peuvent télécharger un ZIP depuis les releases et le téléverser sous Personnaliser > Compétences. Un paquet Pi est également disponible. ## Enchaînement et contexte Les utilisateurs décident comment les compétences s'enchaînent. Les flux documentés incluent la planification d'une fonctionnalité (/think puis /check), la livraison d'un correctif (/hunt, correction, /check), la recherche et la rédaction (/read, /learn, /write), et le débogage-vérification (/hunt puis /check). Waza ne fournit que des habitudes génériques. La compétence /check devient consciente du projet à l'exécution en lisant le contexte public du dépôt cible, comme les README, les manifestes de paquets, les Makefiles et les flux CI, ainsi que les contraintes de tâche — pas les chemins privés, les identifiants ou les jetons. ## Extras Une barre d'état minimale pour Claude Code affiche la fenêtre de contexte, le quota de 5 heures et le quota de 7 jours, avec un code couleur selon l'utilisation, sans barres de progression. Codex dispose d'éléments de barre d'état natifs configurés dans `~/.codex/config.toml`. Trois bascules de règles optionnelles peuvent être installées : un coaching en anglais qui ajoute une courte correction lorsqu'une invite contient une erreur d'anglais, des garde-fous anti-modèles toujours actifs, et une indication de routage indiquant aux hôtes non-Claude de préférer les compétences Waza lorsqu'une requête correspond à leurs déclencheurs. ## Contexte Waza (技) est un terme japonais d'arts martiaux signifiant technique. Le projet se positionne comme volontairement léger par rapport aux collections de compétences plus lourdes, et indique que les compétences ont été construites à partir de projets réels et affinées au cours de plus de 300 sessions sur 7 projets. Il est décrit comme faisant partie d'une trilogie aux côtés de Kaku (code) et Kami (documents). Sous licence MIT.