Навыки ИИ-агентов для Битрикса — проверяемые

ИИ-агент пишет код в коробочном Битрикс24 и БУС по канону модуля, а не по догадкам. Здесь — правила, по которым навык пишется, и проверка, что ему можно верить: lint, eval, стенд.

С чего начать

Автору модуля для коробки Битрикс24 или Битрикс: Управление сайтом:

  1. Прочитать стандарт — 11 правил на одну страницу.
  2. Взять заготовку репозитория и написать первый навык.
  3. Проверить: npx bxshef lint --dir .agents/skills --code <исходники модуля>, затем eval — как это устроено.
  4. В CI — готовый GitHub Action bx-shef/skills-standard/action@v1.

Пользователю ваших навыков достаточно npx skills add <owner>/<repo> — установщик skills, своего здесь нет.

Частые вопросы

Что такое навык?
Папка со SKILL.md по открытому стандарту Agent Skills. ИИ-агент (Claude Code, Codex, Cursor и другие) читает описание, сам берёт нужный навык под задачу и делает по канону модуля — с точными namespace, сигнатурами и ловушками, которых в обучающих данных модели нет.
Почему ИИ-агент не берёт мой навык?
Почти всегда — из-за description: он написан под содержание, а не под задачу, или привязан к вендору. Правило 2 стандарта и bxshef eval — он проверяет именно выбор навыка по фразе.
Это платно?
Нет. Методология, bxshef, Action и навыки shef.* — MIT. Проект некоммерческий: цель в том, чтобы методологию взяли.
Куда уходят отзывы ИИ-агентов?
Навык shef-feedback в конце задачи записывает, что пригодилось и чего не хватило, в .bxshef/feedback/ проекта и отправляет на адрес из .bxshef.json. Свой приёмник — feedback/, Docker без зависимостей.

Весь сайт одним файлом для ИИ-агентов — llms.txt и llms-full.txt. Вопросы по сайту — ИИ-агенту в меню слева.