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

form-edit — скилл для Claude Code: изменение Form.xml по JSON

Скилл form-edit для Claude Code и Codex. Вносит точечные правки в Form.xml управляемой формы 1С по JSON-описанию — меняет элементы, реквизиты и команды без ручной правки XML.

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

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

Что делает form-edit

Скилл обновляет управляемую форму 1С через PowerShell-скрипт scripts/form-edit.ps1. На вход он принимает путь к файлу Form.xml и JSON со списком изменений. Перенесённый или изменённый элемент сохраняет свой id, поэтому обработчики событий и обращения из кода продолжают работать.

Через JSON можно добавлять, перемещать, менять и удалять элементы интерфейса, реквизиты, команды и свойства формы. Операция set не меняет тип элемента, путь к данным или команду кнопки. Для такой правки элемент придётся удалить и создать заново.

Обработчики событий в модуле Module.bsl этот инструмент не создаёт. Процедуры в коде нужно дописывать отдельно.

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

  • перенести реквизиты и поля в новую группу формы
  • добавить реквизит и поле ввода в существующий Form.xml
  • скрыть или переименовать элементы интерфейса через set
  • удалить неиспользуемые команды и связанные с ними кнопки

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

  • Примени правки из diff.json к форме src/Catalogs/Номенклатура/Forms/ФормаЭлемента/Ext/Form.xml через /form-edit
  • /form-edit ./Documents/Приход/Forms/ФормаДокумента/Ext/Form.xml ./changes.json
  • Добавь флажок на форму через /form-edit, используя config.json и путь к Form.xml

Как установить form-edit

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 form-edit -a claude-code

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

~/.claude/skills/form-edit/SKILL.md

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

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

Вопросы о form-edit

Как установить form-edit в Claude Code?

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

Что делает скилл form-edit?

Он точечно модифицирует файл Form.xml управляемой формы 1С по инструкциям из JSON-файла, не задевая остальную разметку.

Создаёт ли form-edit процедуры в коде формы?

Нет. Скилл прописывает только привязку событий в Form.xml, а сами тела процедур в Module.bsl нужно добавлять отдельно.

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

SKILL.md · MIT
---
name: form-edit
description: Правка существующей управляемой формы 1С — элементы, реквизиты, команды и свойства самой формы. Используй, когда нужно точечно изменить готовую форму
argument-hint: <FormPath> <JsonPath>
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
---

# /form-edit — Правка формы

Точечно меняет существующий `Form.xml` по описанию правок в JSON; остальное в файле не трогает. Перенесённый или изменённый элемент сохраняет свой id — обработчики и обращения из модуля продолжают работать.

## Команда

| Параметр  | Обязательный | Описание                       |
|-----------|:------------:|--------------------------------|
| FormPath  | да           | Путь к существующему Form.xml  |
| JsonPath  | да           | Путь к JSON с описанием правок |

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-edit.ps1" -FormPath "<путь>" -JsonPath "<путь>"
```

## Что можно править

| Ключ | Правка |
|------|--------|
| `elements` | Элементы: добавить, перенести, изменить, удалить — список операций, по порядку |
| `attributes` | Реквизиты: добавить; `{ "remove": "Имя" }` — удалить |
| `commands` | Команды: добавить; `{ "remove": "Имя" }` — удалить |
| `parameters` | Параметры формы: добавить; `{ "remove": "Имя" }` — удалить |
| `title` | Заголовок формы (строка или `{ru, en}`); `null` — убрать |
| `properties` | Свойства формы: `{ "windowOpeningMode": "LockOwnerWindow" }`; `null` у свойства — убрать (`references/form-properties.md`) |
| `events` | Обработчики событий формы: `{ "OnOpen": "ПриОткрытии" }` |
| `excludedCommands` | Исключить стандартные команды: `["Copy"]`; вернуть: `{ "remove": ["Copy"] }` |
| `conditionalAppearance` | Добавить правила условного оформления (`references/appearance.md`) |
| `commandInterface` | Добавить команды в панели формы (`references/command-interface.md`) |

Все ключи необязательны, в одной правке можно сочетать любые. Имена элементов, реквизитов и команд — из `/form-info`. Процедуры обработчиков в модуле формы не создаются — их добавляют в `Module.bsl` отдельно.

## Элементы

Операцию задаёт ключ:

| Ключ | Операция |
|------|----------|
| тип элемента: `input`, `group`, `table`, … | Добавить новый элемент |
| `move` | Перенести: имя или список имён (встают подряд в этом порядке) вместе с содержимым |
| `set` | Изменить свойства: имя или список имён |
| `remove` | Удалить: имя или список имён; группа, страница, таблица — вместе с содержимым |

Куда встаёт добавляемый или переносимый элемент:

| Ключи | Куда |
|-------|------|
| `after: "X"` / `before: "X"` | Рядом с X, в его группе |
| `into: "G"` | В конец G — группы, страницы, таблицы, командной панели |
| `into: "G", first: true` | В начало G |

Новый элемент без позиции встаёт в конец формы; следующий без позиции — за ним. У `move` позиция обязательна.

```json
{
  "attributes": [ { "name": "Срочно", "type": "boolean" } ],
  "elements": [
    { "group": "alwaysHorizontal", "name": "ГруппаОтгрузка", "after": "Контрагент" },
    { "move": ["Склад", "Организация"], "into": "ГруппаОтгрузка" },
    { "check": "Срочно", "path": "Срочно", "into": "ГруппаОтгрузка" },
    { "move": "ТоварыСумма", "before": "ТоварыЦена" },
    { "set": "Ответственный", "visible": false },
    { "set": "Контрагент", "title": "Покупатель", "events": { "OnChange": null } },
    { "remove": "Комментарий" }
  ]
}
```

### Изменение (`set`)

- Ключи — свойства элемента, те же, что при добавлении: заголовок, видимость, доступность, размеры, цвета и шрифт, кнопки поля, параметры выбора и т. д. (таблица ниже и справочники).
- `null` возвращает свойству значение по умолчанию.
- Строка в `title` меняет русский текст, переводы на другие языки остаются.
- У группы ориентацию меняет `group`: `{ "set": "ГруппаШапка", "group": "vertical" }`.
- `events` добавляет обработчики — как у нового элемента.
- Имя, тип элемента, путь к данным и команду кнопки `set` не меняет: такой элемент удаляют и добавляют заново.

### Удаление вместе с реквизитом

Поле и реквизит, к которому оно привязано, удаляются в одной правке:

```json
{
  "elements":   [ { "remove": "Срочно" } ],
  "attributes": [ { "remove": "Срочно" } ]
}
```

## Новый элемент

Ключ — тип элемента, значение — имя; у `group` значение — ориентация, а имя задаётся в `name`.

| Ключ | Элемент | Подробно |
|------|---------|----------|
| `input` | Поле ввода | `input-fields.md` |
| `check` / `radio` | Флажок / переключатель | `input-fields.md` |
| `labelField` | Поле-надпись (значение без редактирования) | `input-fields.md` |
| `label` | Надпись, текст — в `title` | `tooltips-text.md` |
| `group` | Группа: `vertical` / `horizontalIfPossible` / `alwaysHorizontal` | `groups-pages.md` |
| `pages` / `page` | Страницы / страница | `groups-pages.md` |
| `table` / `columnGroup` | Таблица / группа колонок | `table-advanced.md` |
| `button` / `popup` / `buttonGroup` / `cmdBar` | Кнопка / подменю / группа кнопок / командная панель | `buttons-commands.md` |
| `picture` / `picField` | Картинка / поле-картинка | `pictures.md` |

Табличный документ, HTML, календарь, диаграммы и другие особые поля — по индексу ниже.

| Ключ | Описание |
|------|----------|
| `name` | Имя, если отличается от значения ключа типа. Имена в форме уникальны |
| `path` | Путь к данным: `"Объект.Склад"`, `"ИмяРеквизита"`; колонка таблицы — `"Объект.Товары.Сумма"` |
| `title` / `tooltip` | Заголовок / подсказка (строка или `{ru, en}`) |
| `visible: false` / `enabled: false` / `readOnly: true` | Скрыть / сделать недоступным / только чтение |
| `events` | Обработчики: `{ "OnChange": "ИмяПроцедуры" }`; `null` вместо имени — имя по шаблону `<Элемент><Событие>` |
| `children` / `columns` | Вложенные элементы группы или страницы / колонки таблицы |

Поле на новом реквизите формы — реквизит и элемент в одной правке:

```json
{
  "attributes": [ { "name": "СуммаИтого", "type": "decimal(15,2)" } ],
  "elements": [ { "input": "СуммаИтого", "path": "СуммаИтого", "readOnly": true, "after": "Контрагент" } ]
}
```

Колонка в существующую таблицу — элемент рядом с другой колонкой или `into` таблицы:

```json
{ "input": "ТоварыСкидка", "path": "Объект.Товары.Скидка", "after": "ТоварыЦена" }
```

Кнопка — в командную панель формы (`ФормаКоманднаяПанель`) или таблицы (`ТоварыКоманднаяПанель`); `command` — команда формы, `stdCommand` — стандартная (`"Close"`, у таблицы — `"Товары.Add"`):

```json
{
  "commands": [ { "name": "Пересчитать", "action": "ПересчитатьОбработка" } ],
  "elements": [ { "button": "Пересчитать", "command": "Пересчитать", "into": "ФормаКоманднаяПанель" } ]
}
```

Свойства командной панели формы — операция `autoCmdBar`: `{ "autoCmdBar": "ФормаКоманднаяПанель", "autofill": false }` (без стандартных команд), `horizontalAlign`.

### События

Имена регистрозависимы.

**Форма:** `OnCreateAtServer`, `OnOpen`, `BeforeClose`, `OnClose`, `NotificationProcessing`, `ChoiceProcessing`, `OnReadAtServer`, `BeforeWriteAtServer`, `OnWriteAtServer`, `AfterWriteAtServer`, `BeforeWrite`, `AfterWrite`, `FillCheckProcessingAtServer`, `BeforeLoadDataFromSettingsAtServer`, `OnLoadDataFromSettingsAtServer`, `ExternalEvent`, `Opening`

**input:** `OnChange`, `StartChoice`, `ChoiceProcessing`, `AutoComplete`, `TextEditEnd`, `Clearing`, `Creating`, `EditTextChange`
**check / radio:** `OnChange`
**table:** `OnStartEdit`, `OnEditEnd`, `OnChange`, `Selection`, `ValueChoice`, `BeforeAddRow`, `BeforeDeleteRow`, `AfterDeleteRow`, `BeforeRowChange`, `BeforeEditEnd`, `OnActivateRow`, `OnActivateCell`
**label / labelField:** `Click`, `URLProcessing`; у `labelField` также `OnChange`, `StartChoice`, `ChoiceProcessing`, `Clearing`
**picture / button:** `Click`
**pages:** `OnCurrentPageChange`

### Реквизиты, команды, параметры

```json
"attributes": [ { "name": "Итого", "type": "decimal(15,2)", "title": "Итого" },
                { "name": "Данные", "type": "ValueTable", "columns": [ { "name": "Сумма", "type": "decimal(15,2)" } ] } ],
"commands":   [ { "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" } ],
"parameters": [ { "name": "Основание", "type": "DocumentRef.Заказ", "key": true } ]
```

Типы: `string`, `string(100)`, `decimal(15,2)`, `boolean`, `date`, `dateTime`, `CatalogRef.X`, `DocumentRef.X`, `EnumRef.X`, `ValueTable`, `ValueList`, `DynamicList`, `Тип1 | Тип2` — все типы в `references/type-system-advanced.md`. Остальные ключи реквизитов — `attributes-advanced.md`, команд — `buttons-commands.md`.

## Форма расширения

Форма расширения (с `<BaseForm>`) распознаётся сама. Свои элементы, реквизиты и команды расширения называют с префиксом расширения (`Расш1_Метка`) и задают им `title` — иначе заголовок возьмётся из имени вместе с префиксом. Обработчику указывают вид вызова — `callType`: `Before`, `After` или `Override`; без него — `Before`:

```json
{
  "events": { "OnCreateAtServer": { "handler": "Расш1_ПриСозданииПосле", "callType": "After" } },
  "elements": [
    { "set": "Банк", "events": { "OnChange": { "handler": "Расш1_БанкПриИзменении", "callType": "Before" } } }
  ],
  "commands": [
    { "name": "Подбор", "action": "Расш1_ПодборПосле", "callType": "After" },
    { "name": "Запрос", "actions": [
      { "handler": "Расш1_ЗапросПеред", "callType": "Before" },
      { "handler": "Расш1_ЗапросПосле", "callType": "After" } ] }
  ]
}
```

## Задача → справочник

Под задачу подгрузите файл из `references/`:

| Задача | Справочник |
|--------|-----------|
| Поле ввода, флажок, переключатель: кнопки, список выбора, быстрый выбор, своя форма выбора, маска, формат, пароль, выключатель/тумблер, поле составного типа | `input-fields.md` |
| Ограничить выбор отбором, связать поле с другим полем, связь по типу | `choice-params.md` |
| Группа и страницы: ориентация, рамка, свёрнутая группа, интервалы, заголовок из данных, значок закладки, мастер по шагам | `groups-pages.md` |
| Таблица: колонки и группы колонок, итоги в подвале, дерево, выделение строк, закрепление колонок, поиск, перетаскивание | `table-advanced.md` |
| Форма списка: источник данных, запрос, отбор, сортировка, группировка, иерархия | `dynamic-list.md` |
| Кнопки, подменю, команды: картинка кнопки, переключатель в панели, команды таблицы в группе кнопок, своё контекстное меню у поля, команда для текущей строки | `buttons-commands.md` |
| Подсветить цветом, шрифт, рамка, условное оформление (в форме списка — `dynamic-list.md`) | `appearance.md` |
| Расширенная подсказка под полем, надпись с выделением или ссылкой | `tooltips-text.md` |
| Картинка, значок в колонке, иконка по значению | `pictures.md` |
| Табличный документ (печатная форма, отчёт на форме) | `spreadsheet.md` |
| HTML, текстовый документ, индикатор, ползунок, календарь, период | `special-fields.md` |
| Диаграмма, диаграмма Ганта, планировщик | `charts.md` |
| Свойства формы: модальность, размер, прокрутка, Enter, время и проведение документа | `form-properties.md` |
| Форма отчёта (СКД) | `report-form.md` |
| Реквизиты: сохранение в настройках, проверка заполнения, функциональные опции | `attributes-advanced.md` |
| Типы реквизитов, составные типы и наборы | `type-system-advanced.md` |
| Видимость и доступ по ролям | `roles-access.md` |
| Командный интерфейс формы (переходы, важные команды) | `command-interface.md` |
| Размеры, выравнивание, фокус по умолчанию, узкие экраны | `layout-advanced.md` |

## Workflow

1. `/form-info` — структура формы: имена элементов, реквизиты, команды.
2. Описать правки в JSON.
3. `/form-edit` — применить; в выводе — что добавлено, перенесено, изменено и удалено.
4. `/form-validate` — проверить форму.

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

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

Всё по теме «1С» →
pr-reference microsoft Скилл pr-reference для Claude Code собирает коммиты и дифы между ветками в структурированный XML. Данные используются для описания PR, code review и анализа изменений в проекте. CX Codex +1 ★ 1 627звёзд репо price-check ilyautov Скилл price-check считает валовую маржу по товарам и строит три сценарных среза цены — текущая, рост и снижение — с учётом статуса НДС. Расчёт маржи ведёт через процесс скилла margin-analyzer. CX Codex +1 ★ 38звёзд репо month-end-prep ilyautov Скилл month-end-prep проводит собственника через закрытие месяца: сверяет данные 1С/МойСклад с зачислениями эквайринга и банком, находит операции без статьи, дубли и пропавшую первичку, затем пишет ОПиУ-сводку и выгружает xlsx с PDF. 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звёзд репо recipe-collect-form-responses официальный googleworkspace Скилл recipe-collect-form-responses для Claude Code, Codex, Cursor и других платформ помогает получить и проверить ответы из Google Form. Запускается в вашем редакторе кода и работает через команды Google Workspace CLI. CX Codex +1 31 200установок

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

Весь набор →
erf-build Скилл erf-build для Claude Code и Codex собирает внешний отчёт 1С из XML-исходников в файл ERF. Проверяет и компилирует отчёт. CX Codex +1 53установок skd-edit Скилл skd-edit для Claude Code и Codex точечно меняет схему компоновки данных 1С: добавляет поля, итоги, фильтры и параметры, правит текст запроса. Дорабатывает существующую СКД. CX Codex +1 52установок web-test Скилл web-test автоматизирует тестирование 1С через веб-клиент с помощью Playwright. Помогает заполнять формы, открывать команды, сверять реквизиты и делать скриншоты. CX Codex +1 50установок meta-compile Скилл meta-compile генерирует файлы объектов метаданных 1С из JSON-описания и прописывает их в Configuration.xml. Пригодится при пакетном или быстром добавлении справочников и документов. CX Codex +1 50установок erf-validate Скилл erf-validate проверяет структуру внешнего отчёта 1С в XML после создания или изменения. Помогает найти ошибки до сборки. CX Codex +1 50установок epf-dump Скилл epf-dump для Claude Code разбирает обработки 1С в формате EPF/ERF и выгружает XML-исходники. Извлекает код из готового файла обработки. CX Codex +1 50установок cfe-validate Скилл cfe-validate проверяет исходники расширения конфигурации 1С на ошибки структуры, свойства и связи с заимствованными объектами до загрузки в базу. CX Codex +1 50установок cfe-init Генерирует scaffold расширения конфигурации 1С: Configuration.xml, языки, опционально роли. Запускается по /cfe-init с именем и назначением (Patch, Customization, AddOn). CX Codex +1 50установок

Ещё в каталоге

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

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