steelmorgan/agent-debug
framework/skills/tool-usage/diagnostics/agent-debug/SKILL.md
Паттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
$ install --global
skillsauthnpx skillsauth add steelmorgan/1c-agent-based-dev-framework agent-debugInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 23, 2026, 5:03 AM16.2s1 file scanned
SKILL.md
- name:
- agent-debug
- description:
- Паттерн отладочных сообщений для 1С BSL. Используй, когда стандартная диагностика (event-log, скриншоты) не даёт понять фактическое поведение системы — нужно вставить временные точки логирования в код, запустить тест и проанализировать записи ЖР.
Отладочные сообщения (Agent Debug)
Когда применять
| Триггер | Действие | |---------|----------| | Стандартная диагностика не даёт понять поведение | Вставить debug-точки | | Гипотеза о причине ошибки — нужно подтвердить/опровергнуть | Логировать ключевые значения | | Непонятно какая ветка кода выполняется | Расставить маркеры по веткам |
НЕ применять если ответ можно получить чтением кода, event-log или скриншотом.
Формат debug-блока
//[AGENTDEBUG-001]
ЗаписьЖурналаРегистрации("AgentDebug",
УровеньЖурналаРегистрации.Информация, , ,
"STEP=001 PROC=ОбработкаПроведения MSG=Проверка суммы"
+ " | СуммаДокумента=" + Строка(СуммаДокумента)
+ " | Статус=" + Строка(Статус));
///[AGENTDEBUG-001]
Правила маркеров
- Открывающий:
//[AGENTDEBUG-NNN] - Закрывающий:
///[AGENTDEBUG-NNN](три слэша) - NNN — порядковый номер точки (001, 002, ...)
- Между маркерами — ТОЛЬКО отладочный код. Никакого рабочего кода внутри блока
- Вложенность блоков запрещена
Параметры ЗаписьЖурналаРегистрации
| Параметр | Значение | Зачем |
|----------|----------|-------|
| ИмяСобытия | "AgentDebug" | Фильтрация: все debug-записи одним запросом |
| Уровень | Информация | Надёжно сохраняется в ЖР (Примечание может не сохраняться) |
| МетаданныеОбъекта | Неопределено или конкретный объект | Если очевиден — указать для дополнительной фильтрации |
| Данные | Ссылка на объект или Неопределено | Для корреляции с конкретным документом/элементом |
| Комментарий | STEP=NNN PROC=... MSG=... \| key=value | Структурированный формат, легко парсить |
Формат комментария
STEP=001 PROC=ОбработкаПроведения MSG=Краткое описание гипотезы | Ключ1=Значение1 | Ключ2=Значение2
STEP— номер точки (совпадает с маркером)PROC— имя процедуры/функцииMSG— что проверяем (гипотеза)- После
|— ключевые значения в форматеkey=value - Не логировать: большие структуры, таблицы значений, двоичные данные, пароли
Процедура
- Сформулировать гипотезу — что именно проверяем и зачем
- Определить точки — где в коде вставить логирование (1-3 на гипотезу, макс 5)
- Вставить debug-блоки с маркерами
//[AGENTDEBUG-NNN]...///[AGENTDEBUG-NNN] - Запустить тест — unit-тест или Vanessa-сценарий
- Прочитать ЖР — фильтр по
ИмяСобытия = "AgentDebug", сортировка по времени - Сделать вывод — гипотеза подтверждена/опровергнута
- Удалить ВСЕ debug-блоки (см. чек-лист очистки)
Если одной итерации недостаточно — скорректировать точки и повторить (шаги 2-6). Если нужно 10+ точек — гипотеза слишком широкая, разбить на несколько.
Где вставлять
Порядок поиска подходящего места:
- Модуль формы — обработчики событий, ПриИзменении, ПередЗаписью
- Модуль объекта — ОбработкаПроведения, ПередЗаписью, ПриЗаписи
- Модуль менеджера — если логика в менеджере
- Общие модули — если вызов уходит в общий модуль
Изучение кода предпочтительно делегировать сабагенту (Explorer / code-navigation).
Чек-лист очистки
MUST перед завершением задачи:
- Поиск в коде:
AGENTDEBUG— ни одного вхождения не должно остаться - Проверить что удалены только строки между маркерами, рабочий код не затронут
- Проверить синтаксис модулей после удаления
- Убедиться что комментарии-маркеры тоже удалены (открывающий и закрывающий)
Удаление построчно:
- Найти строку с
//[AGENTDEBUG-NNN] - Удалять все строки до парной
///[AGENTDEBUG-NNN]включительно - Если парный маркер не найден — СТОП, сообщить об ошибке
Антипаттерны
| Антипаттерн | Последствие | |-------------|-------------| | Рабочий код внутри debug-блока | Удаление блока сломает бизнес-логику | | Debug-блоки оставлены в финальном коде | Засорение ЖР, утечка данных | | 10+ точек на одну гипотезу | Широкая гипотеза, непонятный результат | | Логирование таблиц значений / больших структур | Переполнение ЖР, замедление | | Свободный текст вместо key=value | Сложно парсить при анализе |
depends_on:
- framework/skills/tool-usage/diagnostics/event-log-analysis/SKILL.md
Related Skills
steelmorgan/vanessa-diagnostics
tools
VerifiedTrustedCommunity
Diagnostics for Vanessa Automation runs. Use when a feature scenario failed, artifacts were not created, or you need to classify a failure after launch.
65SKILL.mdUpdated May 26, 2026
steelmorgan/vanessa-authoring
tools
VerifiedTrustedCommunity
Creating and refining Vanessa Automation feature scenarios based on real project requirements. Use when you need to write or update a scenario test, not just run it.
65SKILL.mdUpdated May 26, 2026
steelmorgan/framework_eng/skills/tool-usage/v8-session-manager
tools
VerifiedTrustedCommunity
--- name: v8-session-manager description: Use when working with the 1С session manager (v8-session-manager) - launch, configuration, connecting 1С clients, reading session_list, calling proxied MCP-tools from 1С extensions, diagnostics. Triggers: mention of `v8-session-manager`, `session_list`, 1С extension MCP showcase, error “no active sessions” / “session_id required”, connecting a client to the manager via `mcpMode=ws`. provides_capabilities: # Built-in manager tools — always available whi
65SKILL.mdUpdated May 26, 2026
steelmorgan/v8-runner
tools
VerifiedTrustedCommunity
Use when Codex needs to manage v8-runner on local 1C projects through the CLI: configure v8project.yaml, initialize infobases or EDT workspaces, build sources from Designer or EDT, run syntax checks and tests, dump infobase changes, convert source formats, load or export artifacts, launch 1C clients, or choose safe 1C automation command sequences.
65SKILL.mdUpdated May 26, 2026