subsystem-operations

$npx mdskill add SteelMorgan/1c-agent-based-dev-framework/subsystem-operations

Compile, edit, validate, and analyze 1C subsystems and command interfaces for configuration management.

  • Helps create subsystems, manage object composition, and configure command visibility in 1C environments.
  • Integrates with 1C platform tools for subsystem JSON compilation and CommandInterface.xml operations.
  • Executes commands based on user triggers like subsystem creation, validation, or interface adjustments.
  • Presents results through command-line outputs, including subsystem analysis modes and validation feedback.

SKILL.md

.github/skills/subsystem-operationsView on GitHub ↗
---
name: subsystem-operations
description: Операции с подсистемами и командным интерфейсом 1С — compile, info, edit, validate. Используй при создании подсистем, управлении составом, настройке CommandInterface.
---

# Subsystem + Interface Operations

Работа с подсистемами 1С и командным интерфейсом.

## Когда применять

| Триггер | Действие |
|---------|----------|
| Нужно создать подсистему | `subsystem compile subsystem.json <output_dir>` |
| Нужно посмотреть состав подсистемы | `subsystem info <subsystemPath>` |
| Нужно добавить объект в подсистему | `subsystem edit <path> --op add-content --value "Catalog.Товары"` |
| Нужно проверить подсистему | `subsystem validate <subsystemPath>` |
| Нужно настроить видимость команд | `interface edit <ciPath> --op hide --value "..."` |
| Нужно проверить CommandInterface.xml | `interface validate <ciPath>` |
| Нужно посмотреть дерево подсистем | `subsystem info --mode tree <subsystemPath>` |

## Команды подсистем

### subsystem compile

Генерация подсистемы из JSON.

```bash
xml-gen subsystem compile <subsystem.json> <output_dir>
```

### subsystem info

Анализ подсистемы (5 режимов: brief, overview, full, tree, ci).

```bash
xml-gen subsystem info [--mode brief|overview|full|tree|ci] <subsystemPath>
```

### subsystem edit

```bash
xml-gen subsystem edit <subsystemPath> --op <operation> --value <value>
```

**Операции:**
- `add-content` — добавить объект: `"Catalog.Товары"` или `["Catalog.Товары","Document.Заказ"]`
- `remove-content` — удалить объект
- `add-child` — добавить дочернюю подсистему
- `remove-child` — удалить дочернюю подсистему
- `set-property` — `"IncludeInCommandInterface=true"`, `"Synonym=Торговля"`, `"Picture=CommonPicture.ТорговляИСклад"`

### subsystem validate

13 проверок: XML-структура, Properties, Content, ChildObjects, файлы, CommandInterface.

```bash
xml-gen subsystem validate <subsystemPath>
```

## Команды интерфейса

### interface edit

```bash
xml-gen interface edit <ciPath> --op <operation> --value <value>
```

**Операции:**
- `hide` — скрыть команду: `"Catalog.Товары.StandardCommand.Create"`
- `show` — показать команду
- `place` — разместить команду в группе: `"command=... group=NavigationPanelImportant"`
- `set-order` — порядок команд в группе
- `set-subsystem-order` — порядок подсистем
- `set-group-order` — порядок групп

### interface validate

13 проверок: секции, CommandsVisibility, CommandsPlacement, CommandsOrder, SubsystemsOrder, GroupsOrder.

```bash
xml-gen interface validate <ciPath>
```

## Формат ссылок на команды

- `CommonCommand.ИмяКоманды` — общая команда
- `Catalog.Товары.StandardCommand.Create` — стандартная команда
- `Catalog.Товары.Command.ПечатьЭтикетки` — команда объекта
- `0:<uuid>` — UUID-ссылка


---
depends_on: []
metadata:
  category: 1c-development
  version: "1.0"
---

More from SteelMorgan/1c-agent-based-dev-framework

SkillDescription
1c-ai-agent-cliCLI 1C BSL Agent Framework — tools/install.py (clone, install). Используй при клонировании репозитория, установке компонентов в проект, настройке IDE (Cursor, Claude Code, Windsurf, VS Code+Continue).
agent-debugПаттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
agent-developmentCreate custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants with custom prompts.
agent-development-ext>
agent-git-workflowStandardizes git workflow for the AI agent in the sandbox devcontainer: work in agent/<task>-<yyyymmdd>, integrate via agent, never push to main/master, open PRs via GitHub CLI. Use when the user asks to create branches, push changes, open PRs, or follow this sandbox repo setup.
auto-skill-bootstrapDeterministic helper to inventory existing project skills, detect missing capability coverage, search skills.sh via Skills CLI, and (optionally) install missing skills under a trust policy. Uses skills-manifest.json + state.json to stay idempotent across changing requirements.
code-navigationНавигация по коду (Code Navigation). Навык учит агента **эффективно перемещаться по BSL-коду** с помощью LSP (Language Server Protocol).
config-operationsОперации с конфигурацией 1С (CF) — init, info, edit, validate. Используй при создании конфигурации, анализе структуры, изменении свойств и ChildObjects, валидации Configuration.xml.
epf-buildСобрать EPF/ERF из XML-исходников. Используй после внесения временных диагностических правок в разобранную обработку.
epf-dumpРазобрать EPF/ERF в XML-исходники. Используй, когда нужно быстро получить исходный код внешней обработки или отчета для анализа и временной модификации.