creator/cc-1c-skills
1
0
Fork 0
mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-06-10 16:14:54 +03:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
- 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
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/cf-validate/SKILL.md
+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.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"
```
## Проверки
.claude/skills/cfe-validate/SKILL.md
+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.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 шагов)
.claude/skills/epf-validate/SKILL.md
+3 -5
View File
@@ -15,12 +15,10 @@ allowed-tools:
## Использование
```
/epf-validate <ObjectPath>
/epf-validate src/МояОбработка — авторезолв в <dir>/<dir>.xml
/epf-validate src/МояОбработка
/epf-validate src/МояОбработка/МояОбработка.xml
```
`ObjectPath` авторезолв: если указана директория — ищет `<dirName>/<dirName>.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/МояОбработка"
```
## Проверки
.claude/skills/erf-validate/SKILL.md
+12 -46
View File
@@ -1,7 +1,7 @@
---
name: erf-validate
description: Валидация внешнего отчёта 1С (ERF). Используй после создания или модификации отчёта для проверки корректности
argument-hint: <ObjectPath> [-MaxErrors 30]
argument-hint: <ObjectPath> [-Detailed] [-MaxErrors 30]
allowed-tools:
- Bash
- Read
@@ -17,26 +17,26 @@ allowed-tools:
## Использование
```
/erf-validate <ObjectPath>
/erf-validate src/МойОтчёт
/erf-validate src/МойОтчёт/МойОтчёт.xml
```
## Параметры
| Параметр | Обязательный | По умолчанию | Описание |
|------------|:------------:|--------------|-------------------------------------------------|
| ObjectPath | да | — | Путь к корневому XML или каталогу отчёта |
| MaxErrors | нет | 30 | Остановиться после N ошибок |
| OutFile | нет | — | Записать результат в файл (UTF-8 BOM) |
`ObjectPath` авторезолв: если указана директория — ищет `<dirName>/<dirName>.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 <Name> --with-skd — создать отчёт с СКД
/erf-validate src/<Name>.xml — проверить результат
/erf-build <Name> — собрать ERF
```
## Когда использовать
- **После `/erf-init`**: проверить scaffold
- **После добавления формы/макета/СКД**: убедиться что ChildObjects и MainDCS корректны
- **После ручного редактирования XML**: выявить структурные ошибки до сборки
- **При отладке сборки**: найти причину ошибки Designer
Exit code: 0 = OK, 1 = есть ошибки. По умолчанию краткий вывод. `-Detailed` для поштучной детализации.
.claude/skills/form-validate/SKILL.md
+2 -2
View File
@@ -15,7 +15,7 @@ allowed-tools:
## Использование
```
/form-validate <FormPath>
/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/ФормаЭлемента"
```
## Проверки
.claude/skills/interface-validate/SKILL.md
+2 -2
View File
@@ -15,7 +15,7 @@ allowed-tools:
## Использование
```
/interface-validate <CIPath>
/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 "<Subsystems/ИмяПодсистемы>"
powershell.exe -NoProfile -File ".claude/skills/interface-validate/scripts/interface-validate.ps1" -CIPath "Subsystems/Продажи"
```
## Проверки (13)
.claude/skills/meta-validate/SKILL.md
+3 -5
View File
@@ -15,12 +15,10 @@ allowed-tools:
## Использование
```
/meta-validate <ObjectPath>
/meta-validate path1.xml|path2.xml — batch mode
/meta-validate Catalogs/Номенклатура/Номенклатура.xml
/meta-validate Catalogs/Банки|Documents/Заказ — batch mode
```
`ObjectPath` авторезолв: если указана директория — ищет `<dirName>/<dirName>.xml`.
## Параметры
| Параметр | Обяз. | Умолч. | Описание |
@@ -33,7 +31,7 @@ allowed-tools:
## Команда
```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)
.claude/skills/mxl-validate/SKILL.md
+1 -1
View File
@@ -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/Макет"
```
## Проверки
.claude/skills/role-validate/SKILL.md
+1 -1
View File
@@ -31,7 +31,7 @@ allowed-tools:
## Команда
```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/МояРоль"
```
## Проверки
.claude/skills/skd-validate/SKILL.md
+3 -3
View File
@@ -15,8 +15,8 @@ allowed-tools:
## Использование
```
/skd-validate <TemplatePath>
/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)
.claude/skills/subsystem-validate/SKILL.md
+2 -2
View File
@@ -15,7 +15,7 @@ allowed-tools:
## Использование
```
/subsystem-validate <SubsystemPath>
/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 "<Subsystems/ИмяПодсистемы>"
powershell.exe -NoProfile -File ".claude/skills/subsystem-validate/scripts/subsystem-validate.ps1" -SubsystemPath "Subsystems/Продажи"
```
## Проверки (13)