steelmorgan/skill-learning-policy

Политика накопления знаний (Skill Learning)

TRIGGER — ЗАПИСАТЬ урок (MUST, жёстко)

Завершён цикл работы с ≥2 итерациями (написал → ошибка → нашёл корректный путь → успех) → ретроспектива ОБЯЗАТЕЛЬНА. Применить навык skill-learning (framework/skills/agent-process/skill-learning/SKILL.md) и провести её.

Задача решена с первой попытки → ретроспектива НЕ нужна, триггер не срабатывает.

Приёмка триггера: в full-cycle пропуск ретроспективы фиксирует оркестратор при приёмке фазы. В quick-fix/FREE приёмки оркестратором нет → агент сам подтверждает выполнение строкой в {role}-context.md / отчёте: SKILL_LEARNING: matched|refined|new|skipped(<причина>).

TRIGGER — ПРОЧИТАТЬ уроки (перед работой с навыком)

Перед началом работы с любым навыком — прочитать накопленные уроки навыка-владельца, ДО проектирования/реализации:

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

Применять confirmed как дополнительные правила, candidate — как подсказки. Файла нет → пропустить. Триггер фазовый: на входе в работу с навыком, не на каждом ходу.

MUST (инвариант, всегда)

• Уровень абстракции выше инцидента. Урок описывает именованный КЛАСС ошибки + анти-рецепт (обобщённый запрет/проверка), а НЕ конкретный инцидент. Конкретные file:line / имена символов этого инцидента идут как «пример-источник», НЕ как тело правила.
• Тест абстракции (приёмка записи). Анти-рецепт применим минимум к ≥1 ИНОЙ гипотетической ситуации, кроме породившей. Не применим → это инстанс: переформулировать выше или отклонить.
• Сверка-актуализация перед записью. Сверить инцидент с существующими рецептами (references/learned-patterns.md навыка-владельца + {project}/.context/learned-patterns.md). Подпадает под существующий класс → актуализировать его (candidate→confirmed, расширить границы анти-рецепта, дописать источник), дубль НЕ заводить. Не подпадает → новый класс. Исход фиксируется явно: matched | refined | new.
• Записи пишутся ТОЛЬКО в references/learned-patterns.md навыка-владельца (универсальные) или {project}/.context/learned-patterns.md (проектные) — НЕ в тело SKILL.md.
• Целевой каталог универсального урока — RU-источник фреймворка (каталог навыка-владельца в framework/, НЕ установленный ENG-симлинк framework_eng/: иначе урок теряется при синхронизации). Поиск каталога и синхронизацию в ENG — по навыку skill-editing-from-project. Проектный урок ({project}/.context/learned-patterns.md) — на русском, без маппинга и синхронизации.
• Приём и антиприём — одна запись; первый случай = candidate, повторение = confirmed.

Процедура ретроспективы (восстановление цепочки итераций, абстрагирование до класса, тест абстракции, сверка-каскад, выбор уровня и навыка-владельца, поиск RU-каталога) — в навыке skill-learning.

depends_on:

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