steelmorgan/skill-learning

Накопление знаний (Skill Learning) — процедура

Тело вынесено из правила skill-learning-policy. Триггер «после цикла ≥2 итераций» остаётся в правиле; здесь — процедура ретроспективы, формат записи и критерий выбора уровня/файла.

Агент учится на своих итерациях: что работает (приёмы) и что ломается (антиприёмы). Знания записываются в references/learned-patterns.md навыка-владельца.

Два уровня знаний

| Уровень | Файл | Что хранит | |---------|------|------------| | Универсальный | skill/references/learned-patterns.md | Приёмы, работающие в любой конфигурации 1С | | Проектный | {project}/.context/learned-patterns.md | Приёмы, привязанные к конкретной конфигурации / проекту |

Критерий разделения: если запись упоминает конкретный объект метаданных, имя формы, реквизит или особенность конфигурации → проектный. Если описывает общий паттерн платформы/фреймворка → универсальный.

Использование накопленных знаний

Триггер чтения («перед работой с навыком — прочитать его уроки») — в правиле skill-learning-policy (always-on). Здесь — раскладка по уровням:

• references/learned-patterns.md в каталоге навыка — универсальные приёмы;
• {project}/.context/learned-patterns.md — проектные приёмы.

Применяй confirmed-записи как дополнительные правила, candidate — как подсказки.

Когда запускать

После завершения цикла работы, в котором было ≥2 итерации (написал → ошибка → исправил → успех). Если задача решена с первой попытки — ретроспектива не нужна.

Процедура

1. Восстановить цепочку итераций — что сделал → что упало → корневая причина → как исправил → что прошло.

2. Абстрагировать до класса. Назвать КЛАСС ошибки на уровень выше инцидента, не сам инцидент:

   • плохо (инстанс): «упал биг_Модуль.Метод:142 из-за пустого ИдентификаторСтроки»;
   • хорошо (класс): «обращение к полю набора записей без проверки заполненности перед записью».

   Анти-рецепт формулируется как обобщённый запрет/проверка, переносимый на ещё не встреченные частные случаи. Конкретные file:line идут в поле источник, НЕ в тело приёма/антиприёма.

3. Тест абстракции. Спросить: «к какой ещё ситуации, кроме породившей, применим этот анти-рецепт?». Нет ответа → это инстанс, не класс: переформулировать выше или отклонить запись.

4. Сформулировать запись (приём и антиприём — одна запись, две стороны одного открытия):

status: candidate | confirmed
класс: <именованный класс ошибки>
приём: <обобщённое правило — что делать, проверено успехом>
антиприём: <обобщённый запрет — что НЕ делать, проверено падением>
почему: <что происходит при нарушении>
шаги: <конкретные шаги/код, если применимо>
источник: <задача, итерация, file:line-пример>

5. Отфильтровать — НЕ урок:

   • опечатки и случайные синтаксические ошибки;
   • разовые сбои окружения без воспроизводимого класса;
   • инцидент, не прошедший тест абстракции (инстанс без класса).

6. Определить уровень и навык-владелец:

   • упоминает конкретный объект метаданных / конфигурацию → проектный → {project}/.context/learned-patterns.md (русский, без маппинга и синхронизации);
   • общий паттерн платформы / фреймворка → универсальный → references/learned-patterns.md навыка-владельца в RU-источнике фреймворка;
   • навык-владелец — тот, к которому относится класс по содержанию.

7. Найти RU-каталог универсального урока (по навыку skill-editing-from-project): .install-session.json → component_map → skill/{имя-навыка-владельца} → ru_path → его каталог → references/learned-patterns.md. Писать в framework/ (RU), НЕ в установленный ENG-симлинк framework_eng/ — он перезапишется синхронизацией.

8. Сверка-каскад (перед записью прочитать целевой файл):

   • аналогичный класс уже есть → НЕ дублировать; актуализировать существующую запись (расширить границы анти-рецепта, дописать источник), исход = refined;
   • есть candidate с тем же классом → повысить до confirmed, исход = refined;
   • класса нет → новая запись candidate, исход = new.

9. Дописать (append) в целевой файл; если файла нет — создать; существующие записи не перезаписывать. Для универсального урока после записи — синхронизировать ENG-зеркало через sync_script из .install-session.json (см. skill-editing-from-project).

MUST

| Требование | Описание | |------------|----------| | Уровень выше инцидента | Запись про КЛАСС ошибки + анти-рецепт, не про конкретный инцидент; тест абстракции обязателен | | Не менять тело навыка | Записи — только в references/learned-patterns.md, не в SKILL.md | | Сверка-актуализация | Перед записью прочитать целевой файл; дубль не заводить, существующий класс актуализировать; исход matched/refined/new | | RU-источник для универсального | Универсальный урок писать в framework/ (RU) каталог навыка-владельца через skill-editing-from-project, НЕ в framework_eng/; после записи — синхронизация в ENG | | Первый случай = candidate | Единичный случай получает status: candidate | | Повторение = confirmed | При повторении аналогичной ситуации повысить до confirmed |

depends_on:

• framework/skills/framework-meta/skill-editing-from-project/SKILL.md