arjunpatel7/shikhu

Shikhu — это инструмент для разработчиков, которые хотят разобраться в своей кодовой базе, особенно если она сгенерирована AI. Он создаёт квизы по файлам и показывает, насколько полно вы понимаете код.

Ключевые возможности

• Генерация квизов по файлам кодовой базы через OpenRouter
• Отслеживание покрытия знаний: доля файлов с подтверждёнными golden-вопросами
• Навык /shikhu-study для пошагового разбора непонятных файлов с агентом
• Навык /shikhu-inquiry сохраняет ваши вопросы как заготовки для будущих квизов
• Локальная база coverage.db и файл .quizignore для настройки исключений
• Работает как CLI в терминале и в связке с coding-агентами (Claude Code, Codex, Cursor)

Для каких задач подходит

• Изучение незнакомой кодовой базы, сгенерированной AI
• Подготовка к работе с legacy-кодом или новым проектом
• Проверка собственного понимания после рефакторинга или генерации кода
• Онбординг новых разработчиков в проект через интерактивные квизы
• Тренировка памяти по ключевым файлам и архитектуре

Подробнее

Shikhu состоит из двух частей: CLI-утилиты и набора навыков (skills) для coding-агента. CLI генерирует вопросы по выбранным файлам, проводит квиз и ведёт статистику. Покрытие знаний считается как доля файлов, для которых у вас есть три golden-вопроса — вопросов, на которые вы ответили правильно и подтвердили, что они действительно проверяют понимание файла. Это похоже на покрытие тестами, но для вашего понимания кода.

Для работы требуется ключ OpenRouter API — через него Shikhu обращается к моделям для генерации вопросов и суммаризации. По умолчанию используется быстрая diffusion-модель Mercury 2.5 от Inception. Навыки /shikhu-study и /shikhu-inquiry устанавливаются командой shikhu init в директорию навыков агента (например, .claude/skills/ для Claude Code). Первый помогает разобрать непонятный файл по шагам, второй сохраняет ваши вопросы как семена для будущих квизов, а слабые места учитываются при следующих генерациях.

Важно: Shikhu не анализирует код автоматически без вашего участия — это инструмент для активного обучения. Он не заменяет чтение кода, а структурирует процесс. Локальная база coverage.db и файл .quizignore позволяют исключать служебные файлы из квизов. Инструмент распространяется под лицензией MIT.