learn-codebase — скилл
Сократовский наставник учит кодовую базу вопросами и повторением, а прогресс записывает в журнал обучения.
- 105 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл ведет разговор и записывает только журнал обучения в проекте.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/learn-codebaseОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл ведет разговор и записывает только журнал обучения в проекте.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
learn-codebase — скилл-антивайбкодинг: агент ведет вас по проекту вопросами и не торопится с ответом. Сначала он спрашивает, чему вы хотите научиться, затем просит предсказать результат до показа кода, поэтому пробел в понимании не проскочить. Заметив непонимание, например в работе `AbortController`, он коротко объясняет и возвращается к вопросам. Прогресс хранится в журнале `.claude/learning-journal.md`: какие темы вы знаете уверенно, а где еще блефуете. В новой сессии агент читает журнал и продолжает с места остановки. Занятие заканчивается конкретными вариантами следующих шагов. Вызывается скилл командой `/learn-codebase` в проекте, который нужно изучить.
Для кого. Инженерам, которые входят в чужой или зрелый репозиторий, и контрибьюторам, готовящим первый серьезный pull request.
Подходит, если
- Новый сотрудник за неделю должен понять архитектуру большого монорепозитория.
- Перед рефакторингом унаследованного модуля нужно проверить, что вы понимаете его, а не угадываете.
- Автор готовит pull request и хочет защитить его на ревью без показной уверенности.
- Занятия идут с перерывами, и агент должен помнить, что уже разобрано.
Не подходит, если
- Нужен быстрый патч без объяснений: обычный режим агента подойдет лучше.
- Идет быстрое прототипирование с нуля, где скорость важнее глубины.
- Хочется получить готовый код: скилл сначала задает вопросы и отвечает не сразу.
Пример запроса к агенту
/learn-codebase — помоги разобраться в архитектуре, прежде чем я трону код, и проверяй меня вопросами.Ограничения
Скилл ведет занятие вопросами, поэтому на быстрый ответ рассчитывать не стоит: скилл нацелен на запоминание, скорость вторична. Журнал лежит в проекте в `.claude/learning-journal.md`, и его нужно хранить вне общего репозитория, если заметки личные. Подсказки ввода Claude Code выдают ответы раньше времени, а скилл не может их отключить: подсказки выключают через `/config` или переменной `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false`. Скилл напоминает об этом один раз на проект.
Как отключить. Удалите папку скилла из каталога скиллов (`~/.claude/skills/learn-codebase` или `.claude/skills/learn-codebase`). Файл `.claude/learning-journal.md` остается в проекте и удаляется вручную.
Частые вопросы
Как поставить скилл?
Выполните `npx skills add ktaletsk/learn-codebase -g` для всех проектов или без `-g` для текущего. Агента можно выбрать флагом `-a`, например `-a cursor`.
Как поставить вручную?
Выполните `git clone https://github.com/ktaletsk/learn-codebase ~/.claude/skills/learn-codebase` для личного скилла или клонируйте в `.claude/skills/` проекта.
Как начать занятие?
Откройте проект, который хотите изучить, и вызовите `/learn-codebase`. Агент спросит о цели: новая функция, баг или ревью.
Что хранит журнал обучения?
Темы, которые вы знаете уверенно, и те, где есть пробелы, а также удачные моменты понимания. В следующей сессии агент продолжает с них.
Как обновить скилл?
Выполните `npx skills update`, для глобальной установки добавьте `-g`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл для Claude Code и Codex, который во время кодинга предлагает короткие учебные упражнения, чтобы разработчик учился, а не только принимал сгенерированный к
Скилл помогает разобраться в кодовой базе через вопросы: пользователь сам восстанавливает причины архитектурных решений.
OwnYourCode делает Claude Code наставником: агент задает вопросы и ревьюит код, а человек пишет его сам и понимает каждую строку
Набор из 11 скиллов для Claude Code, Codex и других агентов: от понимания задачи до публикации сайта по ссылке и итогового отчета.
Скилл запускает полный рефакторинг, после которого агентам проще читать код: ищет скрытые связи и лишние зависимости.
Скилл для Claude Code, который передает задачи в командную строку Codex от OpenAI для анализа, ревью и правок кода
Коротко о README
В репозитории скилл `SKILL.md`, шаблон журнала `JOURNAL-TEMPLATE.md`, шаблоны вопросов `QUESTION-PATTERNS.md` и README на английском и китайском. Метод строится на сократовских вопросах, предсказании до ответа и активном вспоминании.
Бейдж для README
Исходный SKILL.md
---
name: learn-codebase
description: >
Socratic tutor that teaches codebase understanding through questioning,
challenges, and active recall. Invoke with /learn-codebase when onboarding
to a new codebase or deepening understanding of existing code.
Maintains a learning journal that tracks mastery and schedules reviews.
disable-model-invocation: true
---
# Codebase Learning Tutor
You are a Socratic tutor helping the user deeply understand this codebase. Your
primary goal is to BUILD UNDERSTANDING IN THE USER'S HEAD through questioning
and active recall—not to simply answer questions or generate code.
## Core Philosophy
**Ask before telling.** Always give the learner a chance to figure things out.
**Predict before revealing.** Have them predict behavior before showing execution.
**Challenge productively.** Questions should be just beyond current ability.
**Track progress.** Update the learning journal frequently—don't wait until session end.
**Find their angle.** Discover what aspects genuinely interest the learner.
**Keep it concise.** Short responses, more exchanges. Don't lecture.
## Using AskUserQuestion Tool
Use the `AskUserQuestion` tool for structured choices. It renders a nice multiple-choice UI in the terminal, making interactions smoother.
**When to use it:**
- Interest discovery (goal, learning style)
- Session focus selection
- Quiz questions with discrete answers
- Session end options (continue, pause, switch topics)
- Difficulty calibration ("Was that too easy / just right / too hard?")
**Example usage for session start:**
```
AskUserQuestion with:
- question: "What's your goal with this codebase?"
- options: ["Contributing features", "Fixing bugs", "Code review", "General exploration"]
```
**Example for session end:**
```