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

Навыки, общий контекст и передача проекта

Эти возможности используют ту же локальную блокировку Hub, что MCP. Явные изменения начинаются с preview. Для применения нужен --apply --expect <revision> свежего плана. Оригиналы и закрытые копии сохраняются до записи. Импорт и доставка не скачивают и не исполняют скрипты навыка.

Навыки

ahub skill ls --json
ahub skill add /path/to/my-skill --dry-run
ahub import skills --dry-run
ahub import skills:my-skill --prefer codex --dry-run
ahub sync --area skills --dry-run
ahub sync --area skills --client codex --replace=my-skill --dry-run
ahub skill rm my-skill --dry-run

skill add копирует локальную папку в hub/skills/<name>, включая бинарные материалы, ссылки на материалы и права исполняемых файлов без запуска кода. Допускается путь SKILL.md. --name задаёт псевдоним папки, не меняя метаданные навыка: согласуйте их с ожидаемым именем в каталоге. --overwrite явно разрешает заменить копию Hub. Сетевые URL отвергаются: сначала используйте доверенный внешний установщик и импортируйте локальный результат.

Импорт читает основные и дополнительные пользовательские папки включённых клиентов. Разные копии требуют явного --prefer; существующий навык Hub сохраняется без --overwrite. Папки клиентов не меняются. Ни MCP, ни навыки не выбирают победителя различающихся источников неявно.

Доставка создаёт отдельные ссылки, не заменяя всю общую папку. Claude использует пользовательский корень навыков. Codex и DSH обычно разделяют .agents/skills; DSH также учитывает DSH_AGENTS_HOME. Дополнительные локальные копии тоже проверяются: одинаковые становятся ссылками, разные конфликтуют до точной проверенной замены для одного клиента. Так старая папка с более высоким приоритетом не затенит общий оригинал. Физическая цель меняется один раз и перечисляет всех затронутых клиентов. Отключённый клиент, разделяющий цель, блокирует её изменение.

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

Пространства Claude synced и anthropic-skills, управляемые учётной записью, пропускаются. Проектные, plugin- и администраторские навыки, а также видимость вроде Codex skills.config остаются ответственностью клиента. Наличие ссылки не доказывает включение или вызов навыка: проверьте настоящий каталог клиента.

Вложенные относительные ссылки должны разрешаться внутри набора. Абсолютные и выходящие наружу отклоняются, чтобы не изменить смысл копии. Имена, отличающиеся только регистром, отклоняются для переносимости. Перед доставкой Codex нужны YAML-поля name и description в SKILL.md; старый текст только для Claude всё ещё можно хранить и доставлять Claude.

Инструкции и общая память

Общие правила размещаются в hub/instructions/AGENTS.md. Операции памяти поддерживают структурированные общие и проектные записи и свой блок индекса в hub/memory/MEMORY.md; рукописный индекс и файлы фактов остаются отдельно и доступны для чтения.

ahub sync --area context --dry-run
ahub sync --area context --client codex --dry-run

Цели — пользовательский CLAUDE.md Claude, глобальный AGENTS.md Codex и домашний AGENTS.md DSH. Claude получает экранированные импорты @ исходников Hub. Codex и DSH — текст правил и индекса с явным путём общей памяти. Факты читаются агентами по необходимости. Это доставка контекста, а не слияние или перенос нативной автопамяти. Нативная память, диалоги и hooks остаются отдельными.

Меняется только помеченный управляемый блок; текст снаружи побайтно сохраняется. Правки внутри блока, отсутствующие или повторные маркеры и неизвестное владение блокируют обновление. Непустой AGENTS.override.md Codex блокирует доставку, поскольку затеняет глобальный файл. Ссылки и каталоги вместо целевых инструкций требуют ручного решения. Общие источники могут быть ссылками, но рекурсивное пересечение источника и цели отклоняется. Бюджет создаваемых инструкций — 32 KiB; при превышении сократите источник.

Если оба источника исчезают или пустеют, sync убирает свой блок. Созданный им файл удаляется только при отсутствии личного текста. Preview UI показывает действия и пути, а не тела правил и памяти.

Подготовка репозитория

ahub init-repo --dry-run
ahub init-repo /path/to/repository --dry-run

Запускайте в существующем Git-репозитории с готовым Hub. Корень определяется и из подпапки. Команда не создаёт Git, не добавляет файлы в staging и не делает коммит.

Файл	Назначение	Существующее содержимое
`AGENTS.md`	Общий процесс проекта для агентов	Меняется только свой блок процесса
`.agents/state/PROJECT.md`	Устойчивая архитектура, решения и ограничения	Сохраняется, не генерируется заново
`.agents/state/NOW.md`	Текущая задача, прогресс, проверки и следующий шаг	Сохраняется, не генерируется заново
`CLAUDE.md`	Явный импорт `@AGENTS.md`	Личный текст сохраняется; активные импорты не дублируются

Начальные заметки прямо говорят, что факты и прогресс пока не записаны. Init-repo не угадывает архитектуру и не заявляет успешных проверок. Это обычные файлы репозитория, которые можно коммитить с веткой. Шаблоны в hub/templates/repo/ используют те же относительные пути. Существующий CLAUDE.md со ссылкой на AGENTS.md сохраняется. Другие ссылки инструкций требуют проверки.

В UI есть импорт и доставка Skills, доставка контекста на Instructions/Memory, управление записями и Prepare repository на Repos & tasks. Проектные действия привязаны к выбранному проверенному проекту либо стартовой папке; произвольные пути через HTTP не принимаются. Переключение сбрасывает все планы. Они одноразовые, действуют пять минут и проверяют изменённые входы.

Восстановление и ограничения

Операции контента выводят backup ID content-…. Проверьте откат через restore <id> --dry-run. Сам restore тоже сохраняет копию. Изменённые файлы, каталоги и привязки блокируют старые планы.

Reset восстанавливает также первые оригиналы навыков клиентов и файлов проекта и контекста. Они находятся в <AGENT_HUB_HOME>.recovery/artifacts/ вне активного Hub, могут содержать личный текст и секреты и не зашифрованы. Повреждённые данные, чужие recovery-ссылки и изменённые привязки блокируют возврат. --archive-changes архивирует внешние правки обычных файлов и папок перед восстановлением; перенаправленные ссылки остаются заблокированными.

Файлы и каталоги заменяются через временные данные рядом с целью и компенсирующий откат. Между rename каталога есть короткий промежуток; общей атомарной транзакции диска нет. Внешние клиенты не соблюдают блокировку Hub. Журнал хранит намерения до и после, но потеря питания, ACL/xattrs и сквозная работа Windows не входят в проверенную гарантию. Прерванная очистка может оставить .agent-hub-*.old/.new: сохраните указанные данные для ручного восстановления, не удаляя неизвестное.

Проверенные контракты клиентов

Поиск инструкций Codex и метаданные и обнаружение навыков.
Импорты инструкций Claude и навыки.
Глобальные инструкции DSH и корни навыков. Пользовательский профиль может отключить эти плагины; доставка не включает их автоматически.

Одна запись — одно направление

import skills:NAME --source CLIENT --overwrite принимает ровно один навык выбранного клиента в Hub, sync --area skills --client CLIENT --only=NAME --replace=NAME доставляет Hub этому клиенту. MCP использует тот же контракт через import mcp:NAME и sync --only=NAME. Сначала preview, затем точное применение. --only сохраняет владение остальными записями. Общие физические папки по-прежнему перечисляют всех клиентов и защищают отключённых. Оба направления доступны прямо в карточках UI.