Zoku: Инструмент для автоматического обнаружения повторяющихся рабочих процессов в коде Claude

Zoku — это инструмент, созданный на основе Claude Code, который отслеживает ваши сессии Claude Code для обнаружения и автоматизации повторяющихся рабочих процессов. Он был разработан после того, как разработчик заметил, что ежедневно выполняет одни и те же последовательности действий — например, поиск через grep, открытие файла, редактирование, запуск тестов и исправление проблем с линтингом — даже не осознавая этого.

Как это работает

Zoku интегрируется с системой событий Claude Code с использованием определённых хуков: hookSpecificOutput, PostToolUse, Stop, SessionStart и UserPromptSubmit. Он незаметно записывает каждое действие инструмента во время ваших сессий. После сбора данных из нескольких сессий он анализирует последовательности, чтобы найти паттерны, например, «Grep, затем Read, затем Edit, затем Bash, затем Bash», появляющиеся в нескольких сессиях.

Когда вы начинаете новую сессию, Zoku сообщает Claude об обнаруженных паттернах, позволяя Claude проактивно предлагать или автоматически выполнять выявленные рабочие процессы.

Ключевые особенности и детали

• Захватывает ответы инструментов, включая коды завершения и ошибки.
• Нормализует имена инструментов MCP (например, преобразует mcp__github__push_files в github:push_files).
• Записывает пользовательские запросы, чтобы в конечном итоге соотнести намерения с фактическим использованием инструментов.
• Паттерны сохраняются при сжатии контекста Claude Code и автоматически повторно внедряются.
• Не требует настройки и не имеет внешних зависимостей.
• Все данные остаются локальными, хранятся в ~/.zoku/; ничего не отправляется внешним образом.
• Текущая версия 0.1.2, с 67 прошедшими тестами на macOS, Windows и Linux.

Установка и использование

Установка через pip: pip install zoku

Команда настройки: python -m zoku setup

После установки используйте Claude Code как обычно. После завершения двух или более сессий вы можете просмотреть обнаруженные паттерны с помощью: python -m zoku patterns

Статус разработки и планы на будущее

Инструмент находится на ранней стадии разработки, но активно поддерживается. Запланированные функции включают воспроизведение рабочих процессов, агрегацию паттернов между проектами и трансляцию между агентами. Последнее позволит записать рабочий процесс в Claude Code и воспроизвести его в другом агенте, например, в Cursor.

Исходный код доступен на GitHub по адресу https://github.com/kasparovabi/zoku.