Skip to main content
skill CX Codex

db-cfe-admin — Claude Code skill: manage 1C configuration extensions

db-cfe-admin manages 1C configuration extensions in an infobase: list connected extensions, check applicability and syntax, modify properties, delete.

MIT 26 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 db-cfe-admin does

The skill operates on extensions stored in the infobase via a PowerShell script db-cfe-admin.ps1. The /db-cfe-admin list command shows connected extensions, check runs applicability checks (apply) and module syntax validation (modules) in specified contexts (thin client, server, web client), set-properties modifies safe mode, activation status or scope, delete removes the extension from the infobase.

Connection parameters are read from .v8-project.json at the project root: the skill matches the current Git branch to configured databases or uses the default. Property modification requires ibcmd, which does not ship with every platform installation and only works with file-based infobases.

When an extension loads into an infobase for the first time, safe mode gets enabled by default — module extensions do not apply under safe mode. Syntax validation and applicability checks catch different error types; neither replaces the other.

What it helps with

  • list configuration extensions connected to a 1C infobase
  • check extension applicability and module syntax
  • disable safe mode or deactivate an extension
  • remove an extension from the infobase without unloading
  • run syntax checks in web client or server context

Example prompts for the agent

  • Show extensions connected to the infobase from .v8-project.json
  • Check applicability and syntax of extension MyExtension for web client
  • Turn off safe mode for extension MyExtension in database MyDB

How to install db-cfe-admin

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 db-cfe-admin -a claude-code

3Manually: put the files in place

~/.claude/skills/db-cfe-admin/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/db-cfe-admin/

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

Questions about db-cfe-admin

How to install db-cfe-admin in Claude Code?

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

What does db-cfe-admin do?

The skill manages configuration extensions on the 1C infobase side: lists them, checks applicability and syntax, modifies connection properties (safe mode, activation), deletes extensions.

What commands does db-cfe-admin support?

list shows extensions, check runs applicability and syntax validation, set-properties changes properties (safe mode, activation, scope), delete removes an extension from the infobase.

Source text

SKILL.md · MIT
---
name: db-cfe-admin
description: Управление расширениями конфигурации в информационной базе 1С. Используй когда нужно узнать какие расширения подключены к базе, выполнить проверку применимости или синтаксическую проверку, изменить безопасный режим или активность, удалить расширение из базы
argument-hint: <list|check|set-properties|delete> [database] [-Name <Имя>]
allowed-tools:
  - Bash
  - Read
  - Glob
  - AskUserQuestion
---

# /db-cfe-admin — Управление расширениями конфигурации

Расширения **на стороне базы**: состав и свойства подключения, проверки, удаление.
Про исходники расширения — другие навыки, см. «Смежное».

## Usage

```
/db-cfe-admin list           [database]
/db-cfe-admin check          [database] [-Name Расш1]
/db-cfe-admin set-properties [database] -Name Расш1 -SafeMode off
/db-cfe-admin delete         [database] -Name Расш1
```

## Параметры подключения

Прочитай `.v8-project.json` из корня проекта и разреши базу:
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
4. Если ветка не совпала — используй `default`

Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-cfe-admin.ps1" -Command <команда> <параметры>
```

### Общие параметры

| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-Command <команда>` | да | `list` / `check` / `set-properties` / `delete` |
| `-V8Path <путь>` | нет | Каталог bin платформы или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Пользователь базы |
| `-Password <пароль>` | нет | Пароль пользователя |
| `-Name <имя>` | усл. | Расширение. Обязателен для `set-properties`; в `delete` — вместо `-All`. Без него `list` и `check` работают по всем расширениям |
| `-All` | усл. | Только для `delete`: удалить все расширения. Вместо `-Name`, а не вместе с ним |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы `1cv8.exe` через запятую |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |

> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`

### Параметры `check`

| Параметр | Описание |
|----------|----------|
| `-Checks <список>` | `apply` — применимость расширения, `modules` — синтаксическая проверка, `config` — проверки конфигурации (целостность, ссылки, неиспользуемые процедуры и обработчики). Через запятую, по умолчанию `apply,modules` |
| `-Context <список>` | Контексты синтаксической проверки: `ThinClient`, `WebClient`, `Server`, `ExternalConnection`, `ThickClientManagedApplication`, `ThickClientOrdinaryApplication`, `MobileClient` и др. Через запятую, по умолчанию `ThinClient,Server` |

Применимость и синтаксис проверяют разное и друг друга не заменяют. Проверяется только
расширение: ошибки самой конфигурации сюда не попадают.

### Свойства `set-properties`

| Параметр | Описание |
|----------|----------|
| `-SafeMode <on/off>` | Безопасный режим |
| `-Active <on/off>` | Активность расширения |
| `-UnsafeActionProtection <on/off>` | Защита от опасных действий |
| `-UsedInDistributedInfobase <on/off>` | Использование в распределённой ИБ |
| `-Scope <область>` | `infobase` / `data-separation` |
| `-SecurityProfile <имя>` | Профиль безопасности |

Передавай только то, что меняешь: не указанное свойство остаётся как было. Расширение, впервые
попавшее в базу загрузкой, создаётся с включённым безопасным режимом, а в нём расширение модуля не
применяется.

Свойствами управляет `ibcmd` — он есть не в каждой установке платформы и работает с файловой базой;
остальные команды работают всегда.

## Смежное

| Задача | Навык |
|--------|-------|
| Создать расширение, заимствовать объекты, перехватить метод | `/cfe-init`, `/cfe-borrow`, `/cfe-patch-method`, `/cfe-validate` |
| Загрузить исходники расширения в базу | `/db-load-xml -Extension` (из коммита Git — `/db-load-git`) |
| Загрузить готовый `.cfe` | `/db-load-cf -Extension` |
| Выгрузить расширение из базы | `/db-dump-xml -Extension`, `/db-dump-cf -Extension` |
| Обновить конфигурацию базы после загрузки | `/db-update -Extension` |
| Проверить дрейф контролируемых методов по исходникам | `/cfe-patch-method -Check` |

## Примеры

```powershell
# Что подключено к базе
... -Command list -InfoBasePath "C:\Bases\MyDB"

# Проверить расширение
... -Command check -InfoBasePath "C:\Bases\MyDB" -Name "Расш1"

# Синтаксическая проверка в контексте веб-клиента
... -Command check -InfoBasePath "C:\Bases\MyDB" -Checks modules -Context WebClient,Server

# Снять безопасный режим
... -Command set-properties -InfoBasePath "C:\Bases\MyDB" -Name "Расш1" -SafeMode off

# Отключить, не удаляя
... -Command set-properties -InfoBasePath "C:\Bases\MyDB" -Name "Расш1" -Active off

# Убрать расширение из базы
... -Command delete -InfoBasePath "C:\Bases\MyDB" -Name "Расш1"
```

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

Similar skills

Everything for 1C →

From the same set81

The whole set →
xdto-edit xdto-edit is a Claude Code skill that edits types and properties in 1C XDTO packages. It makes targeted changes without rewriting the entire schema. CX Codex +1 36installs xdto-compile xdto-compile builds a 1C XDTO package from an XSD and writes it into configuration sources. Use it for data exchange, integrations, or web services. CX Codex +1 36installs meta-decompile meta-decompile reads a 1C metadata object XML and emits a compact JSON draft in the meta-compile format. Useful when a new object is easier to build from an existing one than to write from scratch. CX Codex +1 36installs xdto-info xdto-info inspects 1C XDTO packages, types, properties, and entry points. Use it before creating an XDTO object or parsing incoming XML. CX Codex +1 35installs db-repo The db-repo skill manages a 1C configuration repository: it locks objects, pulls updates, and commits changes. Use it from Claude Code or Codex. CX Codex +1 30installs role-edit role-edit edits an existing 1C role in place: permissions, RLS rules, templates, and role properties. Its changes preserve the role UUID and other rights. CX Codex +1 23installs v8-xsd-fetch v8-xsd-fetch downloads 1C XML export XSD schemas by format version into the project directory. Use it to inspect available versions or validate an export against its schema. CX Codex +1 17installs 1c-skills 1c-skills automates 1C:Enterprise 8.3 development in Claude Code: handles XML metadata, builds external data processors, manages database updates, and runs web tests. CX Codex ★ 811repo stars

Project sponsors

Companies that keep this analytics open