metadata-discovery

$npx mdskill add SteelMorgan/1c-agent-based-dev-framework/metadata-discovery

Enables agents to discover and analyze 1C configuration metadata objects like directories and documents, ensuring accurate data handling.

  • Helps agents avoid errors by understanding metadata structure before interacting with business logic.
  • Integrates with 1C metadata tools for listing objects, retrieving structures, and analyzing code.
  • Decides actions by verifying object existence and type, then guiding users through creation if needed.
  • Presents results through structured metadata descriptions and verification steps for user confirmation.

SKILL.md

.github/skills/metadata-discoveryView on GitHub ↗
---
name: metadata-discovery
description: Работа с метаданными (Metadata Discovery). Навык учит агента **работать с метаданными конфигурации 1С** — находить объекты (справочники, документы, регистры, обработки), понимать их структуру и связи.
---

# Работа с метаданными (Metadata Discovery)

**Принцип:** Перед работой с бизнес-логикой — исследовать метаданные. Не создавать объекты «наугад», если пользователь не попросил явно.

## Инструменты

| Tool | Параметры | Назначение |
|------|-----------|------------|
| `list_metadata_objects` | metaType, nameMask, maxItems | Поиск объектов по типу и маске имени |
| `get_metadata_structure` | metaType, name | Структура: реквизиты, ТЧ, измерения, ресурсы |
| `navigate_symbol` | — | Переход к модулям, процедурам найденных объектов |
| `get_call_graph` | — | Анализ цепочек вызовов в модулях |

## Алгоритм работы

1. **Найти объект:** `list_metadata_objects(metaType, nameMask)` — проверить существование и тип. Для нечёткого поиска: `nameMask: "*Номенклатура*"`.
2. **Получить структуру:** `get_metadata_structure(metaType, name)` — реквизиты, ТЧ, измерения, ресурсы. Обязательно перед построением запроса.
3. **Анализ кода (при необходимости):** `navigate_symbol` → `get_call_graph`.
4. **Создание нового объекта:** агент НЕ создаёт объекты метаданных автоматически. Алгоритм: проверить что не существует → описать пользователю (имя, реквизиты, ТЧ) → пользователь создаёт в Конфигураторе/EDT → `get_metadata_structure` для верификации.

## Типичные ошибки

| Ошибка | Решение |
|--------|---------|
| Поиск по общему слову даёт много результатов | Сузить nameMask; указать metaType; уменьшить maxItems |
| Агент пытается создать объект сам | Протокол: агент описывает, пользователь создаёт в Конфигураторе/EDT |

---
depends_on: []
---

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-исходники. Используй, когда нужно быстро получить исходный код внешней обработки или отчета для анализа и временной модификации.