steelmorgan/skill-editing-from-project

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

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

---

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

| Триггер | Действие | |---------|----------| | Пользователь просит изменить навык/правило фреймворка из каталога проекта | Следуйте процедуре ниже | | Нужно исправить ошибку в навыке, но рабочий каталог — проект 1С | Открыть .install-session.json, найти RU-путь, внести правку, синхронизировать |

---

Процедура

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

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

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

| Поле | Назначение | |------|-----------| | sync_script | Абсолютный путь к скрипту синхронизации RU→EN | | framework_dir | Абсолютный путь к framework/ (RU-источник) | | component_map | Карта всех установленных компонентов |

Каждый элемент 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 — файл перезапишется при синхронизации.
• Не переводите вручную — перевод выполняет скрипт автоматически.
• Универсальность — без проектных ссылок (MUST). Навыки и правила фреймворка переиспользуются разными проектами. В их тело ЗАПРЕЩЕНО вписывать: номера задач конкретного проекта (TASK-XXX, @task-NNN, тикеты вида OC-NNNNN), имена проектных объектов/метаданных/символов (Справочник.Ххх, ИмяФормы, ИмяРеквизита), разовые прецеденты («в задаче X было так»). Формулируй на уровне класса (обобщённый принцип/запрет/проверка), а не инцидента. Конкретный прецедент/file:line/имя — это знание ПРОЕКТА: его место в .claude/rules/ проекта, {project}/.context/learned-patterns.md или памяти, НЕ в универсальном теле фреймворка. Self-check перед сохранением: грепни свою правку на TASK-|task-|OC-|прецедент — нашёл → обобщи или вынеси в проект. (Тот же принцип «уровень абстракции выше инцидента» для learned-patterns — в skill-learning-policy.)

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

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

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

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

python3 <sync_script> --all

---

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

| Ошибка | Последствие | |--------|------------| | Редактировать en_path напрямую | Правки потеряются при синхронизации | | Писать текст на английском | Нарушает языковую политику | | Забыть синхронизировать | EN-версия устарела, агенты работают с неактуальным навыком | | Вписать в универсальное тело номер задачи / имя проектного объекта / разовый прецедент | Фреймворк перестаёт быть generic; прецедент должен жить в проекте (.claude/rules/, {project}/.context/learned-patterns.md, память). Обобщай до класса |

---

depends_on: []