Документация

Общие навыки и инструкции для Claude Code и Codex

Храните комплект файлов навыка в одном локальном Hub и подключайте его к нужным поддерживаемым клиентам. Agent Hub работает с Claude Code, Codex и DeepSeek Harness. Общие инструкции доставляются отдельным управляемым блоком, поэтому личные заметки клиента могут оставаться на месте.

Руководство относится к текущему исходному коду. Сначала установите и создайте Hub по быстрому старту.

Импортируйте навык, которым уже пользуетесь

Начните с просмотра плана:

ahub import skills --dry-run

План читает поддерживаемые пользовательские папки навыков включённых клиентов и показывает, что будет скопировано в Hub. Если у двух клиентов разные комплекты с одним именем, изучите оба и выберите источник. Импорт не назначает победителя молча.

Для одного известного навыка с явным предпочтением источника:

ahub import skills:my-skill --prefer codex --dry-run

Замените my-skill на настоящее имя навыка. Используйте точную команду применения из просмотренного плана. Если источник изменился, получите новый план. Импорт оставляет исходные папки клиентов на месте и пока не подключает навык к другим клиентам.

Добавьте свой локальный навык

ahub skill add /path/to/my-skill --dry-run

После просмотра и применения плана Hub скопирует локальный комплект вместе со справочными материалами и ресурсами. Скрипты навыка при этом не запускаются. Команда не принимает удалённые URL: сначала установите или проверьте доверенный локальный комплект. Для подключения к Codex в метаданных файла навыка нужны имя и описание.

Подключите выбранные копии из Hub

ahub sync --area skills --dry-run

Проверьте затронутые клиенты и пути, затем используйте точную команду применения из плана. Hub создаёт отдельные ссылки на комплекты и сохраняет остальные навыки. У Codex и DeepSeek Harness может быть одна физическая пользовательская папка навыков; план перечисляет все затронутые клиенты. Отличающиеся локальные копии требуют явного выбора замены.

Перезапустите нужные сессии клиентов и проверьте их каталоги навыков. Наличие ссылки ещё не доказывает, что клиент включил навык или агент его вызвал. Навыки проектов, плагинов и администратора остаются под управлением клиентов.

Если нужна первоначальная настройка с импортом MCP и доставкой уже существующего общего контекста, используйте интерактивный сценарий:

ahub quick

Он показывает план и спрашивает перед применением. Если нужен только один сервер, см. общие настройки MCP.

Поделитесь небольшим набором общих правил

Положите общие правила в instructions/AGENTS.md внутри Hub. По умолчанию Hub находится в ~/.agent-hub. Например, там можно хранить соглашения о тестах и ревью, а факты о конкретном репозитории оставить рядом с его кодом.

Посмотрите план доставки общего контекста:

ahub sync --area context --dry-run

Он доставляет общие правила и существующий индекс общей памяти. Claude получает импорты, Codex и DeepSeek Harness — управляемые текстовые блоки. Личный текст вне принадлежащего Hub блока сохраняется. Если блок изменён снаружи или его перекрывает override Codex, доставка останавливается до разбора ситуации.

Личные глобальные инструкции не импортируются в общие правила автоматически. Выберите, чем стоит делиться. Эта операция не объединяет всю нативную память клиентов и не импортирует чаты: у памяти проекта и сохранения чатов отдельные области действия.

Измените один раз и проверьте результат

Ссылки навыков ведут на основной комплект в Hub. С общими инструкциями иначе: после изменения правил снова просмотрите и примените синхронизацию контекста, чтобы обновить скопированные блоки. Hub не согласует автоматически все внешние изменения в этих областях.

Для пары файлов может хватить общей папки или репозитория, которые вы поддерживаете вручную. Hub добавляет сбор, планы доставки по клиентам и записанное восстановление. Поддерживаемые пути, метаданные, ограничения ссылок и откат описаны в правилах работы с контентом.