From 29b124f3fdd024f7d017041bb1003e3b2ec3ef85 Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Mon, 9 Mar 2026 19:17:12 +0300 Subject: [PATCH] docs(validate): concrete examples in SKILL.md, remove auto-resolve notes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Replace abstract <...> placeholders with concrete paths in ## Команда - Replace abstract examples with concrete paths in ## Использование - Remove авторезолв notes from meta/epf/cf/cfe-validate - Clean up erf-validate: remove Вывод/Верификация/Когда использовать, add -Detailed parameter, unify format with other validators Co-Authored-By: Claude Opus 4.6 --- .claude/skills/cf-validate/SKILL.md | 8 ++- .claude/skills/cfe-validate/SKILL.md | 8 ++- .claude/skills/epf-validate/SKILL.md | 8 ++- .claude/skills/erf-validate/SKILL.md | 58 +++++----------------- .claude/skills/form-validate/SKILL.md | 4 +- .claude/skills/interface-validate/SKILL.md | 4 +- .claude/skills/meta-validate/SKILL.md | 8 ++- .claude/skills/mxl-validate/SKILL.md | 2 +- .claude/skills/role-validate/SKILL.md | 2 +- .claude/skills/skd-validate/SKILL.md | 6 +-- .claude/skills/subsystem-validate/SKILL.md | 4 +- 11 files changed, 35 insertions(+), 77 deletions(-) diff --git a/.claude/skills/cf-validate/SKILL.md b/.claude/skills/cf-validate/SKILL.md index 8d67bd09..e46399dc 100644 --- a/.claude/skills/cf-validate/SKILL.md +++ b/.claude/skills/cf-validate/SKILL.md @@ -15,12 +15,10 @@ allowed-tools: ## Использование ``` -/cf-validate -/cf-validate upload/cfempty — каталог выгрузки +/cf-validate upload/cfempty +/cf-validate upload/cfempty/Configuration.xml ``` -`ConfigPath` авторезолв: если указана директория — ищет `Configuration.xml`. - ## Параметры | Параметр | Обяз. | Умолч. | Описание | @@ -33,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/cf-validate/scripts/cf-validate.ps1 -ConfigPath "<путь>" +powershell.exe -NoProfile -File .claude/skills/cf-validate/scripts/cf-validate.ps1 -ConfigPath "upload/cfempty" ``` ## Проверки diff --git a/.claude/skills/cfe-validate/SKILL.md b/.claude/skills/cfe-validate/SKILL.md index 96a5d9ff..77fd8c92 100644 --- a/.claude/skills/cfe-validate/SKILL.md +++ b/.claude/skills/cfe-validate/SKILL.md @@ -15,12 +15,10 @@ allowed-tools: ## Использование ``` -/cfe-validate -/cfe-validate src — каталог расширения +/cfe-validate src +/cfe-validate src/Configuration.xml ``` -`ExtensionPath` авторезолв: если указана директория — ищет `Configuration.xml`. - ## Параметры | Параметр | Обяз. | Умолч. | Описание | @@ -33,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/cfe-validate/scripts/cfe-validate.ps1 -ExtensionPath "<путь>" +powershell.exe -NoProfile -File .claude/skills/cfe-validate/scripts/cfe-validate.ps1 -ExtensionPath "src" ``` ## Проверки (9 шагов) diff --git a/.claude/skills/epf-validate/SKILL.md b/.claude/skills/epf-validate/SKILL.md index fa8439ff..2661386e 100644 --- a/.claude/skills/epf-validate/SKILL.md +++ b/.claude/skills/epf-validate/SKILL.md @@ -15,12 +15,10 @@ allowed-tools: ## Использование ``` -/epf-validate -/epf-validate src/МояОбработка — авторезолв в /.xml +/epf-validate src/МояОбработка +/epf-validate src/МояОбработка/МояОбработка.xml ``` -`ObjectPath` авторезолв: если указана директория — ищет `/.xml`. - ## Параметры | Параметр | Обяз. | Умолч. | Описание | @@ -33,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "<путь_к_обработке>" +powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "src/МояОбработка" ``` ## Проверки diff --git a/.claude/skills/erf-validate/SKILL.md b/.claude/skills/erf-validate/SKILL.md index d18ddb70..17bbc6dd 100644 --- a/.claude/skills/erf-validate/SKILL.md +++ b/.claude/skills/erf-validate/SKILL.md @@ -1,7 +1,7 @@ --- name: erf-validate description: Валидация внешнего отчёта 1С (ERF). Используй после создания или модификации отчёта для проверки корректности -argument-hint: [-MaxErrors 30] +argument-hint: [-Detailed] [-MaxErrors 30] allowed-tools: - Bash - Read @@ -17,26 +17,26 @@ allowed-tools: ## Использование ``` -/erf-validate +/erf-validate src/МойОтчёт +/erf-validate src/МойОтчёт/МойОтчёт.xml ``` ## Параметры -| Параметр | Обязательный | По умолчанию | Описание | -|------------|:------------:|--------------|-------------------------------------------------| -| ObjectPath | да | — | Путь к корневому XML или каталогу отчёта | -| MaxErrors | нет | 30 | Остановиться после N ошибок | -| OutFile | нет | — | Записать результат в файл (UTF-8 BOM) | - -`ObjectPath` авторезолв: если указана директория — ищет `/.xml`. +| Параметр | Обяз. | Умолч. | Описание | +|------------|:-----:|---------|-------------------------------------------------| +| ObjectPath | да | — | Путь к корневому XML или каталогу отчёта | +| Detailed | нет | — | Показывать [OK] для каждой проверки | +| MaxErrors | нет | 30 | Остановиться после N ошибок | +| OutFile | нет | — | Записать результат в файл (UTF-8 BOM) | ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "<путь>" +powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate.ps1 -ObjectPath "src/МойОтчёт" ``` -## Выполняемые проверки +## Проверки | # | Проверка | Серьёзность | |----|-------------------------------------------------------|--------------| @@ -51,38 +51,4 @@ powershell.exe -NoProfile -File .claude/skills/epf-validate/scripts/epf-validate | 9 | Файлы: формы (.xml + Ext/Form.xml), макеты | ERROR | | 10 | Дескрипторы форм: корневая структура, uuid, Name, FormType | ERROR / WARN | -## Вывод - -``` -=== Validation: ERF.МойОтчёт === - -[OK] 1. Root structure: MetaDataObject/ExternalReport, version 2.17 -[OK] 2. InternalInfo: ClassId correct, 1 GeneratedType -[OK] 3. Properties: Name="МойОтчёт", Synonym present, MainDCS set -[OK] 4. ChildObjects: Form(1), Template(1) -[OK] 5. Cross-references: DefaultForm, MainDCS valid -[OK] 6. Attributes: none -[OK] 7. TabularSections: none -[OK] 8. Name uniqueness: 2 names, all unique -[OK] 9. File existence: 4 files verified -[OK] 10. Form descriptors: 1 checked - -=== Result: 0 errors, 0 warnings === -``` - -Код возврата: 0 = все проверки пройдены, 1 = есть ошибки. - -## Верификация - -``` -/erf-init --with-skd — создать отчёт с СКД -/erf-validate src/.xml — проверить результат -/erf-build — собрать ERF -``` - -## Когда использовать - -- **После `/erf-init`**: проверить scaffold -- **После добавления формы/макета/СКД**: убедиться что ChildObjects и MainDCS корректны -- **После ручного редактирования XML**: выявить структурные ошибки до сборки -- **При отладке сборки**: найти причину ошибки Designer +Exit code: 0 = OK, 1 = есть ошибки. По умолчанию краткий вывод. `-Detailed` для поштучной детализации. diff --git a/.claude/skills/form-validate/SKILL.md b/.claude/skills/form-validate/SKILL.md index c344b573..fbcb8e06 100644 --- a/.claude/skills/form-validate/SKILL.md +++ b/.claude/skills/form-validate/SKILL.md @@ -15,7 +15,7 @@ allowed-tools: ## Использование ``` -/form-validate +/form-validate Catalogs/Номенклатура/Forms/ФормаЭлемента /form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml ``` @@ -30,7 +30,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/form-validate/scripts/form-validate.ps1 -FormPath "<.../Forms/ИмяФормы>" +powershell.exe -NoProfile -File .claude/skills/form-validate/scripts/form-validate.ps1 -FormPath "Catalogs/Номенклатура/Forms/ФормаЭлемента" ``` ## Проверки diff --git a/.claude/skills/interface-validate/SKILL.md b/.claude/skills/interface-validate/SKILL.md index b3bf8de3..bb767059 100644 --- a/.claude/skills/interface-validate/SKILL.md +++ b/.claude/skills/interface-validate/SKILL.md @@ -15,7 +15,7 @@ allowed-tools: ## Использование ``` -/interface-validate +/interface-validate Subsystems/Продажи /interface-validate Subsystems/Продажи/Ext/CommandInterface.xml ``` @@ -31,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "" +powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи" ``` ## Проверки (13) diff --git a/.claude/skills/meta-validate/SKILL.md b/.claude/skills/meta-validate/SKILL.md index abcd59d5..49b2f6d4 100644 --- a/.claude/skills/meta-validate/SKILL.md +++ b/.claude/skills/meta-validate/SKILL.md @@ -15,12 +15,10 @@ allowed-tools: ## Использование ``` -/meta-validate -/meta-validate path1.xml|path2.xml — batch mode +/meta-validate Catalogs/Номенклатура/Номенклатура.xml +/meta-validate Catalogs/Банки|Documents/Заказ — batch mode ``` -`ObjectPath` авторезолв: если указана директория — ищет `/.xml`. - ## Параметры | Параметр | Обяз. | Умолч. | Описание | @@ -33,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/meta-validate/scripts/meta-validate.ps1 -ObjectPath "" +powershell.exe -NoProfile -File .claude/skills/meta-validate/scripts/meta-validate.ps1 -ObjectPath "Catalogs/Номенклатура/Номенклатура.xml" ``` ## Поддерживаемые типы (23) diff --git a/.claude/skills/mxl-validate/SKILL.md b/.claude/skills/mxl-validate/SKILL.md index 4bdcb60c..342a2347 100644 --- a/.claude/skills/mxl-validate/SKILL.md +++ b/.claude/skills/mxl-validate/SKILL.md @@ -30,7 +30,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/mxl-validate/scripts/mxl-validate.ps1 -TemplatePath "<.../Templates/ИмяМакета>" +powershell.exe -NoProfile -File .claude/skills/mxl-validate/scripts/mxl-validate.ps1 -TemplatePath "Catalogs/Номенклатура/Templates/Макет" ``` ## Проверки diff --git a/.claude/skills/role-validate/SKILL.md b/.claude/skills/role-validate/SKILL.md index 6583bc96..9c1ecd58 100644 --- a/.claude/skills/role-validate/SKILL.md +++ b/.claude/skills/role-validate/SKILL.md @@ -31,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/role-validate/scripts/role-validate.ps1 -RightsPath "" +powershell.exe -NoProfile -File .claude/skills/role-validate/scripts/role-validate.ps1 -RightsPath "Roles/МояРоль" ``` ## Проверки diff --git a/.claude/skills/skd-validate/SKILL.md b/.claude/skills/skd-validate/SKILL.md index f5ccc43d..440290f3 100644 --- a/.claude/skills/skd-validate/SKILL.md +++ b/.claude/skills/skd-validate/SKILL.md @@ -15,8 +15,8 @@ allowed-tools: ## Использование ``` -/skd-validate -/skd-validate path/to/Ext/Template.xml +/skd-validate src/МойОтчёт/Templates/ОсновнаяСхема +/skd-validate Catalogs/Номенклатура/Templates/СКД/Ext/Template.xml ``` ## Параметры @@ -31,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File .claude/skills/skd-validate/scripts/skd-validate.ps1 -TemplatePath "<.../Templates/ИмяМакета>" +powershell.exe -NoProfile -File .claude/skills/skd-validate/scripts/skd-validate.ps1 -TemplatePath "src/МойОтчёт/Templates/ОсновнаяСхема" ``` ## Проверки (~30) diff --git a/.claude/skills/subsystem-validate/SKILL.md b/.claude/skills/subsystem-validate/SKILL.md index 685ab238..fec286a6 100644 --- a/.claude/skills/subsystem-validate/SKILL.md +++ b/.claude/skills/subsystem-validate/SKILL.md @@ -15,7 +15,7 @@ allowed-tools: ## Использование ``` -/subsystem-validate +/subsystem-validate Subsystems/Продажи /subsystem-validate Subsystems/Продажи.xml ``` @@ -31,7 +31,7 @@ allowed-tools: ## Команда ```powershell -powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "" +powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи" ``` ## Проверки (13)