Skip to main content
skill CX Codex

epf-dump — Claude Code skill: extract XML source from EPF

epf-dump extracts XML source files from 1C EPF and ERF processing files. Use it when a ready-made processing file needs to be inspected or recovered as source.

MIT 50 installs ★ 811 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Open on GitHub

What epf-dump does

epf-dump takes an EPF or ERF file and exports its contents as XML source files. The output directory can be passed as the second argument; src is used when it is omitted. The skill runs epf-dump.ps1 through PowerShell and has access to Bash, Read, Glob, and Grep.

The dump requires a 1C information base with its configuration. The skill reads .v8-project.json, resolves a base from connection details or the current Git branch, then passes the selected connection to the script. A base is required because an empty base causes reference types such as CatalogRef and DocumentRef to be permanently written as strings.

What it helps with

  • extract XML source from an EPF file
  • unpack an ERF processing file into src
  • decompile a 1C processing file through a connected base
  • preserve reference types during source export

Example prompts for the agent

  • Run /epf-dump build/MyProcessing.epf src to unpack build/MyProcessing.epf into src.
  • Use /epf-dump build/MyProcessing.erf to export the ERF source files to the default directory.
  • Send /epf-dump build/MyProcessing.epf dump to write the result to dump.

How to install epf-dump

1Plugin marketplace

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

This installs the whole 1c-skills plugin with all its skills

2Skills CLI (Vercel)

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

3Manually: put the files in place

~/.claude/skills/epf-dump/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/epf-dump/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about epf-dump

How do I install epf-dump in Claude Code?

Run /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then run /plugin install 1c-skills@cc-1c-skills.

What does epf-dump do?

The skill unpacks 1C EPF and ERF processing files into XML source files. You can choose the directory where the exported files are written.

What does epf-dump need to preserve 1C reference types?

It needs a 1C information base with the configuration. Without that base, reference types are permanently converted to strings during the dump.

Source text

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

Similar skills

Everything for 1C →

From the same set81

The whole set →
skd-edit skd-edit makes targeted edits to an existing 1C data composition schema: adds fields, totals, filters and parameters, or swaps the query text. CX Codex +1 52installs web-test web-test automates 1C:Enterprise web client testing using Playwright. It runs navigation commands, fills out forms, reads UI states, and captures screenshots. CX Codex +1 50installs meta-compile meta-compile generates 1C metadata XML files and modules from JSON definitions and registers them in Configuration.xml. Useful for scaffolding catalogs, documents, and registers. CX Codex +1 50installs erf-validate erf-validate is a Claude Code skill that checks the XML structure of a 1C external report after creation or changes, helping find errors before building. CX Codex +1 50installs cfe-validate cfe-validate validates 1C configuration extension (CFE) source files, checking XML structure, role permissions, and borrowed objects before database loading. CX Codex +1 50installs cfe-init Generates 1C configuration extension scaffold: Configuration.xml, languages, optional roles. Triggered by /cfe-init with name and purpose (Patch, Customization, AddOn). CX Codex +1 50installs cf-validate cf-validate runs structural checks over a 1C Configuration.xml after you create or edit a configuration. One command from Claude or Codex. CX Codex +1 50installs meta-validate meta-validate is a Claude Code skill that checks exported 1C metadata XML for structural errors after an object is created or changed. CX Codex +1 49installs

More in the catalog

Project sponsors

Companies that keep this analytics open