Перейти к содержанию
zoryn/ maintainer-assistant

zoryn agent

Интеграция zoryn с локальными ИИ-агентами (Claude Code, Codex, opencode, …). Пока одна группа подкоманд: agent skill.

zoryn agent skill

Управляет встроенным Agent Skill zoryn в локальных ИИ-агентах, чтобы они подгружали знания о workflow сопровождения пакетов ALT по требованию.

Скилл — это папка с файлом SKILL.md, один формат читают Claude Code, Codex и opencode. Полный скилл поставляется с пакетом zoryn по пути /usr/share/zoryn/skills/zoryn/SKILL.md. Вместо копирования его в каждый агент zoryn agent skill install пишет маленький ссылочный SKILL.md (frontmatter скилла, чтобы агент его обнаружил, плюс указатель на файл из пакета) в каталог skills каждого агента.

Так остаётся единый источник истины, обновляемый вместе с пакетом. Это работает именно потому, что скилл zoryn полезен только там, где установлен zoryn, — значит файл-цель всегда на месте, в том числе внутри zoryn devenv, где его нативно даёт пакет (без зависимости от проброса ~/.claude).

Каталоги по умолчанию покрывают все три агента:

  • ~/.claude/skills/zoryn/ — Claude Code, opencode
  • ~/.agents/skills/zoryn/ — Codex, opencode

zoryn agent skill install

Записывает ссылочный SKILL.md в каталоги skills агентов.

Опции:

  • --dir DIR — установить в DIR вместо каталогов по умолчанию (можно повторять). Ведущий ~/ разворачивается в домашний каталог.
  • --force — перезаписать ранее установленную ссылку zoryn. Папка, которую zoryn не создавал (ваш собственный скилл, посторонние файлы), отклоняется в любом случае — ничего вашего не удаляется.
zoryn agent skill install                                 # установить в каталоги агентов по умолчанию
zoryn agent skill install --force                         # переустановить с перезаписью
zoryn agent skill install --dir ~/.config/opencode/skills # установить только в указанный каталог

После установки перезапустите агента (или начните новую сессию), чтобы он подхватил скилл.

zoryn agent skill uninstall

Удаляет папку скилла из каталога skills каждого агента (обратное к install). Удаляются только папки, установленные zoryn (с его маркером-ссылкой); папка, написанная вами, остаётся нетронутой. --dir выбирает конкретные каталоги.

zoryn agent skill uninstall
zoryn agent skill uninstall --dir ~/.config/opencode/skills

zoryn agent skill status

Для каждого каталога skills сообщает, установлен ли скилл zoryn, на что он указывает и существует ли файл-цель (отсутствие цели отмечается). Возвращает ненулевой код, если какая-то установка сломана (висячая ссылка) или чужая — чтобы скрипты могли это обнаружить.

zoryn agent skill status

zoryn agent skill path

Печатает абсолютный путь к поставляемому SKILL.md, одной строкой — удобно в скриптах.

zoryn agent skill path

zoryn agent skill show

Печатает полный встроенный SKILL.md в stdout, без участия агента.

zoryn agent skill show