Improve usage examples with real-world scenarios

README: replace abstract examples with realistic scenarios — processor
with form for data manipulation, BSP print form with spreadsheet
template, incremental additions. Emphasize natural language over slash
commands.

epf-add-template SKILL.md: add Russian name mapping for template types
(табличный документ, текстовый документ).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-02-08 12:37:42 +03:00
parent 34e88d2914
commit 4bc86decf8
2 changed files with 31 additions and 22 deletions
+8 -6
View File
@@ -37,12 +37,14 @@ pwsh -NoProfile -File .claude/skills/epf-add-template/scripts/add-template.ps1 -
## Маппинг типов
| Type | TemplateType | Расширение | Содержимое |
|---------------------|----------------------|------------|-----------------------|
| HTML | HTMLDocument | `.html` | Пустой HTML-документ |
| Text | TextDocument | `.txt` | Пустой файл |
| SpreadsheetDocument | SpreadsheetDocument | `.xml` | Минимальный spreadsheet |
| BinaryData | BinaryData | `.bin` | Пустой файл |
Пользователь может указать тип в свободной форме. Определи нужный по контексту:
| Пользователь пишет | TemplateType | Расширение | Содержимое |
|---------------------------------------------|---------------------|------------|-------------------------|
| HTML | HTMLDocument | `.html` | Пустой HTML-документ |
| Text, текстовый документ, текст | TextDocument | `.txt` | Пустой файл |
| SpreadsheetDocument, табличный документ, MXL | SpreadsheetDocument | `.xml` | Минимальный spreadsheet |
| BinaryData, двоичные данные | BinaryData | `.bin` | Пустой файл |
## Что создаётся
+23 -16
View File
@@ -21,26 +21,42 @@
## Как пользоваться
Не обязательно запоминать команды и параметры. Просто опишите задачу своими словами — Claude сам подберёт нужные навыки:
Не обязательно запоминать команды и параметры. Просто опишите задачу своими словами — Claude сам подберёт нужные навыки.
### Сценарий 1: обработка с формой
Типичная обработка для манипуляций с данными — форма для пользователя, модуль объекта для логики.
```
> Создай обработку ЗагрузкаПрайса с формой и HTML-макетом
> Создай обработку ЗагрузкаПрайса с формой и HTML-макетом для шаблона загрузки
```
Claude выполнит `/epf-init`, `/epf-add-form`, `/epf-add-template` с правильными параметрами.
```
> Сделай из неё дополнительную обработку БСП для заполнения справочника Номенклатура
```
### Сценарий 2: внешняя печатная форма БСП
Claude вызовет `/epf-bsp-init` с видом ЗаполнениеОбъекта и назначением Справочник.Номенклатура.
Обработка с макетом табличного документа, подключаемая через механизм дополнительных обработок БСП к конкретному документу.
```
> Добавь справку с описанием
> Создай внешнюю печатную форму для документа Реализация. Макет — табличный документ.
```
Claude создаст обработку, добавит макет SpreadsheetDocument, вызовет `/epf-bsp-init` с видом ПечатнаяФорма и назначением, сгенерирует `СведенияОВнешнейОбработке()` и процедуру `Печать()`.
### Сценарий 3: доработка существующей обработки
```
> Добавь справку с описанием как пользоваться обработкой
```
Claude вызовет `/epf-add-help` и предложит отредактировать HTML.
```
> Добавь ещё одну команду печати — накладная
```
Claude вызовет `/epf-bsp-add-command`, добавит команду в `СведенияОВнешнейОбработке()` и блок обработки в процедуру `Печать()`.
```
> Собери
```
@@ -59,15 +75,6 @@ Claude вызовет `/epf-build`.
> /epf-build МояОбработка
```
### Дополнительная печатная форма БСП
```
> /epf-init МояПечатнаяФорма "Моя печатная форма"
> /epf-bsp-init МояПечатнаяФорма печатная форма для Документ.СчетНаОплату
> /epf-add-template МояПечатнаяФорма СчетНаОплату SpreadsheetDocument
> /epf-build МояПечатнаяФорма
```
Первая добавленная форма автоматически становится основной (DefaultForm). Флаг `--main` нужен только для переназначения основной формы на другую.
После `/epf-init` создаётся структура: