Waza — инженерные привычки, упакованные в навыки для AI-агентов

Waza (waza) — японский термин из боевых искусств, означающий «техника»: приём, отточенный до автоматизма. Автор tw93 упаковал в этот репозиторий привычки, которые отличают зрелого инженера от новичка, — и превратил их в навыки, которые может выполнять AI-агент. Идея простая: хороший инженер не только пишет код, но и продавливает требования, доводит баги до первопричины, ревьюит свои диффы и читает первоисточники. У модели всё это есть «сырым», но без структуры вывод дрейфует в generic и неточную работу.

Коллекция намеренно маленькая — восемь навыков, по одному на каждую привычку, которая действительно имеет значение. Каждый навык — это папка с SKILL.md, справочной документацией, вспомогательными скриптами и «граблями» из реальных провалов.

Навыки

Установка

Основной способ — менеджер навыков:

npx skills add tw93/Waza -a claude-code codex cursor -g -y

Одна копия попадает в ~/.agents/skills — общую директорию навыков. Claude Code подключается симлинком; Codex, Cursor, Gemini CLI, Copilot, Amp, Kimi Code CLI и другие агенты, читающие эту директорию, подхватывают все восемь навыков как /check, /think и так далее. У агентов с приватной директорией навыков id указывается через -a (например, antigravity-cli или qwen-code). Обновление — npx skills update -g -y.

Для тех, кто предпочитает штатный механизм обновления хоста, есть плагин (навыки неймспейсятся как /waza:check):

# Claude Code (обновление: claude plugin update waza)
/plugin marketplace add tw93/Waza
/plugin install waza@waza

# Codex (обновление: codex plugin marketplace upgrade waza, затем codex plugin add waza@waza)
codex plugin marketplace add tw93/Waza
codex plugin add waza@waza

Claude Desktop: скачайте waza.zip, откройте Customize > Skills > «+» > Create skill и загрузите ZIP. Обновление — «…» на карточке навыка, Replace, загрузка свежего ZIP.

Pi: pi install npm:@tw93/waza, обновление — pi update npm:@tw93/waza.

Связывание навыков в workflow

Waza оставляет решение о связывании за вами. Каждый навык останавливается на запрошенном результате; явно авторизованный workflow продолжается без запроса одобрения каждого перехода.

Типовые сценарии:

• Спланировать фичу: /think → одобрение → «implement X» → /check → мердж
• Зарелизить фикс: /hunt → фикс → /check → релиз/публикация/пуш/доведение issue до конца
• Исследовать и написать: /read (сбор источников) → /learn (синтез) → /write (шлифовка)
• Отладить и проверить: /hunt (поиск первопричины) → фикс → /check (ревью изменений)

Контекст проекта

Waza поставляется только с generic-инженерными привычками. /check становится осведомлённым о проекте в рантайме: читает публичный контекст целевого репозитория — README, package-манифесты, Makefile, CI-workflow — и ваши ограничения задачи. Приватные пути, креденшелы и токены никогда не читаются.

Дополнительно

Statusline. Минимальный статусбар для Claude Code: контекстное окно, квота на 5 часов и на 7 дней. Цветовая индикация по использованию, без прогресс-баров и лишнего шума. У Codex нативные элементы статусбара — добавляются в ~/.codex/config.toml:

[tui]
status_line = ["model-with-reasoning", "current-dir", "context-used", "five-hour-limit", "weekly-limit"]
status_line_use_colors = true

Codex показывает оставшуюся квоту; статусбар выше для Claude Code — израсходованный процент (upstream пока не отдаёт five-hour-used / weekly-used).

Опциональные правила. Три независимых переключателя (агент заменяется на codex или antigravity-cli):

• English coaching — короткая корректировка, когда в промпте есть ошибка английского
• Anti-patterns — постоянные guardrails между навыками: сначала прочитай, без расширения скоупа, без непрошеных сводок
• Waza-routing — подсказка не-Claude хостам предпочитать навыки Waza, когда запрос совпадает с их триггерами

Почему Waza

Инструменты вроде Superpowers и gstack мощные, но тяжёлые: слишком много навыков и конфигурации. Waza остаётся маленькой — восемь навыков для привычек, которые действительно важны, у каждого одна работа и понятный триггер. Коллекция собрана из реальных проектов и отточена на 300+ сессиях в 7 проектах, каждая грабля восходит к реальному провалу. Навык /health вырос из шестислойного фреймворка Claude Code, описанного в этом посте.

Проект — часть трилогии: Kaku пишет код, Waza дрессирует привычки, Kami выпускает документы. По замыслу автора это семья: Kaku — отец, Waza — старшая сестра, Kami — младшая.

Каждый навык Waza формулирует результат, красные линии и способ проверки результата — и отступает, позволяя модели выбрать путь. По мере улучшения моделей такая сдержанность накапливает сложный процент.

Итог

Восемь навыков, один на привычку, с проверкой результата. Waza не пытается заменить методологию — она тренирует то, что уже знает хороший инженер, но в формате, который агент способен выполнить. Если ваши агенты выдают generic-результаты и вам не хватает маленькой коллекции, которая работает из коробки в Claude Code, Codex и Cursor — это хороший кандидат.

Лицензия MIT, проект открыт для контрибуций.