version: "1.0.1" name: skill-editing-from-project installable: true description: Use for редактирования навыков фреймворка, находясь в каталоге проекта 1С (не в репозитории фреймворка). Helps найти RU-источник через симлинки и .install-session.json без переключения репозитория.

Редактирование навыков фреймворка из проекта

Навыки подключены через симлинки на framework_eng/ (EN-зеркало). Правки вносятся в framework/ (RU-источник). Карта сопоставлений — в .install-session.json.

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

Процедура

1. Открыть карту компонентов

Прочитайте файл .install-session.json в корне проекта.

Ключевые поля:

Каждый элемент component_map:

{
  "skill/vanessa-authoring": {
    "type": "skill",
    "ru_path": "/path/to/fw/framework/skills/tool-usage/vanessa/vanessa-authoring/SKILL.md",
    "en_path": "/path/to/fw/framework_eng/skills/tool-usage/vanessa/vanessa-authoring/SKILL.md"
  }
}

2. Найти нужный компонент

По component_map найдите компонент по имени (ключ — type/name). Значение ru_path — это файл, который нужно редактировать.

3. Внести правки в RU-файл

Откройте файл по пути из ru_path и внесите изменения.

Обязательные правила:

• Язык правок — русский. Весь текст навыка пишется на русском.
• Не редактируйте `en_path` — файл перезапишется при синхронизации.
• Не переводите вручную — перевод выполняет скрипт автоматически.

4. Синхронизировать EN-зеркало

Сразу после правок вызовите скрипт синхронизации — не откладывайте до коммита.

# Путь к скрипту — из поля sync_script в .install-session.json
python3 <sync_script> <ru_path>

Если изменено несколько файлов:

python3 <sync_script> --all

Типичные ошибки

depends_on: []