Об этом проекте

Waza — это набор из восьми навыков-привычек инженера для ИИ-агентов, пишущих код. Исходная предпосылка: хорошие инженеры делают больше, чем просто пишут код, — они проверяют требования на прочность, отлаживают до первопричины, ревьюят собственные диффы и читают первоисточники. Waza упаковывает эти привычки в навыки, которые агент может запускать; у каждого одна задача и понятный триггер. ## Восемь навыков - /think — используется перед созданием чего-либо нового. Ставит проблему под сомнение, проверяет дизайн на прочность и выдаёт готовый к реализации план, который может выполнить другой агент. - /ui — используется при создании фронтенд-интерфейсов. Цель — самобытный UI с выраженным направлением, включая итерации по эстетике на основе скриншотов. - /check — используется после задачи и перед слиянием или релизом. Ревьюит дифф на соответствие ограничениям проекта, проверяет результат и выполняет одобренные действия по релизу и сопровождению. - /hunt — используется для любого бага, регрессии или неожиданного поведения. Систематическая отладка, которая подтверждает первопричину до применения исправления. - /write — используется при написании или редактировании прозы. Переписывает текст так, чтобы он звучал естественно на китайском и английском, и убирает сухие, шаблонные формулировки. - /learn — используется при погружении в незнакомую область. Шестифазный исследовательский процесс: сбор, осмысление, план, наполнение, шлифовка, затем саморевью и публикация. - /read — используется для любого URL или PDF. Возвращает краткое резюме или чистый Markdown для конвертации, цитат, ссылок, сохранения или дальнейшего исследования. - /health — аудит состояния агента: Codex, Claude Code, инструкции проекта, вывод верификатора и поддерживаемость ИИ, с учётом бюджета перед глубокой проверкой. Каждый навык — это папка с справочной документацией, вспомогательными скриптами и заметками о подводных камнях, собранными из реальных сбоев. ## Установка Для Claude Code, Codex, Cursor и других агентов одна команда npx устанавливает навыки в общий каталог `~/.agents/skills`, при этом Claude Code подключается через симлинк. Агенты, которые читают этот каталог, подхватывают навыки как слеш-команды; агенты с собственным каталогом навыков указываются после флага `-a`. Обновление выполняется командой `npx skills update -g -y`. Также поддерживаются хост-плагины для Claude Code и Codex, где навыки получают пространство имён (например, `/waza:check`). Пользователи Claude Desktop могут скачать ZIP из релизов и загрузить его в разделе Customize > Skills. Доступен и пакет Pi. ## Цепочки и контекст Пользователи сами решают, как объединять навыки в цепочки. В документации описаны рабочие процессы: планирование фичи (/think, затем /check), выпуск исправления (/hunt, исправление, /check), исследование и написание (/read, /learn, /write), а также отладка с проверкой (/hunt, затем /check). Waza поставляет только универсальные привычки. Навык /check становится проектно-зависимым во время выполнения, читая публичный контекст целевого репозитория — README, манифесты пакетов, Makefile и CI-воркфлоу, а также ограничения задачи, — но не приватные пути, учётные данные или токены. ## Дополнительно Минималистичная строка статуса для Claude Code показывает окно контекста, 5-часовую квоту и 7-дневную квоту с цветовой индикацией использования без прогресс-баров. У Codex нативные элементы строки статуса настраиваются в `~/.codex/config.toml`. Можно установить три опциональных переключателя правил: English coaching, который добавляет короткое исправление, если в промпте есть ошибка в английском; постоянно активные защитные правила против анти-паттернов; и подсказку маршрутизации, которая советует хостам, отличным от Claude, предпочитать навыки Waza, когда запрос совпадает с их триггерами. ## Предыстория Waza (技) — японский термин из боевых искусств, означающий технику. Проект позиционирует себя как намеренно компактный по сравнению с более тяжёлыми коллекциями навыков и заявляет, что навыки создавались на реальных проектах и оттачивались в более чем 300 сессиях на 7 проектах. Описывается как часть трилогии наряду с Kaku (код) и Kami (документы). Лицензия MIT.