# role-compile

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 45 установок · ★ 811 у репозитория
- Автор: Nikolay Shirokov
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/HEAD/.claude/skills/role-compile/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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 и визуализации структуры роли.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
```
В чате агента (не в терминале):
```text
/plugin install 1c-skills@cc-1c-skills
```
Команда ставит плагин 1c-skills целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Nikolay-Shirokov/cc-1c-skills --skill role-compile -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/role-compile/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Nikolay-Shirokov/cc-1c-skills --skill role-compile -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/role-compile/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/role-compile
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/role-compile/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Nikolay-Shirokov/cc-1c-skills --skill role-compile -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/role-compile
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/role-compile/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/HEAD/.claude/skills/role-compile/SKILL.md

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

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

## Похожие
- [optimize-simplicite-logs](https://affpapa.org/nevibecode/skills/optimize-simplicite-logs.md) — скилл · 31 установка
- [price-check](https://affpapa.org/nevibecode/skills/price-check.md) — скилл · ★ 38 у репозитория
- [month-end-prep](https://affpapa.org/nevibecode/skills/ilyautov-month-end-prep.md) — скилл · ★ 38 у репозитория
- [1c-rest-mcp](https://affpapa.org/nevibecode/mcp/1c-rest-mcp.md) — MCP-сервер · ★ 13 у репозитория
- [Yzel — 1C:Enterprise](https://affpapa.org/nevibecode/mcp/yzel-1centerprise.md) — MCP-сервер · ★ 9 у репозитория
- [azure-role-selector](https://affpapa.org/nevibecode/skills/azure-role-selector.md) — скилл · 9399 установок

Из того же набора: [nikolay-shirokov/cc-1c-skills](https://affpapa.org/nevibecode/by/nikolay-shirokov/cc-1c-skills.md) — 81 карточка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
