1c-test-runner

name	1c-test-runner
description	Этот скилл MUST быть вызван когда пользователь говорит "напиши тест", "протестируй модуль", "запусти unit-тесты" для 1С. SHOULD также вызывать после реализации бизнес-логики для верификации через 1c-ai-debug MCP. Do NOT использовать для UI-тестов — используй playwright-test или 1c-web-session.
allowed-tools	Read, Write, Edit, Glob, Grep, Bash, mcp__1c-ai-debug__run_unit_tests, mcp__1c-ai-debug__execute_1c_code

/1c-test-runner — AI-тестирование 1С без внешних зависимостей

Workflow для автономного тестирования бизнес-логики 1С:

• AI создаёт тестовые данные через 1c-ai-debug MCP (CRUD)
• AI пишет тест — CommonModule с суффиксом _Test
• Тест загружается в базу через /db-load-xml + /db-update
• AI запускает через MCP инструмент run_unit_tests
• Результат возвращается текстом/JSON — без скриншотов, без vanessa-runner

Предварительные требования

• 1c-ai-debug MCP подключён к проекту
• Расширение AI_Debug установлено и опубликовано в базе

Стек

Claude → 1c-ai-debug MCP (run_unit_tests) → 1С база
              ↑
         BSL: CommonModule *_Test (пишет Claude)
              ↑
         CRUD: create_catalog_item, create_document, post_document

---

Шаг 1 — Создать тестовые данные

{"name": "create_catalog_item", "arguments": {"catalogName": "Контрагенты", "data": {"Наименование": "TEST-001"}}}

{"name": "create_document", "arguments": {
  "documentType": "ПоступлениеТоваровУслуг",
  "header": {"Контрагент": "<ref>", "Дата": "2026-01-01T00:00:00"},
  "tables": {"Товары": [{"Номенклатура": "<ref>", "Количество": 10, "Цена": 100}]}
}}

{"name": "post_document", "arguments": {"documentType": "ПоступлениеТоваровУслуг", "documentRef": "<ref>"}}

---

Шаг 2 — Написать тест

Тест — CommonModule с суффиксом _Test. Пример модуля AI_SelfTest_Test уже в составе AI_Debug.

// CommonModules/ТестПроведенияПоступления_Test/Ext/Module.bsl

#Область СлужебныйПрограммныйИнтерфейс

Процедура ИсполняемыеСценарии() Экспорт
    ЮТТесты.ДобавитьТест("ПроведениеПоступленияФормируетДвижения");
КонецПроцедуры

Процедура ПроведениеПоступленияФормируетДвижения() Экспорт
    // Arrange — ссылка из шага 1
    ДокументСсылка = ПредопределённоеЗначение("...");  // или передать через параметры

    // Act + Assert
    Движения = РегистрыНакопления.ТоварыНаСкладах.СоздатьНаборЗаписей();
    Движения.Отбор.Регистратор.Установить(ДокументСсылка);
    Движения.Прочитать();

    ЮТУтверждения.Больше(Движения.Количество(), 0, "Ожидаются движения по регистру");
КонецПроцедуры

#КонецОбласти

API ЮТУтверждения (прямые вызовы)

ЮТУтверждения.Равно(Факт, Ожидаемое, "комментарий")
ЮТУтверждения.НеРавно(Факт, НеОжидаемое)
ЮТУтверждения.ЭтоИстина(Условие, "комментарий")
ЮТУтверждения.ЭтоЛожь(Условие)
ЮТУтверждения.Больше(Значение, Порог, "комментарий")
ЮТУтверждения.Меньше(Значение, Порог)
ЮТУтверждения.НеЗаполнено(Значение)
ЮТУтверждения.Заполнено(Значение)
ЮТУтверждения.ИмеетДлину(Коллекция, N)

⚠️ Fluent-стиль (ЮТУтверждения.Что(X).Равно(Y)) не работает в CommonModule — нет self-reference.

Добавить тест в конфигурацию

<!-- Configuration.xml → ChildObjects -->
<CommonModule>ТестПроведенияПоступления_Test</CommonModule>

CommonModule флаги: Server=true, ClientManagedApplication=false.

---

Шаг 3 — Загрузить в базу

/db-load-xml <configDir> -Mode Partial -Files "CommonModules/ТестПроведенияПоступления_Test.xml,CommonModules/ТестПроведенияПоступления_Test/Ext/Module.bsl"
/db-update

---

Шаг 4 — Запустить тесты

// Все _Test модули
{"name": "run_unit_tests", "arguments": {}}

// Конкретный модуль
{"name": "run_unit_tests", "arguments": {"moduleName": "ТестПроведенияПоступления_Test"}}

Формат результата

{
  "success": true,
  "total": 3,
  "passed": 3,
  "failed": 0,
  "summary": "[OK] ПроведениеПоступленияФормируетДвижения\n[OK] ..."
}

При failed > 0 — success: false, в summary строки [FAIL] ИмяТеста: текст ошибки.

---

Шаг 5 — Cleanup

{"name": "delete_object", "arguments": {"objectType": "Documents", "objectName": "ПоступлениеТоваровУслуг", "objectRef": "<ref>"}}
{"name": "delete_object", "arguments": {"objectType": "Catalogs", "objectName": "Контрагенты", "objectRef": "<ref>"}}

---

Полный пример (end-to-end)

1. create_catalog_item(Номенклатура, {Наименование: "TEST-001"}) → ref_ном
2. create_document(ПоступлениеТоваровУслуг, {Товары: [{Номенклатура: ref_ном, Кол: 5, Цена: 200}]}) → ref_doc
3. post_document(ПоступлениеТоваровУслуг, ref_doc) → success: true
4. Claude пишет BSL тест → /db-load-xml + /db-update
5. run_unit_tests({moduleName: "ТестПроведенияПоступления_Test"}) → {success: true, passed: 1}
6. delete_object x2 (cleanup)

---

Ограничения

• Тесты только серверная бизнес-логика: расчёты, движения, проведение — не UI
• Тест загружается в базу до запуска через /db-load-xml + /db-update
• Ссылки между объектами — GUID-строки из ответов create_*
• post_document требует РежимЗаписиДокумента.Проведение — база должна допускать проведение

Связанные скилы

• /db-load-xml — загрузить тест-модуль в базу
• /db-update — применить к БД
• 1c-ai-debug MCP — CRUD данных и запуск run_unit_tests