reflection — скилл для Claude Code: что делает и как установить
Анализирует ошибки вызова инструментов и замечания пользователя, сохраняя выводы в CLAUDE.md или AGENT.md. Помогает ассистенту учиться на ходу.
npx skills add davidkiss/smart-ai-skills --skill reflection -a claude-codeЧто делает reflection
Скилл включается при сбоях команд или когда разработчик поправляет поведение ассистента. Он разбирает последние реплики диалога, выявляет повторяющиеся требования и превращает их в системные правила. Скилл сохраняет настройки окружения в AGENT.md либо CLAUDE.md, а также готовит правки для других скиллов проекта.
Главный принцип работы — строгий контроль. Ассистент предлагает ровно одно короткое изменение за раз, показывая diff для файла скилла или текст для документа с инструкциями. Он не перезаписывает файлы втихую. Без прямого согласия человека правки в проект не попадут.
Какие задачи решает
- Зафиксировать замечания разработчика в
CLAUDE.mdбез ручного редактирования - Скорректировать логику существующих скиллов после неудачного вызова инструментов
- Устранить повторяющиеся ошибки ассистента в рамках одного проекта
- Сохранить новые проектные соглашения в
AGENT.md
Примеры запросов агенту
- Запомни, что тесты в этом проекте мы запускаем только через
pnpm test, и обнови правила - Команда упала с ошибкой. Проанализируй причину и предложи исправление для скилла
- Зафиксируй это замечание в
CLAUDE.md, чтобы больше так не делать
Как установить reflection
1Через Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill reflection -a claude-code2Вручную: положить файлы
~/.claude/skills/reflection/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/reflection/
1Через Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill reflection -a codex2Вручную: положить файлы
.agents/skills/reflection/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill reflection -a cursor2Вручную: положить файлы
.cursor/skills/reflection/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davidkiss/smart-ai-skills reflection2Вручную: положить файлы
.github/skills/reflection/SKILL.md1Через Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill reflection -a gemini-cli2Командой платформы
gemini skills install https://github.com/davidkiss/smart-ai-skills --path skills/reflectionВручную: положить файлы
.devin/skills/reflection/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add davidkiss/smart-ai-skills --skill reflection -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о reflection
Как установить reflection в Claude Code?
Выполните команду npx skills add davidkiss/smart-ai-skills --skill reflection -a claude-code. Также файл инструкции можно поместить напрямую в ~/.claude/skills/reflection/SKILL.md.
Что делает скилл reflection?
Он разбирает ошибки инструментов и замечания пользователя, формулируя правила поведения. Скилл предлагает точечные обновления инструкций в CLAUDE.md, AGENT.md или других скиллах.
Меняет ли reflection файлы проекта автоматически?
Нет, автоматическая запись запрещена регламентом скилла. Он всегда показывает diff или добавляемый фрагмент и ждёт явного подтверждения перед сохранением.
