agentleFS
alkanfel1987alkanfel1987/pantheon-seed/.claude/skills/promote-pattern/SKILL.md

promote-pattern

Skill0 starsChanged 27 days agoMITView on GitHub

Превращает повторы в структуру: считает скриптом паттерны по трассам сессий и для каждого выше порога предлагает правку навыка, хука или правила (повторяющаяся ошибка) либо новый навык (повторяющийся алгоритм). Вызывать: «что повторяется», «пора закодировать», «сделай скилл из этого», /promote-pattern; и когда сам чинишь один класс ошибки в N-й раз. Не для: бага сейчас (fix-on-sight).

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

promote-pattern — повтор → структура

Задача навыка: при постоянно повторяющихся ошибках либо режимах работы по алгоритму — вносить правки в навыки / создавать новые. Парная петля — /fix-on-sight (пишет теги, которые этот скилл читает). Соглашение: <корень миниядра>/memory/pattern-promotion.md.

Главный принцип: чинить один класс ошибки в третий раз — это сигнал, что чинить надо не ошибку, а систему, которая её порождает. Ручное суждение «кажется, это уже было» ненадёжно — повтор должен быть посчитан по данным (трейсы), а не вспомнен.

Когда срабатывает

  • Ревизия (еженедельно / по запросу): «что повторяется», «разбери накопленные ошибки».
  • Пользователь: «пора закодировать», «сделай скилл из этого», «промотируй паттерны».
  • Проактивно: сам ловишь, что чинишь класс <ключ> в N-й раз или гоняешь один алгоритм руками.
  • Ввод /promote-pattern.

НЕ срабатывает:

  • Одиночный баг прямо сейчас → /fix-on-sight.
  • Спуск до корня многослойного бага → deep-debug-loop (если установлен).
  • «Работает или декорация» → /enforcement-audit (если установлен).

Цикл

[1] ПОСЧИТАТЬ — запустить счётчик, получить кандидатов (>= порога):
       python <корень миниядра>/scripts/pattern_counter.py --min <порог>
       (по умолчанию порог 3; для дорогих/outward-facing классов можно --min 2, см. ниже)
   ▼
[2] ОТФИЛЬТРОВАТЬ — для каждого кандидата проверить, не промотирован ли уже
       (секция «Журнал промоций» в `memory/pattern-promotion.md`). Промотированные пропустить.
   ▼
[3] КЛАССИФИЦИРОВАТЬ по виду тега → выбрать тип промоции (таблица ниже).
   ▼
[3.5] ВЫБРАТЬ СРЕДСТВО ПО ЛЕСТНИЦЕ — какой файл править, сказала таблица;
       насколько сильное средство брать, говорит лестница (см. ниже).
       Счётчик показывает колонку «момент»: класс с пометкой «НЕ НАЗВАН»
       не промотируется вовсе — сперва найти для него наблюдаемое событие.
   ▼
[3.7] НАЗВАТЬ ВИД ИЗМЕНЕНИЯ: 1а исправление · 1б оптимизация · 2 расширение ·
       3а трансформация-носитель · 3б трансформация-область · 4 вычитание ·
       5 связывание · 6 пересборка границ · 7 перестановка во времени. Вид определяет
       ОБЯЗАТЕЛЬНУЮ ПРОВЕРКУ: 1а — прецедент до/после; 1б — парный замер;
       2 — новое работает + регрессия + бюджет описания; 3а — те же задачи + неприкосновенное ядро;
       3б — местные правила первичны; 4 — снять по одному, прогнать, начать с локального снятия;
       5 — вызовы до/после по журналу; 6 — выбирается нужный навык; 7 — исход до/после переноса.
       Нет проверки по виду — правка не делается.
   ▼
[4] РАЗВИЛКА — если выбор типа промоции mutually-exclusive с последствиями → delegate simulate-fork.
       Иначе — выполнить промоцию автономно (non-exclusive items — подряд).
   ▼
[5] ПРОМОТИРОВАТЬ — внести правку (см. типы) и выполнить проверку вида из [3.7]. work-mode → новый скилл delegate skill-creator (если установлен; иначе см. запасной путь в таблице типов).
   ▼
[6] ДЕДУП — дописать в «Журнал промоций»: дата · ключ · повторов · решение, **начиная с метки вида**
       («**вид 5** связывание: …») · проверка и её исход · ссылка. По меткам потом считаются правки по видам.
       Иначе тот же класс всплывёт кандидатом снова.

Типы промоции (по виду + слою тега)

Вид + слойПромоция
failure-mode слой skillправка соответствующего SKILL.md (+ антипаттерн в скилл)
failure-mode слой hookправка хука (если у вас есть хуки Claude Code) + перепроверка срабатывания (enforcement-audit, если установлен)
failure-mode слой codeфикс в репозитории + тест против класса
failure-mode слой memorymemory-verify + апдейт памяти
failure-mode слой envобёртка-скрипт / запись в доку окружения (папка ваших скриптов или справочный документ)
failure-mode дорогой, повторныйправило в memory/rules.md (не в CLAUDE.md: тот файл обновляется релизами, своё правило в нём заблокирует обновление): always-on (если каждый turn) или, если у вас есть хук-напоминание по триггерам, pull-on-trigger через него
work-modeновый скилл через skill-creator (если установлен) или расширение существующего скилла. Без skill-creator: создать папку .claude/skills/<имя>/SKILL.md по образцу соседних навыков (frontmatter name + description, затем шаги)

Лестница средств — брать нижнюю применимую

Таблица выше отвечает «какой файл править». Лестница — «насколько сильное средство». Идти сверху вниз, останавливаться на первой применимой ступени:

№СредствоЧто требует от агентаКогда применимо
1Убрать развилку — неверный путь не нуженничегоошибиться становится нечем
2Перехват в момент — хук по признаку из [момент] (если у вас настроены хуки Claude Code; иначе — ступени 1, 3, 4)ничегомомент назван и детектируем
3Дорожка дешевле обходной — скрипт, обёртка, командавыбрать её, когда видноверный путь есть, но дороже неверного
4Текст в память / memory/rules.mdпомнить весь разговормомент недетектируем в принципе

Отбор: нет названного момента — четвёртая ступень тоже не берётся. Класс возвращается в наблюдение, пока момент не найдётся. Правило, которое нельзя привязать к событию, не исполняется, а вес у соседних правил отнимает: внимание конечно, и свод из сорока строк работает хуже свода из десяти.

Основание. На практике бывало: класс без механической проверки давал 6 повторов за сессию, классы с проверкой не доживали до последствий ни разу. Правило «не писать код через heredoc» жило в памяти и нарушалось в пятый раз, тогда как правила с перехватом на Write|Edit в те же дни соблюдались; при этом правило «завести трассу в начале» лежало прямо в контексте и тоже не сработало — потому что «сразу» не событие. Отсюда: строить проверку, а не усиливать формулировку.

Порог: логика, не квота

  • Дефолт 3. 0 кандидатов = валидный результат — ничего не выдумывать, не добирать до квоты.
  • Для классов, которые дорого стоят (раздражают пользователя, ломают outward-facing, теряют время) — порог опустить до 2. Прецедент: правило языка ответа подняли в always-on после 2 повторов с интервалом. Решение о снижении порога — здесь, явно, не автоматизм.
  • Режим обзора: вывод счётчика — это обзор, не приказ. Каждый кандидат подтверждается отдельным решением о промоции, не «всё подряд закодировать».

Делегирование (НЕ дублировать)

ШагКому
[4] выбор типа промоции = взаимоисключающий с последствиямиsimulate-fork
[5] work-mode → создание/правка скиллаskill-creator (anthropic-skills), если установлен
[5] failure-mode слой hook → перепроверка срабатыванияenforcement-audit, если установлен
правка памятидисциплина memory-verify (перед опорой на запись памяти — сверить с живым состоянием; записи памяти — снимок на момент записи)

Этот скилл — диспетчер промоции (посчитать → классифицировать → промотировать → дедуп), а не реализация каждого типа правки.

Связь с контуром

/fix-on-sight пишет failure-mode:/work-mode: теги → scripts/pattern_counter.py считает → /promote-pattern (этот скилл) промотирует. Полное соглашение и журнал: memory/pattern-promotion.md.

Формат тегов — как в memory/pattern-promotion.md; счётчик принимает failure-mode: ключ и failure-mode `ключ` .

Антипаттерны

  • ❌ Промотировать «по памяти» без прогона счётчика (повтор должен быть посчитан).
  • ❌ Добивать до квоты при пустом результате (порог, не квота).
  • ❌ Промотировать и не записать в журнал → класс всплывёт снова, бесконечный цикл.
  • ❌ work-mode закодировать в скилл, дублирующий существующий (сперва проверить список скиллов).
  • ❌ Молча переписать memory/rules.md или править CLAUDE.md (он принадлежит релизам) для дорогого класса без согласования (escalate с числом повторов).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.