agentleFS
anymasoftanymasoft/1c-ai/.claude/skills/1c-test-runner/SKILL.md

1c-test-runner

Skill0 starsChanged 4 months agoMITView on GitHub

Этот скилл MUST быть вызван когда пользователь говорит "напиши тест", "протестируй модуль", "запусти unit-тесты" для 1С. SHOULD также вызывать после реализации бизнес-логики для верификации через 1c-ai-debug MCP. Do NOT использовать для UI-тестов — используй playwright-test или 1c-web-session.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.