Homunculus — плагин
Плагин Claude Code записывает вашу работу, выводит из нее небольшие правила-инстинкты и растит из них команды, скиллы и агентов
- 400 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Хуки запускают скрипты `observe.sh` и `on_stop.sh` на каждый запрос, вызов инструмента и остановку сессии
- Фоновый агент сам читает эти записи, а плагин создает в проекте новые команды, скиллы и агентов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/homunculusОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хуки запускают скрипты `observe.sh` и `on_stop.sh` на каждый запрос, вызов инструмента и остановку сессии
- Фоновый агент сам читает эти записи, а плагин создает в проекте новые команды, скиллы и агентов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Homunculus наблюдает за вашей работой в Claude Code и учится на ней. Хуки `UserPromptSubmit` и `PostToolUse` записывают каждый запрос и каждый вызов инструмента в файл `observations.jsonl`. В начале сессии навык `session-memory` запускает фонового агента-наблюдателя на модели Haiku. Он читает записи, находит повторяющиеся приемы и оформляет их как инстинкты. Инстинкт — маленькое правило с триггером, действием и уровнем уверенности от 0,3 до 0,9, например «при написании новых функций предпочитать функциональный стиль». Каждый инстинкт относится к области: стиль кода, тесты, git, отладка, организация файлов, инструменты или коммуникация. Когда в одной области набирается пять и больше инстинктов, команда `/homunculus:evolve` предлагает вырастить из них более крупную структуру: команду, скилл или специализированного агента. Данные лежат в папке `.claude/homunculus` проекта: личные инстинкты, унаследованные, файл `identity.json` и созданные команды, скиллы и агенты. Инстинкты можно выгрузить архивом `tar.gz` и передать другому человеку. При первом запуске плагин спрашивает, как вы работаете, и подстраивает тон под один из четырех типов: технический, полутехнический, нетехнический или хаотичный.
Для кого. Для тех, кто подолгу работает в Claude Code над одним проектом и хочет, чтобы повторяющиеся привычки превращались в правила, команды и скиллы без ручной записи.
Подходит, если
- Вы раз за разом поправляете агента в одном и том же, например в стиле кода или формате коммитов, и хотите зафиксировать это автоматически
- Нужно накопить повторяющиеся приемы отладки или тестирования и превратить их в отдельную команду
- В команде хотят делиться наработанными правилами: инстинкты экспортируются архивом и импортируются отдельно от личных
- Нужно проверить подход на своем проекте: плагин ставится из маркетплейса и снимается одной командой
- Нужен обзор того, что плагин успел выучить: команда `/homunculus:status` показывает состояние и путь развития
Не подходит, если
- В запросах и вызовах инструментов бывают секреты и персональные данные, а их запись в файлы проекта недопустима
- Нужно отключить любые фоновые агенты: наблюдатель запускается в начале сессии сам
- Проект общий, и записи наблюдений нельзя коммитить: папка `.claude/homunculus` лежит внутри репозитория
Пример запроса к агенту
Покажи, какие инстинкты ты выучил за последние сессии, и предложи вырастить команду из тех, что относятся к тестированиюОграничения
Версия 2.0 помечена как альфа-версия: автор целиком переписал плагин. Хуки записывают наблюдения надежно. Скиллы `session-memory` и `instinct-apply` зависят от решения Claude и срабатывают примерно в 50–80% случаев.
Эволюция в команду, скилл или агента запускается вручную командой `/homunculus:evolve` после накопления пяти инстинктов в одной области. Остальные шаги идут автоматически. Фоновый агент-наблюдатель работает на модели Haiku и тратит токены вашей подписки или ключа.
В метаданных GitHub лицензия у репозитория не указана. В конце README стоит пометка MIT.
Как отключить. Удалите плагин командой `/plugin uninstall homunculus@homunculus`, тогда хуки перестанут записывать наблюдения. Папку `.claude/homunculus` в проекте удалите вручную: в ней остаются `observations.jsonl`, инстинкты и созданные плагином команды, скиллы и агенты.
Частые вопросы
Как установить Homunculus в Claude Code?
Добавьте маркетплейс командой `/plugin marketplace add humanplane/homunculus`, установите плагин командой `/plugin install homunculus@homunculus` и запустите `/homunculus:init`. Команда init создает папки, спрашивает о вашем стиле работы и задает тон общения.
Что такое инстинкт в Homunculus?
Это минимальная выученная привычка: один триггер, одно действие, уровень уверенности от 0,3 до 0,9 и область. Хранится как файл с метаданными YAML; в нем заголовок, действие и подтверждения вроде «замечено пять случаев». Автоматически созданные инстинкты лежат в папке `personal`, полученные от других людей в `inherited`.
Чем версия 2 отличается от первой?
В первой версии наблюдение держалось на скиллах, а они срабатывают не всегда. Во второй наблюдают хуки, анализ идет в фоновом агенте Haiku, а единицей обучения стал инстинкт. Добавился обмен инстинктами через экспорт и импорт.
Как передать инстинкты коллеге?
Команда `/homunculus:export` создает архив `instincts-TIMESTAMP.tar.gz` в папке `.claude/homunculus/exports`. Коллега импортирует его командой `/homunculus:import` с путем к файлу. Чужие инстинкты попадают в папку `inherited` и не смешиваются с личными, поэтому видно, откуда взято каждое поведение.
Какие данные плагин записывает?
Хук `UserPromptSubmit` пишет ваши запросы, хук `PostToolUse` записывает вызовы инструментов, оба в `observations.jsonl`. Обработанные записи переезжают в `observations.archive.jsonl`. Хук Stop только увеличивает счетчик сессий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин самообучения для Claude Code, Codex и OpenCode: превращает исправления в правила, которым агент следует в следующих сессиях
Личный набор автора для Claude Code: команды мета-промптов и заметок на потом, скиллы для создания скиллов, хуков и MCP-серверов, аудиторы и цикл Ральфа
Рабочие процессы для Claude Code: команды /do, /omo, /bmad-pilot и другие, а код пишут Codex, Gemini или OpenCode через codeagent-wrapper
Агент Anthropic для терминала, IDE и GitHub: понимает кодовую базу, выполняет задачи и работает с git
AI Builder Club Skills
AI Builder Club — Skills
Плагин-маркетплейс для Claude Code: сделать репозиторий готовым к работе агента и запускать самоподдерживающиеся циклы
Маркетплейс плагинов Claude Code с готовыми наборами агентов, слэш-команд, хуков и скиллов плюс сайт для поиска
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Homunculus (эта запись) | нет | 400 | |
| claude-smart | нет | 789 | плагин самосовершенствования для Claude Code, Codex и OpenCode, который превращает поправки в правила |
| Self-Improving Agent | нет | 782 | скилл для OpenClaw, который записывает ошибки и поправки в файлы .learnings |
Коротко о README
Подробно разобран переход от первой версии ко второй, путь «наблюдение, инстинкт, эволюция» и дерево файлов плагина с хуками, агентом, двумя скиллами и пятью командами. Отдельные таблицы описывают надежность каждого звена, области инстинктов и режимы личности. Тесты запускаются скриптом `test-homunculus.sh`, лендинг на React и Tailwind поднимается из папки `landing`. Пригодится, чтобы заранее увидеть, какие файлы плагин создаст в проекте.