docs(validate): concrete examples in SKILL.md, remove auto-resolve notes

- 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 <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-03-09 19:17:12 +03:00
parent ffdee04a95
commit 29b124f3fd
11 changed files with 35 additions and 77 deletions
+3 -5
View File
@@ -15,12 +15,10 @@ allowed-tools:
## Использование ## Использование
``` ```
/cf-validate <ConfigPath> /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
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"
``` ```
## Проверки ## Проверки
+3 -5
View File
@@ -15,12 +15,10 @@ allowed-tools:
## Использование ## Использование
``` ```
/cfe-validate <ExtensionPath> /cfe-validate src
/cfe-validate src — каталог расширения /cfe-validate src/Configuration.xml
``` ```
`ExtensionPath` авторезолв: если указана директория — ищет `Configuration.xml`.
## Параметры ## Параметры
| Параметр | Обяз. | Умолч. | Описание | | Параметр | Обяз. | Умолч. | Описание |
@@ -33,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```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 шагов) ## Проверки (9 шагов)
+3 -5
View File
@@ -15,12 +15,10 @@ allowed-tools:
## Использование ## Использование
``` ```
/epf-validate <ObjectPath> /epf-validate src/МояОбработка
/epf-validate src/МояОбработка — авторезолв в <dir>/<dir>.xml /epf-validate src/МояОбработка/МояОбработка.xml
``` ```
`ObjectPath` авторезолв: если указана директория — ищет `<dirName>/<dirName>.xml`.
## Параметры ## Параметры
| Параметр | Обяз. | Умолч. | Описание | | Параметр | Обяз. | Умолч. | Описание |
@@ -33,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```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/МояОбработка"
``` ```
## Проверки ## Проверки
+12 -46
View File
@@ -1,7 +1,7 @@
--- ---
name: erf-validate name: erf-validate
description: Валидация внешнего отчёта 1С (ERF). Используй после создания или модификации отчёта для проверки корректности description: Валидация внешнего отчёта 1С (ERF). Используй после создания или модификации отчёта для проверки корректности
argument-hint: <ObjectPath> [-MaxErrors 30] argument-hint: <ObjectPath> [-Detailed] [-MaxErrors 30]
allowed-tools: allowed-tools:
- Bash - Bash
- Read - Read
@@ -17,26 +17,26 @@ allowed-tools:
## Использование ## Использование
``` ```
/erf-validate <ObjectPath> /erf-validate src/МойОтчёт
/erf-validate src/МойОтчёт/МойОтчёт.xml
``` ```
## Параметры ## Параметры
| Параметр | Обязательный | По умолчанию | Описание | | Параметр | Обяз. | Умолч. | Описание |
|------------|:------------:|--------------|-------------------------------------------------| |------------|:-----:|---------|-------------------------------------------------|
| ObjectPath | да | — | Путь к корневому XML или каталогу отчёта | | ObjectPath | да | — | Путь к корневому XML или каталогу отчёта |
| MaxErrors | нет | 30 | Остановиться после N ошибок | | Detailed | нет | — | Показывать [OK] для каждой проверки |
| OutFile | нет | — | Записать результат в файл (UTF-8 BOM) | | MaxErrors | нет | 30 | Остановиться после N ошибок |
| OutFile | нет | — | Записать результат в файл (UTF-8 BOM) |
`ObjectPath` авторезолв: если указана директория — ищет `<dirName>/<dirName>.xml`.
## Команда ## Команда
```powershell ```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 | | 9 | Файлы: формы (.xml + Ext/Form.xml), макеты | ERROR |
| 10 | Дескрипторы форм: корневая структура, uuid, Name, FormType | ERROR / WARN | | 10 | Дескрипторы форм: корневая структура, uuid, Name, FormType | ERROR / WARN |
## Вывод Exit code: 0 = OK, 1 = есть ошибки. По умолчанию краткий вывод. `-Detailed` для поштучной детализации.
```
=== 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 <Name> --with-skd — создать отчёт с СКД
/erf-validate src/<Name>.xml — проверить результат
/erf-build <Name> — собрать ERF
```
## Когда использовать
- **После `/erf-init`**: проверить scaffold
- **После добавления формы/макета/СКД**: убедиться что ChildObjects и MainDCS корректны
- **После ручного редактирования XML**: выявить структурные ошибки до сборки
- **При отладке сборки**: найти причину ошибки Designer
+2 -2
View File
@@ -15,7 +15,7 @@ allowed-tools:
## Использование ## Использование
``` ```
/form-validate <FormPath> /form-validate Catalogs/Номенклатура/Forms/ФормаЭлемента
/form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml /form-validate src/МояОбработка/Forms/Форма/Ext/Form.xml
``` ```
@@ -30,7 +30,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```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/ФормаЭлемента"
``` ```
## Проверки ## Проверки
+2 -2
View File
@@ -15,7 +15,7 @@ allowed-tools:
## Использование ## Использование
``` ```
/interface-validate <CIPath> /interface-validate Subsystems/Продажи
/interface-validate Subsystems/Продажи/Ext/CommandInterface.xml /interface-validate Subsystems/Продажи/Ext/CommandInterface.xml
``` ```
@@ -31,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```powershell
powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "<Subsystems/ИмяПодсистемы>" powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи"
``` ```
## Проверки (13) ## Проверки (13)
+3 -5
View File
@@ -15,12 +15,10 @@ allowed-tools:
## Использование ## Использование
``` ```
/meta-validate <ObjectPath> /meta-validate Catalogs/Номенклатура/Номенклатура.xml
/meta-validate path1.xml|path2.xml — batch mode /meta-validate Catalogs/Банки|Documents/Заказ — batch mode
``` ```
`ObjectPath` авторезолв: если указана директория — ищет `<dirName>/<dirName>.xml`.
## Параметры ## Параметры
| Параметр | Обяз. | Умолч. | Описание | | Параметр | Обяз. | Умолч. | Описание |
@@ -33,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```powershell
powershell.exe -NoProfile -File .claude/skills/meta-validate/scripts/meta-validate.ps1 -ObjectPath "<Catalogs/ИмяСправочника/ИмяСправочника.xml>" powershell.exe -NoProfile -File .claude/skills/meta-validate/scripts/meta-validate.ps1 -ObjectPath "Catalogs/Номенклатура/Номенклатура.xml"
``` ```
## Поддерживаемые типы (23) ## Поддерживаемые типы (23)
+1 -1
View File
@@ -30,7 +30,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```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/Макет"
``` ```
## Проверки ## Проверки
+1 -1
View File
@@ -31,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```powershell
powershell.exe -NoProfile -File .claude/skills/role-validate/scripts/role-validate.ps1 -RightsPath "<Roles/ИмяРоли>" powershell.exe -NoProfile -File .claude/skills/role-validate/scripts/role-validate.ps1 -RightsPath "Roles/МояРоль"
``` ```
## Проверки ## Проверки
+3 -3
View File
@@ -15,8 +15,8 @@ allowed-tools:
## Использование ## Использование
``` ```
/skd-validate <TemplatePath> /skd-validate src/МойОтчёт/Templates/ОсновнаяСхема
/skd-validate path/to/Ext/Template.xml /skd-validate Catalogs/Номенклатура/Templates/СКД/Ext/Template.xml
``` ```
## Параметры ## Параметры
@@ -31,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```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) ## Проверки (~30)
+2 -2
View File
@@ -15,7 +15,7 @@ allowed-tools:
## Использование ## Использование
``` ```
/subsystem-validate <SubsystemPath> /subsystem-validate Subsystems/Продажи
/subsystem-validate Subsystems/Продажи.xml /subsystem-validate Subsystems/Продажи.xml
``` ```
@@ -31,7 +31,7 @@ allowed-tools:
## Команда ## Команда
```powershell ```powershell
powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "<Subsystems/ИмяПодсистемы>" powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи"
``` ```
## Проверки (13) ## Проверки (13)