diff --git a/.claude/skills/help-add/SKILL.md b/.claude/skills/help-add/SKILL.md index 296d8ae0..136c3ddc 100644 --- a/.claude/skills/help-add/SKILL.md +++ b/.claude/skills/help-add/SKILL.md @@ -1,6 +1,6 @@ --- name: help-add -description: Добавить встроенную справку к объекту 1С (обработка, отчёт, справочник, документ и др.) +description: Добавить встроенную справку к объекту 1С (обработка, отчёт, справочник, документ и др.). Используй когда пользователь просит добавить справку, help, встроенную помощь к объекту argument-hint: allowed-tools: - Bash @@ -23,7 +23,7 @@ allowed-tools: | Параметр | Обязательный | По умолчанию | Описание | |------------|:------------:|--------------|-------------------------------------| -| ObjectName | да | — | Имя объекта | +| ObjectName | да | — | Путь объекта относительно SrcDir (например `Catalogs/МойСправочник`, `DataProcessors/МояОбработка`) | | Lang | нет | `ru` | Код языка справки | | SrcDir | нет | `src` | Каталог исходников | @@ -33,60 +33,12 @@ allowed-tools: powershell.exe -NoProfile -File .claude/skills/help-add/scripts/add-help.ps1 -ObjectName "" [-Lang ""] [-SrcDir ""] ``` -## Что создаётся +## Что делает скрипт -``` -// - Ext/ - Help.xml # Метаданные справки (namespace extrnprops) - Help/ - ru.html # HTML-страница справки -``` +- Создаёт `Ext/Help.xml` и `Ext/Help/ru.html` — шаблон справки +- Если у объекта есть формы — добавляет `` в метаданные форм (если отсутствует) +- Справка **не регистрируется** в `ChildObjects` — достаточно наличия файлов -- `Help.xml` — фиксированная структура с `ru` (namespace `http://v8.1c.ru/8.3/xcf/extrnprops`) -- `ru.html` — HTML 4.0 Transitional с подключением стилей 1С (`v8help://service_book/service_style`) -- Справка **не регистрируется** в `ChildObjects` корневого XML — достаточно наличия файлов +## После запуска -## Что модифицируется - -- Если в метаданных формы (`Forms/.xml`) отсутствует `` — скрипт добавит `false` после ``. Для форм, созданных через `/form-add`, элемент уже есть. - -## Кнопка справки на форме - -После создания справки для её вызова нужна кнопка на форме. Добавь кнопку `Form.StandardCommand.Help` в AutoCommandBar формы (`Forms//Ext/Form.xml`). - -### Текущая структура AutoCommandBar (созданная form-add) - -```xml - - true - -``` - -### Нужно заменить на - -```xml - - true - - - - -``` - -### Выбор id - -Просмотри все `id="..."` в `Form.xml` и выбери следующий свободный числовой id. Обычно id начинаются с 1 и идут подряд. Для кнопки нужны 2 id: один для Button, один для ExtendedTooltip. - -### Важно - -- `Form.StandardCommand.Help` — стандартная команда платформы, не нужно объявлять в `` -- Обработчика в Module.bsl не требуется — платформа сама найдёт `Help.xml` и откроет HTML - -## Редактирование справки - -После создания содержимое справки — обычный HTML. Отредактируй `Ext/Help/ru.html` в соответствии с назначением объекта. Поддерживается стандартная HTML-разметка: `

`..`

`, `

`, `