From 4bc86decf8aff737f30536b6b9034b69e884c5b4 Mon Sep 17 00:00:00 2001 From: Nick Shirokov Date: Sun, 8 Feb 2026 12:37:42 +0300 Subject: [PATCH] Improve usage examples with real-world scenarios MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .claude/skills/epf-add-template/SKILL.md | 14 +++++---- README.md | 39 ++++++++++++++---------- 2 files changed, 31 insertions(+), 22 deletions(-) diff --git a/.claude/skills/epf-add-template/SKILL.md b/.claude/skills/epf-add-template/SKILL.md index ead27af5..f3d88e57 100644 --- a/.claude/skills/epf-add-template/SKILL.md +++ b/.claude/skills/epf-add-template/SKILL.md @@ -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` | Пустой файл | ## Что создаётся diff --git a/README.md b/README.md index 6ceb44b7..b06e2649 100644 --- a/README.md +++ b/README.md @@ -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` создаётся структура: