agentleFS
TserenTserenovTserenTserenov/FMT-exocortex-template/.claude/skills/iwe-update/SKILL.md

iwe-update

Skill64 starsChanged 14 days agoMITView on GitHub

Update IWE with change explanations. Agent calls update.sh, parses CHANGELOG, explains what changed, helps adapt updates to user customizations.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • iwesys/IWEtheir own version, first seen Nov 1, 2026

The file

Files
SKILL.md

IWE Update (агент-обновитель)

Роль: R6 Кодировщик. Один выход: обновлённый IWE + объяснение что изменилось. Триггер: «обнови IWE», «обновись», /iwe-update, или агент предлагает после обнаружения новой версии.

Алгоритм

0. Extensions before

bash .claude/scripts/load-extensions.sh iwe-update before

Код 0 → прочитать каждый путь из вывода в алфавитном порядке и выполнить инструкции до превью. Код 1 → расширений нет, продолжить. Любой другой код или ошибка обязательного шага расширения → обновление не начинать, показать настоящую причину ошибки.

1. Превью (--check)

Запустить update.sh в режиме превью:

(cd "$IWE_TEMPLATE" && bash update.sh --check 2>&1); echo "exit=$?"

Вердикт готовности (WP-529 Ф244) — читать первым. Вывод содержит отдельную строку ВЕРДИКТ: …; после неё идут причины, оговорки и граница проверки. Обновление разрешено только при сочетании: код выхода 0, отдельная строка ровно ВЕРДИКТ: можно ставить и отсутствие оговорки Оговорка: … запуск с --yes будет остановлен … (шаг 4 запускает update.sh --yes, а при откате или непроверенной истории релиза такой запуск останавливается). Строки Оговорка: … и Граница проверки: … показать пользователю как есть. Не пересказывать и не дополнять проверки своими командами — вердикт уже собран из тех же проверок, что выполняет настоящий запуск.

  • Положительный вердикт с оговоркой про --yes (откат установки или непроверенная история релиза) → считать отказом для этого скилла: показать оговорку, шаг 4 не выполнять, даже если пользователь одобрил обновление. Не заменять команду шага 4 на запуск без --yes и не переключать канал самостоятельно. Назвать пользователю варианты из вывода (ручной запуск update.sh или IWE_UPDATE_CHANNEL=main) как действия, которые он выполняет сам в терминале; агент их не запускает и по ответу «запускай» в этом скилле тоже.
  • ВЕРДИКТ: нельзя ставить (код 1 — откат или непроверенная история при --yes, код 3 — установка не готова, код 5 — реестр РП) → показать строки причин, обновление не начинать, помочь устранить причину и повторить шаг 1.
  • ВЕРДИКТ: нельзя подтвердить (код 2 — не всё скачалось, код 4 — нет Python) → обновление не начинать, объяснить причину, предложить повторить, когда она устранена.
  • Строки ВЕРДИКТ: нет или код не из перечисленных → проверка не завершилась; показать последние строки вывода, обновление не начинать.
  • --check --fast вердикта не даёт (только сверка версии) — для решения не использовать.

При разрешающем вердикте из вывода извлечь:

  • Версию upstream (текущая vs новая)
  • Список новых файлов
  • Список обновлённых файлов
  • Количество строк изменений

Если «Всё актуально» → сообщить пользователю и завершить.

2. CHANGELOG — что изменилось

CHANGELOG.md больше не доставляется локально (WP-401 Ф6.1) — читать по raw-URL с той метки, которую ставит обновление, а не с main: в main уже лежат правки, которых нет ни в выпуске, ни в кандидате. Метку назвал вывод шага 1 в строке Канал поставки: релиз <метка> … или Канал поставки: кандидат <метка> …:

REF="<метка из строки «Канал поставки»>"   # например v0.42.0 или v0.42.0-rc.1
curl -fsSL "https://raw.githubusercontent.com/TserenTserenov/FMT-exocortex-template/$REF/CHANGELOG.md"

main — только если пользователь сам обновляется с канала main (IWE_UPDATE_CHANNEL=main). Строки «Канал поставки» в выводе нет — не подставлять main, а сказать пользователю, что источник изменений не определён.

Найти записи между текущей и новой версией. Подпункты «Цель:», «Как проверить:», «Как откатить:» под записью предназначены Выпускающему; пользователю их не пересказывать.

Объяснить пользователю на человеческом языке:

  • Что добавлено и зачем (не список файлов, а польза)
  • Что изменилось в поведении (может ли сломать что-то)
  • Что исправлено (баги, которые могли затрагивать пользователя)

Формат объяснения:

## Обновление IWE: v{old} → v{new}

**Что нового:**
- [1-3 пункта на языке пользователя, не разработчика]

**Что изменилось:**
- [поведение, которое может заметить пользователь]

**Исправления:**
- [если есть]

3. Анализ совместимости

Перед применением — проверить пользовательские кастомизации:

3a. Extensions:

ls extensions/*.md 2>/dev/null

Если есть extension-файлы → проверить, не конфликтуют ли новые extension points с существующими файлами.

3b. params.yaml: Прочитать params.yaml. Если обновление добавляет новые параметры → сообщить пользователю:

«Появился новый параметр X (default: Y). Хотите изменить?»

3c. CLAUDE.md: Проверить, есть ли .claude.md.base:

  • Есть → 3-way merge сработает автоматически
  • Нет → предупредить: «Первое обновление после миграции. CLAUDE.md будет обновлён с сохранением USER-SPACE секции. Рекомендую проверить результат.»

4. Применение

Выполнять только если одновременно: вердикт шага 1 разрешающий (код 0, строка ВЕРДИКТ: можно ставить, нет оговорки про остановку запуска с --yes) и пользователь одобрил обновление (или скилл вызван с --yes). Одно одобрение пользователя оговорку не снимает.

(cd "$IWE_TEMPLATE" && bash update.sh --yes 2>&1)

Из вывода извлечь результат:

  • Сколько файлов обновлено
  • Были ли конфликты 3-way merge
  • Подстановка переменных прошла?
  • Platform-space обновлён?
  • Файлы памяти: строки НЕ обновлён / НЕ доставлен и итог Не обновлено файлов памяти: N (…) — update.sh оставил эти файлы как были (в них правки, их нетронутость нельзя доказать или не удалась копия); строка Заменено файлов памяти: N (…) — заменённые, прежние версии в названном каталоге.

5. Пост-обновление

5a. Конфликты 3-way merge: Если CLAUDE.md содержит маркеры <<<<<<< → помочь разрешить:

  • Показать каждый конфликт
  • Объяснить: «Платформа изменила X, а вы изменили Y. Что оставить?»
  • Применить выбор пользователя

5b. Новые параметры: Если в обновлении появились новые параметры в params.yaml шаблона → предложить добавить в пользовательский params.yaml.

5c. Новые extension points: Если в обновлении появились новые extension points в протоколах → сообщить:

«Появились новые точки расширения: [список]. Вы можете создать файлы extensions/X.md для кастомизации.»

5d. Рекомендации: На основе кастомизаций пользователя (его extensions/, params.yaml, Pack) — предложить как использовать новые возможности.

5e. Extensions checks:

bash .claude/scripts/load-extensions.sh iwe-update checks

Код 0 → прочитать и выполнить каждый файл до итогового отчёта. Код 1 → проверок нет. Любой другой код или провал проверки не откатывает уже применённые файлы, но запрещает объявлять обновление полностью успешным: показать «обновление применено, пользовательская проверка не прошла», точную причину, путь упавшего extension и список уже выполненных checks-файлов. Remediation: исправить или временно отключить именно этот extension, снова загрузить iwe-update checks и повторить все проверки; до их успеха состояние называется applied_with_failed_extension_check, а не успешным обновлением.

6. Отчёт

## Обновление завершено

**Версия:** v{old} → v{new}
**Файлов обновлено:** N
**Конфликтов:** 0 / N (разрешены)
**Новые возможности:** [краткий список]
**Файлы памяти не обновлены:** N — [список из итога «Не обновлено файлов памяти»; по каждому — причина из его строки «НЕ обновлён …»]
**Заменено файлов памяти:** N (прежние версии: [каталог из итога])

Перезапустите Claude Code для применения обновлений memory/.

Файлы памяти, оставленные как были, сами не обновятся. Покажи пользователю по каждому команду сверки (diff …) и команду «примите версию шаблона …» из его строки. Команду принятия выполняй только после того, как пользователь подтвердил, что своих правок в файле нет: она заменяет файл версией шаблона, прежняя копия остаётся рядом. При строке о сбое резервной копии или копирования — сначала устранить причину (права, место) и повторить update.sh.

7. Extensions after

bash .claude/scripts/load-extensions.sh iwe-update after

Код 0 → прочитать и выполнить файлы после отчёта. Код 1 → расширений нет. Ошибка after не отменяет уже применённое обновление, но обязательно выводится отдельным предупреждением с именем расширения и причиной.


Автоматическое предложение обновления

При Day Open (шаг 5: IWE за ночь) — если update.sh --check показывает доступные обновления → добавить в «Требует внимания»:

«Доступно обновление IWE v{new}. Запустите /iwe-update для обновления.»

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.