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

db-list — скилл для Claude Code: что делает и как установить

Скилл db-list управляет реестром информационных баз 1С в файле .v8-project.json. Связывает базы с ветками Git, хранит пути к платформе и реквизиты хранилищ.

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

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

Что делает db-list

Скилл настраивает и читает файл конфигурации .v8-project.json в корне репозитория. В нём хранятся параметры файловых и серверных баз 1С, алиасы для быстрого вызова, привязка к веткам Git и пути к платформе 1cv8.exe.

Команда /db-list выводит список баз. Вызов /db-list add запускает интерактивное добавление, а аргументы show и remove показывают детали или удаляют запись. Другие скиллы набора используют этот реестр, чтобы автоматически определять целевую базу по текущей ветке в Git.

Файл содержит пароли к базам и хранилищам конфигурации. Поэтому .v8-project.json нужно сразу добавить в .gitignore.

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

  • зарегистрировать новую базу 1С в файле .v8-project.json
  • привязать информационную базу к веткам Git или шаблонам веток
  • посмотреть параметры подключения и реквизиты хранилища конфигурации
  • удалить устаревшую базу из проектного реестра

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

  • /db-list
  • /db-list add
  • /db-list show dev

Как установить db-list

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

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

~/.claude/skills/db-list/SKILL.md

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

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

Вопросы о db-list

Как установить db-list в Claude Code?

Выполните команду /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем установите плагин вызовом /plugin install 1c-skills@cc-1c-skills. Также доступна установка через npx: npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-list -a claude-code.

Зачем нужен скилл db-list?

Он ведёт локальный реестр баз 1С для текущего репозитория. Другие инструменты автора берут из него параметры авторизации и пути к платформе без ручного ввода.

Где хранится список баз данных?

В файле .v8-project.json в корне проекта рядом с каталогом .git/.

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

SKILL.md · MIT
---
name: db-list
description: Управление реестром баз данных 1С (.v8-project.json). Используй когда нужно работать с реестром баз — список баз, зарегистрировать базу в реестре, какие базы есть
argument-hint: "[add|remove|show]"
allowed-tools:
  - Read
  - Write
  - Glob
  - AskUserQuestion
---

# /db-list — Управление реестром баз данных

Управляет файлом `.v8-project.json` — реестром информационных баз проекта. Файл хранит параметры подключения, алиасы, привязку к веткам Git.

## Usage

```
/db-list                    — показать список баз
/db-list add                — добавить базу (интерактивно)
/db-list remove <id>        — удалить базу из реестра
/db-list show <id|alias>    — подробности по базе
```

## Формат `.v8-project.json`

Файл размещается в корне проекта (рядом с `.git/`).

```json
{
  "v8path": "C:\\Program Files\\1cv8\\8.3.25.1257\\bin",
  "v8args": ["/UseHwLicenses+"],
  "databases": [
    {
      "id": "dev",
      "name": "Разработка",
      "type": "file",
      "path": "C:\\Bases\\MyApp_Dev",
      "v8path": "C:\\Program Files\\1cv8\\8.3.27.1688\\bin",
      "user": "Admin",
      "password": "",
      "aliases": ["dev", "разработка"],
      "branches": ["dev", "develop", "feature/*"],
      "configSrc": "C:\\WS\\myapp\\cfsrc",
      "repository": {
        "path": "\\\\srv01\\repo\\MyApp",
        "user": "Ivanov",
        "password": ""
      },
      "extensions": [
        {
          "name": "МоёРасширение",
          "src": "src\\cfe\\МоёРасширение",
          "repository": { "path": "\\\\srv01\\repo\\MyApp_Ext", "user": "Ivanov", "password": "" }
        }
      ]
    },
    {
      "id": "test",
      "name": "Тестовая",
      "type": "server",
      "server": "srv01",
      "ref": "MyApp_Test",
      "user": "Admin",
      "password": "123",
      "aliases": ["test", "тест"]
    }
  ],
  "default": "dev"
}
```

### Поля корневого объекта

| Поле | Тип | Описание |
|------|-----|----------|
| `v8path` | string | Каталог bin платформы 1С. Необязательный — если не задан, автоопределение |
| `v8args` | array | Доп. аргументы запуска `1cv8.exe` для всех навыков, напр. `["/UseHwLicenses+"]` |
| `ibcmdargs` | array | Доп. аргументы `ibcmd` (форма `--ключ=значение`) |
| `newObjectPosition` | `"end"` / `"byName"` | Куда попадает новый объект в составе конфигурации: в конец своего вида (по умолчанию) или на место по имени. Переопределяется в `databases[]` |
| `extensionApplyCheck` | bool | Проверять ли применимость расширения после загрузки в базу (по умолчанию `true`). Разово отключается ключом `-NoApplyCheck` |
| `externalCheck` | bool | Проверять ли исходники внешней обработки/отчёта платформой перед сборкой (по умолчанию `true`). Разово отключается ключом `-Checks off` |
| `xsdPath` | string | Каталог XSD-схем платформы для проверки выгрузок по версиям формата; по умолчанию `.v8-xsd` рядом с этим файлом. Наполняется `/v8-xsd-fetch` |
| `databases` | array | Массив баз данных |
| `default` | string | id базы по умолчанию |

### Поля объекта базы данных

| Поле | Тип | Обязательное | Описание |
|------|-----|:------------:|----------|
| `id` | string | да | Уникальный идентификатор (латиница, без пробелов) |
| `name` | string | да | Человекочитаемое имя |
| `type` | `"file"` / `"server"` | да | Тип подключения |
| `path` | string | для file | Путь к каталогу файловой базы |
| `server` | string | для server | Адрес сервера 1С |
| `ref` | string | для server | Имя базы на сервере |
| `v8path` | string | нет | Платформа именно этой базы — перекрывает корневой `v8path` (см. ниже) |
| `user` | string | нет | Имя пользователя 1С |
| `password` | string | нет | Пароль |
| `aliases` | string[] | нет | Альтернативные имена для быстрого доступа |
| `branches` | string[] | нет | Git-ветки или glob-паттерны (`release/*`, `feature/*`), привязанные к этой базе |
| `configSrc` | string | нет | Каталог XML-выгрузки конфигурации |
| `repository` | object | нет | Хранилище конфигурации: `path`, `user`, `password` (см. ниже) |
| `extensions` | array | нет | Расширения: `name`, `src`, необязательное `repository` (см. ниже) |

### Хранилище конфигурации

База, подключённая к хранилищу конфигурации 1С, **не принимает ни одной операции конфигуратора**
без реквизитов доступа к хранилищу — это касается не только `/db-repo`, но и `/db-load-xml`,
`/db-dump-xml`, `/db-update`, `/db-load-git`. Реквизиты берутся из `repository` записи базы,
передавать их в каждом вызове не нужно.

| Поле | Тип | Обязательное | Описание |
|------|-----|:------------:|----------|
| `repository.path` | string | да | Каталог хранилища или `tcp://<хост>[:<порт>]/<имя>` |
| `repository.user` | string | нет | Пользователь **хранилища**. Не наследуется от `user` базы |
| `repository.password` | string | нет | Пароль пользователя хранилища |

У расширения **своё хранилище** со своим путём, поэтому одного `repository` мало:

| Поле | Тип | Обязательное | Описание |
|------|-----|:------------:|----------|
| `extensions[].name` | string | да | Имя расширения, как в конфигурации |
| `extensions[].src` | string | нет | Каталог XML-исходников расширения |
| `extensions[].repository` | object | нет | Хранилище расширения. Расширение без хранилища — обычный случай |

Пароль хранилища — такой же секрет, как `password` базы; `.v8-project.json` в `.gitignore`.

> **Сетевое хранилище.** Адрес — `tcp://<хост>[:<порт>]/<имя>`, порт по умолчанию 1542.
> Обслуживается сервером хранилища. Если он недоступен, платформа отвечает «Соединение с
> хранилищем конфигурации не установлено» — тем же сообщением, что и при отсутствии реквизитов.

## Алгоритм разрешения базы данных

Этот алгоритм используется ВСЕМИ навыками (`db-*`, `epf-build`, `epf-dump`, `erf-build`, `erf-dump`) для определения целевой базы.

1. Если пользователь указал **параметры подключения** (путь, сервер) — используй напрямую
2. Если пользователь указал **базу по имени** — ищи совпадение в таком порядке:
   1. По `id` (точное совпадение)
   2. По `aliases` (совпадение в массиве с учётом морфологии: «тестовую» = «тестовая» = «тестовой»)
   3. По `name` (нечёткое совпадение с учётом морфологии и регистра)
3. Если пользователь **не указал** базу — сопоставь текущую ветку Git с `databases[].branches`:
   - Точное совпадение: ветка `dev` → `"branches": ["dev"]`
   - Glob-паттерн: ветка `release/2.1` → `"branches": ["release/*"]`
4. Если ветка не совпала — используй `default`
5. Если не найдено или неоднозначно — спроси пользователя
6. Если файл `.v8-project.json` не найден — спроси параметры подключения и предложи создать файл

После выполнения: если использованная база не зарегистрирована — предложи добавить через `/db-list add`.

### Выбор платформы

Порядок: явный `-V8Path` в вызове → `v8path` записи базы → корневой `v8path` → автоопределение.
Запись базы находит сам скрипт, сопоставляя параметры соединения с `databases[]`, — передавать
`-V8Path` руками не нужно. Поле у базы нужно, когда базы проекта живут на разных версиях платформы:
формат XML-выгрузки задаёт та платформа, которая выгружает, а автоопределение берёт самую старшую
установленную.

Если `v8path` не задан нигде:

```powershell
$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1
```

## Операции

### Показать список баз

Прочитай `.v8-project.json`, выведи таблицу:

```
ID      Имя           Тип      Путь/Сервер              По умолч.
dev     Разработка    file     C:\Bases\MyApp_Dev       ✓
test    Тестовая      server   srv01/MyApp_Test
```

### Добавить базу

Спроси у пользователя через AskUserQuestion:
- id, name, type (file/server)
- path (для file) или server + ref (для server)
- user, password (необязательно)
- aliases, branches (необязательно)
- если база под хранилищем конфигурации — `repository`: путь, пользователь, пароль

Добавь в массив `databases`. Если это первая база — установи как `default`.

### Удалить базу

Удали из массива `databases` по id. Если удаляемая была `default` — спросить новый default.

### Подробности по базе

Выведи все поля конкретной базы.

## Формирование строки подключения

Для использования в шаблонах команд других навыков:

**Файловая база:**
```
/F "<path>"
```

**Серверная база:**
```
/S "<server>/<ref>"
```

**Аутентификация** (добавляется если user задан):
```
/N"<user>" /P"<password>"
```

> **Важно**: между `/N` и именем пробела нет. Между `/P` и паролем пробела нет. Если пароль пустой — опусти `/P` целиком.

**Хранилище конфигурации** (если у базы задан `repository`) — скрипты навыков подставляют
сами, сопоставляя параметры соединения с записью реестра:
```
/ConfigurationRepositoryF"<path>" /ConfigurationRepositoryN"<user>" /ConfigurationRepositoryP"<password>"
```

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

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

Всё по теме «1С» →
supabase-audit-tables-list yoanbernabeu Скилл supabase-audit-tables-list для Claude Code и других агентов перечисляет таблицы, открытые через PostgREST API Supabase, и классифицирует их по уровню риска. Запускается перед проверкой RLS-политик или инвентаризацией публичной схемы. CX Codex +1 524установок nodejs-core mcollina Скилл nodejs-core для правок и отладки ядра Node.js: коммиты и PR в nodejs/node, нативные краши, V8, node-gyp, N-API и libuv. CX Codex +1 2 100установок Yzel — 1C:Enterprise Aiyo28 Yzel — 1C:Enterprise — MCP-сервер для Claude Code, который подключает AI-ассистента к базам 1С:Предприятие через OData v3. Работает с локальными инсталляциями и 1С:Fresh. CX Codex +1 ★ 9звёзд репо close-month ilyautov Скилл close-month сверяет данные бухгалтерии с эквайрингом и выписками, находит расхождения и собирает отчётный пакет закрытия месяца. CX Codex +1 ★ 38звёзд репо browser-exploitation-v8 yaklang Скилл browser-exploitation-v8 для Claude Code описывает эксплуатацию уязвимостей JavaScript-движка: JIT type confusion, обход границ массива и побег из песочницы V8 для CTF и анализа багов Chrome. CX Codex +1 4 000установок groove-utilities-task-list andreadellacorte Скилл groove-utilities-task-list для Claude Code и ещё пяти платформ показывает активные задачи из настроенного бэкенда, сгруппированные по статусу. Выводит задачи в работе, готовые к старту и заблокированные — с указанием, чего они ждут. CX Codex +1 579установок

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

Весь набор →
db-dump-xml Скилл db-dump-xml выгружает конфигурацию 1С в XML-файлы. Подходит для полной, инкрементальной или частичной выгрузки исходников. CX Codex +1 44установок db-create Скилл db-create для Claude Code и Codex создаёт файловую или серверную информационную базу 1С. Создаёт новую пустую базу или базу из шаблона. CX Codex +1 44установок web-unpublish Скилл web-unpublish для Claude Code и Codex. Удаляет веб-публикацию 1С из Apache: блок в httpd.conf и каталог publish/{appname}. Закрывает базу от веб-доступа. CX Codex +1 43установок db-load-cf Скилл db-load-cf для Claude Code загружает конфигурацию 1С из CF-файла в информационную базу. Он включается при восстановлении базы из CF или замене её конфигурации. CX Codex +1 43установок db-dump-cf Скилл db-dump-cf для Claude Code выгружает конфигурацию или расширения базы 1С в бинарный CF-файл через PowerShell-скрипт. Выгрузка используется для резервного копирования и фиксации состояния конфигурации. CX Codex +1 43установок skd-decompile Скилл skd-decompile разбирает схему компоновки данных 1С из Template.xml в JSON-черновик для генератора skd-compile. Помогает собрать новый отчёт по готовому образцу. CX Codex +1 40установок support-edit Скилл support-edit для Claude Code меняет состояние поддержки конфигурации 1С и отдельных объектов. Открывает закрытые для редактирования объекты и снимает объекты с поддержки. CX Codex +1 38установок form-decompile Скилл form-decompile для Claude Code читает управляемую форму 1С и выдаёт JSON-черновик в формате form-compile. Запускается при scaffold новой формы по образцу или структурном рефакторинге дерева элементов. CX Codex +1 38установок

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

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