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

role-compile — скилл для Claude Code: генерация ролей 1С из JSON

Скилл role-compile создаёт файлы роли 1С (Roles/Имя.xml и Rights.xml) из JSON-описания прав на объекты конфигурации. Поддерживает пресеты, RLS и точечные права на реквизиты.

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

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

Что делает role-compile

Скилл принимает JSON с набором прав — например, "Catalog.Номенклатура: @view" или полное определение с ограничениями RLS — и генерирует метаданные роли в структуре выгрузки 1С. UUID присваиваются автоматически, роль регистрируется в Configuration.xml. Пресеты @view и @edit раскрываются в типовые наборы (Read, View, Use для просмотра; CRUD и Posting для редактирования). Права на вложенные части объекта — реквизиты, методы HTTP-сервисов — задаются точечным путём; запрет на реквизит перекрывает унаследованное право.

Шаблоны RLS хранятся в секции templates, длинные условия можно вынести в файл (@путь). Символ & в условиях экранируется в XML автоматически. Для HTTP-сервисов короткая запись "HTTPService.ЭДО: Use" раскрывается на все методы всех шаблонов URL по метаданным из OutputDir.

Скилл вызывает PowerShell-скрипт role-compile.ps1, который создаёт файлы роли и правит Configuration.xml. Если в описании ошибка (права на объект без прав в платформе, путь к несуществующему реквизиту), файлы не создаются. Есть команды /role-validate и /role-info для проверки XML и визуализации структуры роли.

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

  • сгенерировать роль 1С с правами на справочники и документы из JSON
  • настроить RLS для роли: ограничить чтение документов по организации
  • запретить просмотр конкретного реквизита справочника в роли
  • создать роль с правами Use на все методы HTTP-сервиса
  • автоматически прописать роль в Configuration.xml с UUID

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

  • Создай роль из role-definition.json, выгрузка в src/Configuration
  • Сгенерируй роль «ЧтениеНоменклатуры» с правами @view на Catalog.Номенклатура и Catalog.Контрагенты
  • Добавь в роль RLS для Document.РеализацияТоваровУслуг: чтение только своей организации

Как установить role-compile

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 role-compile -a claude-code

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

~/.claude/skills/role-compile/SKILL.md

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

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

Вопросы о role-compile

Как установить role-compile в Claude Code?

Два способа: через маркетплейс — /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills; либо напрямую через npm — npx skills add Nikolay-Shirokov/cc-1c-skills --skill role-compile -a claude-code. Скилл появится в ~/.claude/skills/role-compile/SKILL.md.

Что делает role-compile?

Генерирует XML-файлы роли 1С из JSON-описания: создаёт Roles/Имя.xml с метаданными и Roles/Имя/Ext/Rights.xml с правами на объекты конфигурации. Автоматически присваивает UUID, регистрирует роль в Configuration.xml, раскрывает пресеты @view и @edit в права платформы.

Можно ли задать права на реквизит справочника?

Да, через точечный путь: "Catalog.Контрагенты.Attribute.ИНН: View, Edit" или в объектной форме с rights. Чтобы запретить унаследованное право, укажи {"name": "Catalog.Товары.Attribute.Цена", "rights": {"View": false}}.

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

SKILL.md · MIT
---
name: role-compile
description: Создание роли 1С из описания прав. Используй когда нужно создать новую роль с набором прав на объекты
argument-hint: <JsonPath> <OutputDir>
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
---

# /role-compile — генерация роли 1С из JSON DSL

Принимает JSON-определение роли → генерирует `Roles/Имя.xml` (метаданные) и `Roles/Имя/Ext/Rights.xml` (права). UUID автоматически.

## Параметры и команда

| Параметр | Описание |
|----------|----------|
| `JsonPath` | Путь к JSON-определению роли |
| `OutputDir` | Корень выгрузки конфигурации (где `Configuration.xml`, `Roles/` и т.д.) |

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/role-compile.ps1" -JsonPath "<json>" -OutputDir "<ConfigDir>"
```

Создаёт `{OutputDir}/Roles/Имя.xml` и `{OutputDir}/Roles/Имя/Ext/Rights.xml`. Регистрирует `<Role>` в `Configuration.xml`.

## JSON DSL

### Структура

```json
{ "name": "ИмяРоли", "synonym": "Отображаемое имя", "objects": [...], "templates": [...] }
```

Необязательные: `comment` (""), `setForNewObjects` (false), `setForAttributesByDefault` (true), `independentRightsOfChildObjects` (false).

### Shorthand-строки и объектная форма

```json
"objects": [
  "Catalog.Номенклатура: @view",
  "Document.Реализация: @edit",
  "DataProcessor.Загрузка: @view",
  "InformationRegister.Цены: Read, Update",
  { "name": "Document.Продажа", "preset": "view", "rls": {"Read": "#Шаблон(\"\")"} },
  { "name": "Catalog.Номенклатура.Attribute.Цена", "rights": {"View": false} }
]
```

- Shorthand: `"Тип.Имя: @пресет"` или `"Тип.Имя: Право1, Право2"`
- Объектная форма: `preset` + `rights` (точечные значения прав) + `rls` (ограничения)

### Пресеты

| Пресет | Действие |
|--------|----------|
| `@view` | Просмотр — Read, View (+InputByString для справочников/документов; Use+View для обработок/отчётов) |
| `@edit` | Полное редактирование — CRUD + Interactive* + Posting (документы) |

`@` обязателен в shorthand. В объектной форме — `"preset": "view"` без `@`.


### Сервисы

Право живёт на **вложенном объекте** сервиса — методе шаблона URL, операции, канале; на сервисе целиком его не бывает. Весь сервис — короткая запись, навык раскроет её по метаданным в `OutputDir`:

```json
"objects": ["HTTPService.ЭДО: Use"]
```
→ `HTTPService.ЭДО.URLTemplate.ЕстьНовыеДокументы.Method.POST: Use`, и так по каждому методу каждого шаблона.

Часть маршрутов — полным путём: `"HTTPService.ЭДО.URLTemplate.ЕстьНовыеДокументы.Method.POST: Use"`.


### Шаблоны RLS

```json
"templates": [{"name": "ДляОбъекта(Мод)", "condition": "ГДЕ Организация = &ТекОрг"}]
```

Ссылка в `rls`: `"#ДляОбъекта(\"\")"`. Символ `&` автоматически экранируется в XML.

Длинное условие держи в файле — в значении пишется `@путь`. Относительный путь ищется рядом
с JSON-описанием роли, затем в текущем каталоге:

```json
"objects": [{"name": "Document.Продажа", "preset": "view", "rls": {"Read": "@условие.txt"}}],
"templates": [{"name": "ДляОбъекта(Мод)", "condition": "@шаблон.txt"}]
```

## Примеры

### Простая роль

```json
{
  "name": "ЧтениеНоменклатуры", "synonym": "Чтение номенклатуры",
  "objects": ["Catalog.Номенклатура: @view", "Catalog.Контрагенты: @view", "DataProcessor.Загрузка: @view"]
}
```

### Роль с RLS

```json
{
  "name": "ЧтениеДокументовПоОрганизации",
  "synonym": "Чтение документов (ограничение по организации)",
  "objects": [
    "Catalog.Организации: @view",
    {"name": "Document.РеализацияТоваровУслуг", "preset": "view", "rls": {"Read": "#ДляОбъекта(\"\")"}}
  ],
  "templates": [{"name": "ДляОбъекта(Модификатор)", "condition": "ГДЕ Организация = &ТекущаяОрганизация"}]
}
```

## Что можно писать в `objects`

Прав не бывает у `Enum`, `CommonModule`, `DefinedType`, `CommonPicture`, `CommonTemplate`, `Language`, `FunctionalOption`, `EventSubscription`, `ScheduledJob`, `StyleItem`, `SettingsStorage` и подобных — в дереве редактора ролей их нет. Ошибка в описании — отказ до записи: файлы не создаются, `Configuration.xml` не меняется.

Права на части объекта задаются точечным путём: `Catalog.Контрагенты.Attribute.ИНН: View, Edit`, `WebService.Обмен.Operation.Загрузить: Use`, `HTTPService.ЭДО.URLTemplate.ЕстьНовыеДокументы.Method.POST: Use`.

Реквизиты, табличные части, измерения и ресурсы наследуют права своего объекта — им задают
запрет, чтобы закрыть унаследованное:

```json
{"name": "Catalog.Товары.Attribute.Цена", "rights": {"View": false}}
```

Роль расширения, включённая в основные (`DefaultRoles`), прав на заимствованные объекты давать не может — платформа это запрещает. Такие права выноси в отдельную роль вне основных.

Полные таблицы «тип → права», виды вложенности (включая внешние источники данных), список типов без прав, таблицы пресетов и дополнительные примеры — в `dsl-reference.md`.

## Верификация

```
/role-validate <RightsPath>  — проверка корректности XML, прав, RLS
/role-info <RightsPath>      — визуальная сводка структуры
```

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

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

Всё по теме «1С» →
optimize-simplicite-logs официальный github Скилл optimize-simplicite-logs превращает сырые логи Simplicité из .txt в отфильтрованный JSON. Подходит для разбора ошибок без лишнего шума в контексте. CX Codex +1 31установок 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звёзд репо azure-role-selector официальный github Скилл azure-role-selector для GitHub Copilot подбирает роль Azure с минимальными правами под нужные разрешения и показывает, как назначить её identity. Настраивает доступ без лишних полномочий. CX Codex +1 9 399установок

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

Весь набор →
cf-edit Скилл cf-edit для Claude Code точечно редактирует Configuration.xml в выгрузках 1С: свойства, объекты, роли по умолчанию, панели и начальную страницу. CX Codex +1 46установок subsystem-validate Скилл subsystem-validate проверяет корректность XML-файла подсистемы из выгрузки конфигурации 1С. Запускает PowerShell-скрипт, который находит структурные ошибки. CX Codex +1 45установок subsystem-edit Скилл subsystem-edit меняет состав и свойства подсистемы 1С в XML. Подходит для добавления объектов, дочерних подсистем и точечных правок. CX Codex +1 45установок subsystem-compile Скилл subsystem-compile генерирует XML-исходники подсистемы 1С из JSON-определения и регистрирует её в конфигурации. CX Codex +1 45установок mxl-validate Скилл mxl-validate проверяет макеты табличных документов 1С (MXL). Находит структурные ошибки в Template.xml после ручных правок или кодогенерации. CX Codex +1 45установок mxl-decompile Скилл mxl-decompile для Claude Code разбирает Template.xml табличного документа 1С в компактный JSON. JSON используют для анализа и правки существующих макетов через DSL. CX Codex +1 45установок mxl-compile Скилл mxl-compile собирает макет табличного документа 1С (Template.xml) из компактного JSON-описания. Пригодится при разработке и вёрстке печатных форм. CX Codex +1 45установок meta-edit Скилл meta-edit для Claude Code меняет существующие XML-объекты метаданных 1С: добавляет и правит реквизиты, табличные части и свойства. Выполняет точечные изменения конфигурации. CX Codex +1 45установок

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

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