syntax-checking

Name: syntax-checking
Author: SteelMorgan/1c-agent-based-dev-framework

$npx mdskill add SteelMorgan/1c-agent-based-dev-framework/syntax-checking

Enables immediate syntax checking of BSL code after modifications to prevent non-functional code from being committed.

Helps agents avoid completing tasks with broken code by ensuring syntax validation.
Integrates with BSL development tools, including EDT and designer modes for validation.
Triggers checks based on code changes, commits, refactoring, or compilation errors.
Presents results via success status, error details, and warnings for actionable feedback.

SKILL.md

.github/skills/syntax-checkingView on GitHub ↗

---
name: syntax-checking
description: Проверка синтаксиса (Syntax Checking). Навык учит агента **правильно использовать возможности проверки синтаксиса** BSL-кода.
---

# Проверка синтаксиса (Syntax Checking)

Любое изменение BSL-кода → немедленный `check_syntax`. Без проверки агент может «успешно» завершить задачу с нерабочим кодом.

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

| Триггер | Действие |
|---------|----------|
| После изменения BSL-кода | `check_syntax` |
| Перед коммитом | Обязательная проверка изменённых файлов |
| После рефакторинга / `rename_symbol` | Проверка затронутых модулей |
| Ошибка компиляции | `check_syntax` для локализации |

## Алгоритм проверки

1. `check_syntax(target: "путь/Module.bsl", mode: "edt")` — режим по умолчанию (EDT validate).
2. `success = false` → прочитать `errors`, исправить, повторить.
3. EDT недоступен → fallback: `mode: "designer_config"` (CheckConfig) или `mode: "designer_modules"` (CheckModules). Требуют подключения к ИБ.
4. Для быстрой обратной связи по файлу — `get_diagnostics(uri)`. Частичный заменитель, если `check_syntax` недоступен.
5. После рефакторинга нескольких модулей — `target: "all"` или по каждому.

## Интерпретация результатов

| Поле | Действие |
|------|----------|
| `success: true` | Продолжать |
| `success: false` | Исправить `errors` (каждая: `file`, `line`, `message`, `severity`) |
| `warnings` | Оценить критичность |
| Таймаут | Сузить `target` до отдельных модулей |

Severity: `error` (блокирует компиляцию) > `warning` > `information` / `hint`.

При расхождении `get_diagnostics` и `check_syntax` — ориентироваться на `check_syntax` как финальный вердикт.

## Capabilities

| Capability | Назначение |
|------------|------------|
| `check_syntax` | Формальная проверка (EDT / Designer) |
| `get_diagnostics` | LSP-диагностика файла (быстро) |

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

| Ошибка | Обходной путь |
|--------|---------------|
| EDT не запущен | `get_diagnostics` или `designer_config` / `designer_modules` |
| Таймаут `target: "all"` | Проверять по модулям |
| Проект EDT не найден | Проверить путь, `sourceSet`; использовать Designer |
| Непонятные `errors` | `navigate_symbol` к месту ошибки; `ask_ai_assistant` |

---
depends_on: []
---

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

Skill	Description
1c-ai-agent-cli	CLI 1C BSL Agent Framework — tools/install.py (clone, install). Используй при клонировании репозитория, установке компонентов в проект, настройке IDE (Cursor, Claude Code, Windsurf, VS Code+Continue).
agent-debug	Паттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
agent-development	Create 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-workflow	Standardizes 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-bootstrap	Deterministic 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-исходники. Используй, когда нужно быстро получить исходный код внешней обработки или отчета для анализа и временной модификации.