К основному содержанию
скилл CX Codex

epf-bsp-add-command — скилл для Claude Code: команды БСП

Скилл epf-bsp-add-command для Claude Code добавляет команду в описание дополнительной обработки БСП и подготавливает обработчик. Расширяет уже созданную обработку.

MIT 44 установок ★ 811 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Открыть на GitHub

Что делает epf-bsp-add-command

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

Обработчик зависит от выбранной команды и вида обработки. Для открытия формы отдельная процедура не нужна; для других вариантов скилл добавляет ветку в существующую процедуру или создаёт её. Перед запуском обработка должна быть инициализирована через /epf-bsp-init. Без этого шага команда не рассчитана на работу с обработкой.

Какие задачи решает

  • добавить команду в описание обработки БСП
  • выбрать тип команды по виду обработки
  • подготовить обработчик команды в модуле объекта
  • добавить печатную форму с нужным модификатором
  • указать команду загрузки данных из файла

Примеры запросов агенту

  • Добавь команду СформироватьОтчёт в обработку МояОбработка.
  • Зарегистрируй для ИмпортДанных загрузку из файла в справочник Справочник.Номенклатура.
  • Добавь в МояОбработка команду открытия формы с представлением «Открыть отчёт».

Как установить epf-bsp-add-command

1Через маркетплейс плагинов

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

Команда ставит плагин 1c-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill epf-bsp-add-command -a claude-code

3Вручную: положить файлы

~/.claude/skills/epf-bsp-add-command/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/epf-bsp-add-command/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об epf-bsp-add-command

Как установить epf-bsp-add-command в Claude Code?

Добавь маркетплейс командой /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем установи скилл командой /plugin install 1c-skills@cc-1c-skills.

Что делает epf-bsp-add-command?

Добавляет команду в описание обработки БСП и выбирает подходящий обработчик с учётом вида обработки и типа команды.

Что нужно подготовить перед запуском?

Сначала инициализируй обработку с помощью /epf-bsp-init. Для команды загрузки данных из файла также требуется назвать справочник назначения.

Исходный текст

SKILL.md · MIT
---
name: epf-bsp-add-command
description: Определить команду в БСП‑описании обработки (`СведенияОВнешнейОбработке`) — открытие формы, вызов клиентского/серверного метода, заполнение объекта и т.п. Используй когда нужно зарегистрировать команду в дополнительной обработке БСП
argument-hint: <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
allowed-tools:
  - Read
  - Edit
  - Glob
  - Grep
---

# /epf-bsp-add-command — Добавление команды БСП

Добавляет команду в существующую функцию `СведенияОВнешнейОбработке()` и генерирует соответствующий обработчик.

Предварительно обработка должна быть инициализирована через `/epf-bsp-init`.

## Usage

```
/epf-bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]
```

| Параметр      | Обязательный | По умолчанию          | Описание                                   |
|---------------|:------------:|-----------------------|--------------------------------------------|
| ProcessorName | да           | —                     | Имя обработки                              |
| Идентификатор | да           | —                     | Внутреннее имя команды (латиница)          |
| ТипКоманды    | нет          | из вида обработки     | Тип запуска команды (см. маппинг ниже)     |
| Представление | нет          | = Идентификатор       | Отображаемое имя команды для пользователя  |
| SrcDir        | нет          | `src`                 | Каталог исходников                         |

## Маппинг типов команд

Пользователь может указать тип в свободной форме:

| Пользователь пишет                    | ТипКоманды                                | Доступен для вида обработки |
|---------------------------------------|-------------------------------------------|-----------------------------|
| открыть форму, форма                  | `ТипКомандыОткрытиеФормы()`               | любого                      |
| клиентский метод, на клиенте          | `ТипКомандыВызовКлиентскогоМетода()`      | любого                      |
| серверный метод, на сервере           | `ТипКомандыВызовСерверногоМетода()`       | любого                      |
| заполнение формы, заполнить форму     | `ТипКомандыЗаполнениеФормы()`             | ЗаполнениеОбъекта           |
| загрузка из файла, импорт из файла    | `ТипКомандыЗагрузкаДанныхИзФайла()`       | ДополнительнаяОбработка; в конфигурации должна быть подсистема «Загрузка данных из файла» |

Других типов команд в БСП нет. Если запрошенный тип не подходит ни под одну строку — спроси пользователя, не придумывай метод. Если тип недоступен для вида обработки — сообщи об этом и не добавляй команду.

Если пользователь не указал тип — определи по виду обработки из существующего кода `СведенияОВнешнейОбработке()`:

| Вид обработки (из кода)    | ТипКоманды по умолчанию                   |
|----------------------------|-------------------------------------------|
| ДополнительнаяОбработка    | `ТипКомандыОткрытиеФормы()`               |
| ДополнительныйОтчет       | `ТипКомандыОткрытиеФормы()`               |
| ЗаполнениеОбъекта          | `ТипКомандыВызовСерверногоМетода()`        |
| Отчет                      | `ТипКомандыОткрытиеФормы()`               |
| ПечатнаяФорма              | `ТипКомандыВызовСерверногоМетода()`        |
| СозданиеСвязанныхОбъектов  | `ТипКомандыВызовСерверногоМетода()`        |

## Шаблон добавления команды

Вставляется в `СведенияОВнешнейОбработке()` **перед** строкой `Возврат ПараметрыРегистрации`:

```bsl
	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
	НоваяКоманда.Представление        = НСтр("ru = '{{Представление}}'");
	НоваяКоманда.Идентификатор        = "{{Идентификатор}}";
	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
	НоваяКоманда.ПоказыватьОповещение = Ложь;
```

Для печатных форм (ВидОбработкиПечатнаяФорма) добавь также:

```bsl
	НоваяКоманда.Модификатор = "ПечатьMXL";
```

Для команды ЗагрузкаДанныхИзФайла `Модификатор` обязателен: полное имя справочника, в который загружаются данные. Если пользователь его не назвал — спроси.

```bsl
	НоваяКоманда.Модификатор = "Справочник.Номенклатура";
```

Примечание: в отличие от первой команды (из `/epf-bsp-init`), дополнительные команды используют строковые литералы `НСтр("ru = '...'")` для представления и строку для идентификатора, а не `Метаданные()`.

## Шаблоны обработчиков

Шаблон выбирается по паре «тип команды × вид обработки».

### ОткрытиеФормы

Обработчик не нужен: открывается основная форма обработки, идентификатор команды приходит в `Параметры.ИдентификаторКоманды`.

### ВызовСерверногоМетода, ЗаполнениеФормы — если обработчик уже есть

Если процедура `ВыполнитьКоманду` уже существует в модуле объекта, добавь ветку перед `КонецЕсли`:

```bsl
	ИначеЕсли ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
```

### ВызовСерверногоМетода, ЗаполнениеФормы — если обработчика нет

Процедура добавляется в модуль объекта. Сигнатура зависит от вида обработки.

ДополнительнаяОбработка, ДополнительныйОтчет (без `ОбъектыНазначения`):

```bsl
Процедура ВыполнитьКоманду(ИдентификаторКоманды, ПараметрыВыполненияКоманды) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

ЗаполнениеОбъекта, Отчет:

```bsl
Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, ПараметрыВыполненияКоманды) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

Для команды типа ЗаполнениеФормы обработчик тот же: `ОбъектыНазначения` = `Неопределено`, заполняемая форма передаётся в `ПараметрыВыполненияКоманды.ЭтаФорма`.

СозданиеСвязанныхОбъектов (ссылки созданных объектов добавляются в массив `СозданныеОбъекты`):

```bsl
Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначения, СозданныеОбъекты, ПараметрыВыполненияКоманды) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

### ПечатнаяФорма — если процедура Печать уже есть

Добавь блок перед `КонецПроцедуры`:

```bsl
	ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "{{Идентификатор}}");
	Если ПечатнаяФорма <> Неопределено Тогда
		ПечатнаяФорма.ТабличныйДокумент = Сформировать{{Идентификатор}}(МассивОбъектов, ОбъектыПечати);
		ПечатнаяФорма.СинонимМакета = НСтр("ru = '{{Представление}}'");
	КонецЕсли;
```

### ПечатнаяФорма — если процедуры Печать нет

```bsl
Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт

	ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "{{Идентификатор}}");
	Если ПечатнаяФорма <> Неопределено Тогда
		ПечатнаяФорма.ТабличныйДокумент = Сформировать{{Идентификатор}}(МассивОбъектов, ОбъектыПечати);
		ПечатнаяФорма.СинонимМакета = НСтр("ru = '{{Представление}}'");
	КонецЕсли;

КонецПроцедуры
```

### ВызовКлиентскогоМетода

Добавляется в **модуль основной формы** (`Forms/<FormName>/Ext/Form/Module.bsl`). Имя и сигнатура зависят от вида обработки.

ДополнительнаяОбработка, ДополнительныйОтчет:

```bsl
&НаКлиенте
Процедура ВыполнитьКоманду(ИдентификаторКоманды) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

ЗаполнениеОбъекта, Отчет:

```bsl
&НаКлиенте
Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначенияМассив) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

СозданиеСвязанныхОбъектов:

```bsl
&НаКлиенте
Процедура ВыполнитьКоманду(ИдентификаторКоманды, ОбъектыНазначенияМассив, СозданныеОбъекты) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

ПечатнаяФорма (процедура называется `Печать`, не `ВыполнитьКоманду`):

```bsl
&НаКлиенте
Процедура Печать(ИдентификаторКоманды, ОбъектыНазначенияМассив) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Реализация {{Идентификатор}}
	КонецЕсли;

КонецПроцедуры
```

Если процедура уже есть — добавь ветку `ИначеЕсли`.

### ЗагрузкаДанныхИзФайла

В модуль объекта добавляются три экспортные процедуры. Если какая-то из них уже есть — добавь в неё ветку `ИначеЕсли`.

```bsl
Процедура ОпределитьПараметрыЗагрузкиДанныхИзФайла(ИдентификаторКоманды, ПараметрыЗагрузки) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// ПараметрыЗагрузки.ИмяМакетаСШаблоном = "ЗагрузкаДанныхИзФайла";
		// ПараметрыЗагрузки.ОбязательныеКолонки.Добавить("<ИмяКолонки>");
	КонецЕсли;

КонецПроцедуры

Процедура СопоставитьЗагружаемыеДанныеИзФайла(ИдентификаторКоманды, ЗагружаемыеДанные) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Заполнить колонку СопоставленныйОбъект по данным из файла
	КонецЕсли;

КонецПроцедуры

Процедура ЗагрузитьИзФайла(ИдентификаторКоманды, ЗагружаемыеДанные, ПараметрыЗагрузки, Отказ) Экспорт

	Если ИдентификаторКоманды = "{{Идентификатор}}" Тогда
		// TODO: Загрузка; для каждой строки заполнить РезультатСопоставленияСтроки
		// ("Создан", "Обновлен", "Пропущен") и при ошибке ОписаниеОшибки
	КонецЕсли;

КонецПроцедуры
```

Колонки загружаемых данных берутся из макета обработки `ЗагрузкаДанныхИзФайла` (имя макета можно переопределить через `ПараметрыЗагрузки.ИмяМакетаСШаблоном`). Если макета нет — предложи создать его через `/template-add`.

## Инструкции

1. Найди и прочитай `ObjectModule.bsl` через Glob: `src/{{ProcessorName}}/Ext/ObjectModule.bsl`
2. Убедись что `СведенияОВнешнейОбработке()` существует. Если нет — предложи вызвать `/epf-bsp-init`
3. Определи вид обработки из существующего кода (найди строку с `ВидОбработки...()`)
4. Вставь блок команды **перед** `Возврат ПараметрыРегистрации`
5. Добавь обработчик по шаблону для типа команды и вида обработки из шага 3:
   - Для серверных обработчиков и ЗагрузкаДанныхИзФайла — в `ObjectModule.bsl`, область `ПрограммныйИнтерфейс`
   - Для клиентских обработчиков — в модуль основной формы (найти через Glob: `src/{{ProcessorName}}/Forms/*/Ext/Form/Module.bsl`)
6. Если обработчик (`ВыполнитьКоманду` / `Печать` / процедуры загрузки) уже есть — добавь ветку, не создавай дубль процедуры
7. Используй табы для отступов

## Пример

Пользователь: `/epf-bsp-add-command МояОбработка ЗаказПокупателя серверный "Заказ покупателя"`

В `СведенияОВнешнейОбработке()` перед `Возврат` добавится:

```bsl
	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
	НоваяКоманда.Представление        = НСтр("ru = 'Заказ покупателя'");
	НоваяКоманда.Идентификатор        = "ЗаказПокупателя";
	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();
	НоваяКоманда.ПоказыватьОповещение = Ложь;
```

И в существующую процедуру `ВыполнитьКоманду` добавится блок обработки.

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Похожие скиллы

Всё по теме «1С» →
jetson-print-bsp-info Jetson Team Скилл jetson-print-bsp-info проверяет дерево Linux_for_Tegra на хост-компьютере до прошивки платы Jetson. Показывает версию L4T и статус заполнения rootfs. CX Codex +1 1 100установок jetson-download-bsp Jetson Team Скилл jetson-download-bsp тянет артефакты NVIDIA Jetson Linux BSP в рабочую папку: образ BSP, sample rootfs, public_sources, x-tools и документацию. Нужен на шаге Auto Setup. CX Codex +1 1 100установок close-month ilyautov Скилл close-month сверяет данные бухгалтерии с эквайрингом и выписками, находит расхождения и собирает отчётный пакет закрытия месяца. CX Codex +1 ★ 38звёзд репо 1c-rest-mcp theYahia MCP-сервер 1c-rest-mcp подключает ИИ-агента к данным 1С через OData 3.0. Подходит для чтения и изменения каталогов, документов и регистров. CX Codex +1 ★ 13звёзд репо Yzel — 1C:Enterprise Aiyo28 Yzel — 1C:Enterprise — MCP-сервер для Claude Code, который подключает AI-ассистента к базам 1С:Предприятие через OData v3. Работает с локальными инсталляциями и 1С:Fresh. CX Codex +1 ★ 9звёзд репо dart-add-unit-test dart-lang Скилл dart-add-unit-test для Claude Code, Codex и других агентов пишет и организует юнит-тесты на package:test. Включается при добавлении логики или исправлении багов, чтобы избежать регрессий. CX Codex +1 21 400установок

Из того же набора81

Весь набор →
interface-validate Скилл interface-validate проверяет CommandInterface.xml командного интерфейса 1С на структурные ошибки. Нужен после настройки интерфейса подсистемы. CX Codex +1 44установок help-add Скилл help-add добавляет встроенную справку к объекту 1С: создаёт файлы помощи и связывает её с формами объекта. CX Codex +1 44установок form-remove Скилл form-remove удаляет формы из выгруженных исходников 1С и вычищает ссылки на них из корневого XML объекта. Пригодится при рефакторинге конфигураций. CX Codex +1 44установок epf-bsp-init Скилл epf-bsp-init генерирует экспортную функцию СведенияОВнешнейОбработке в модуле 1С-обработки для интеграции с подсистемой БСП «Дополнительные отчёты и обработки». CX Codex +1 44установок db-update Скилл db-update для Claude Code применяет изменения основной конфигурации 1С к конфигурации базы данных. Отдельно обновляет БД после загрузки XML или Git-ветки. CX Codex +1 44установок db-run Скилл db-run запускает информационную базу 1С:Предприятие в пользовательском режиме прямо из диалога с ассистентом, подтягивая настройки из конфигурации проекта. CX Codex +1 44установок db-dump-xml Скилл db-dump-xml выгружает конфигурацию 1С в XML-файлы. Подходит для полной, инкрементальной или частичной выгрузки исходников. CX Codex +1 44установок db-create Скилл db-create для Claude Code и Codex создаёт файловую или серверную информационную базу 1С. Создаёт новую пустую базу или базу из шаблона. CX Codex +1 44установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой