steelmorgan/skill-creator-ext

Skill Creator — 1C BSL Framework Extension

Базовый навык: skill-creator (Anthropic). Сначала прочитай базовый навык — он содержит общие принципы создания skills. Этот файл добавляет только 1С-специфику фреймворка.

---

1. Когда создавать новый навык

| Триггер | Действие | |---------|----------| | Появился новый MCP tool, и агент не знает КОГДА его использовать | Создать tool-usage/ skill | | Обнаружен повторяющийся антипаттерн в BSL-коде | Создать bsl-practices/ skill | | Нужно обучить агента специфике конкретной конфигурации | Создать проектный skill (в каталоге IDE проекта) | | Нужна стандартная методология (SDD, TDD, ревью) | Создать spec-writing/ или новый подкаталог | | Нужно адаптировать внешний навык под фреймворк | Создать *-ext/ расширение |

НЕ создавать навык если:

• Информация уже есть в существующем навыке — дополнить его
• Это одноразовая инструкция — сделать prompt, не skill
• Это правило/политика (MUST/SHOULD) — создать rule, не skill

---

2. Категории навыков фреймворка

| Категория | Каталог | Назначение | Примеры | |-----------|---------|------------|---------| | BSL-практики | skills/bsl-practices/ | Стандарты кодирования и паттерны | coding-standards, query-patterns | | Tool-usage | skills/tool-usage/ | Когда и как использовать MCP-инструменты | syntax-checking, platform-data-core, test-execution | | Spec-writing | skills/spec-writing/ | Стандарты документации и спецификаций | spec-standard | | Расширения | skills/*-ext/ | Расширения внешних skills (Anthropic и др.) | agent-development-ext, skill-creator-ext |

Расширения (-ext) — конвенция

1. Базовый навык устанавливается через npx skills add (обновляемый)
2. Расширение — <base-name>-ext/SKILL.md в framework/skills/
3. Расширение только дополняет, не дублирует содержимое базового навыка
4. В расширении: > Сначала прочитай базовый навык: <имя>

---

3. Процесс создания навыка

1. Анализ: определить категорию, проверить на дублирование, определить зависимости
2. Проектирование: имя kebab-case.md, целевой лимит 300 строк (max 500)
3. Написание — обязательные секции:
   • YAML frontmatter
   • Заголовок + 1-3 предложения назначения
   • Когда применять — таблица триггер → действие
   • Сценарии — конкретные примеры
   • Примеры кода — правильно + неправильно с объяснением ПОЧЕМУ
4. Интеграция: файл в framework/skills/, обновить skills в агентах, python tools/install.py --list

Указатель на уроки (конвенция). Если у навыка есть (или появится) references/learned-patterns.md — в теле SKILL.md ОБЯЗАТЕЛЬНА строка-указатель, иначе агент не увидит накопленные уроки при работе с навыком: **Накопленные уроки:** см. references/learned-patterns.md (confirmed — как правила, candidate — как подсказки). Это парная сторона к правилу skill-learning-policy: правило задаёт триггер чтения, здесь — конвенция оформления ссылки в навыке-владельце.

---

4. Tool-usage навыки — замена tool-registry

Tool-usage навыки — единственное место где описаны MCP-инструменты в фреймворке.

Структура tool-usage навыка

# [Название] — как использовать MCP-инструменты для [задачи]

## Когда применять

| Триггер | Действие |
|---------|----------|
| Пользователь просит проверить синтаксис | Вызвать `bsl.checkSyntax(uri)` |
| Агент написал/изменил .bsl код | Автоматически проверить синтаксис |

## MCP-инструменты

| Инструмент | Назначение | Workarounds |
|------------|------------|-------------|
| `bsl.checkSyntax` | Проверка синтаксиса | Если URI не найден — проверить encoding |

## Сценарии
[Конкретные цепочки вызовов]

Принципы

1. Не дублируй описание MCP-инструмента — оно приходит из MCP (tools/list)
2. Фокус на КОГДА и ПОЧЕМУ, не на параметрах
3. Workarounds и подводные камни — главная ценность
4. Конкретные сценарии — цепочки вызовов для типичных задач

---

5. Форматы навыков

| Тип | Размещение | Frontmatter | Установка | |-----|-----------|-------------|-----------| | Framework skill | framework/skills/ | name, description, depends_on | CLI через симлинки | | IDE skill | .cursor/skills/ или .agents/skills/ | name, description | npx skills add | | Расширение (-ext) | framework/skills/<name>-ext/ | name: base-name-ext, description | CLI, часть фреймворка |

---

6. Паттерны контента

Триггер → Действие (tool-usage): таблица | Триггер | Действие |

Правильно / Неправильно (bsl-practices): два блока кода + объяснение ПОЧЕМУ (последствие нарушения)

Воркфлоу с чек-листом (методологии): - [ ] Шаг N: ...

Условный воркфлоу (ветвления): Определи тип → ветка A / ветка B

---

7. Проектные навыки (project-specific)

Размещение: .cursor/skills/ или .claude/skills/ в корне проекта. Формат Anthropic SKILL.md.

Включать: архитектура конфигурации, локальные conventions, бизнес-правила, критичные модули, интеграции.

НЕ включать: общие стандарты BSL (во framework-навыках), секреты, быстро устаревающую информацию.

---

8. BSL-специфика

Ограничения платформы

• BSL не поддерживает наследование — только общие модули
• Нет package manager — зависимости через конфигурацию
• Код разделён по контекстам (сервер/клиент/внешнее соединение)
• Метаданные — декларативные, код — императивный

---

9. Чек-лист нового навыка

• [ ] YAML frontmatter, имя kebab-case (латиница)
• [ ] Объясняет ПОЧЕМУ, примеры правильно/неправильно
• [ ] Таблица "Когда применять" (триггер → действие)
• [ ] Нет дублирования с существующими навыками
• [ ] Объём ≤ 300 строк (max 500)
• [ ] Если есть references/learned-patterns.md — на него стоит ссылка в теле SKILL.md (конвенция skill-learning)
• [ ] Файл в framework/skills/, агенты обновлены, install.py --list показывает навык

---

depends_on: []