epf-dump — скилл для Claude Code: выгрузка XML-исходников из EPF
Скилл epf-dump для Claude Code разбирает обработки 1С в формате EPF/ERF и выгружает XML-исходники. Извлекает код из готового файла обработки.
MIT 50 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает epf-dump
epf-dump принимает путь к EPF или ERF и выгружает содержимое в XML-исходники. Каталог результата можно передать вторым аргументом; по умолчанию используется src. Скилл работает через PowerShell-скрипт epf-dump.ps1 и применяет инструменты Bash, Read, Glob и Grep.
Перед разборкой нужна информационная база 1С с конфигурацией. Скилл читает .v8-project.json, выбирает базу по указанным параметрам или текущей ветке Git, а затем передаёт подключение скрипту. Без базы ссылочные типы вроде CatalogRef и DocumentRef безвозвратно превращаются в строки, поэтому пустая база для этой операции не подходит.
Какие задачи решает
- получить XML-исходники из EPF-файла
- разобрать ERF-обработку в каталог
src - декомпилировать обработку 1С через подключённую базу
- сохранить ссылочные типы при выгрузке исходников
Примеры запросов агенту
- Разбери
build/МояОбработка.epfи положи исходники вsrcкомандой/epf-dump build/МояОбработка.epf src. - Получи исходники из
build/МояОбработка.erfкомандой/epf-dump build/МояОбработка.erf. - Разбери
build/МояОбработка.epfв каталогdumpкомандой/epf-dump build/МояОбработка.epf dump.
Как установить epf-dump
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-dump -a claude-code3Вручную: положить файлы
~/.claude/skills/epf-dump/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/epf-dump/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill epf-dump -a codex2Вручную: положить файлы
.agents/skills/epf-dump/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill epf-dump -a cursor2Вручную: положить файлы
.cursor/skills/epf-dump/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/epf-dump2Вручную: положить файлы
.github/skills/epf-dump/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill epf-dump -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/epf-dumpВручную: положить файлы
.devin/skills/epf-dump/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об epf-dump
Как установить epf-dump в Claude Code?
Выполните /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills.
Что делает epf-dump?
Скилл разбирает EPF- и ERF-файлы обработок 1С и выгружает их в XML-исходники. Результат можно направить в выбранный каталог.
Какая база нужна для работы epf-dump?
Нужна информационная база 1С с конфигурацией. Без неё ссылочные типы при разборке безвозвратно сбрасываются в строки.
Исходный текст
SKILL.md · MIT
---
name: epf-dump
description: Разобрать EPF-файл обработки 1С (EPF/ERF) в XML-исходники. Используй когда пользователь просит разобрать, декомпилировать обработку, получить исходники из EPF/ERF файла
argument-hint: <EpfFile>
allowed-tools:
- Bash
- Read
- Glob
- Grep
---
# /epf-dump — Разборка обработки
## Usage
```
/epf-dump <EpfFile> [OutDir]
```
| Параметр | Обязательный | По умолчанию | Описание |
|----------|:------------:|--------------|-------------------------------------|
| EpfFile | да | — | Путь к EPF-файлу |
| OutDir | нет | `src` | Каталог для выгрузки исходников |
## Параметры подключения (обязательно)
Для разборки EPF/ERF требуется информационная база с конфигурацией. Без базы ссылочные типы безвозвратно теряются.
1. Прочитай `.v8-project.json` из корня проекта и разреши базу:
2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
5. Если ветка не совпала — используй `default`
6. Если `.v8-project.json` нет или база не найдена — **сообщи пользователю об ошибке**. Для dump база обязательна: в пустой базе ссылочные типы (CatalogRef, DocumentRef и т.д.) безвозвратно сбрасываются в строки. Предложи указать базу или зарегистрировать через `/db-list add`.
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
## Команда
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" <параметры>
```
### Параметры скрипта
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-InputFile <путь>` | да | Путь к EPF/ERF-файлу |
| `-OutputDir <путь>` | да | Каталог для выгрузки исходников |
| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
> `*` — обязательно хотя бы одно подключение. Без базы скрипт завершится с ошибкой (dump в пустой базе безвозвратно теряет ссылочные типы)
## Примеры
```powershell
# Разборка обработки (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBasePath "C:\Bases\MyDB" -InputFile "build/МояОбработка.epf" -OutputDir "src"
# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/epf-dump.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build/МояОбработка.epf" -OutputDir "src"
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills