056-design-avoid-breaking-changes — скилл для Claude Code
Скилл 056-design-avoid-breaking-changes проверяет планы, спецификации OpenSpec и код на риск несовместимости перед релизом.
Apache-2.0 172 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a claude-codeЧто делает 056-design-avoid-breaking-changes
Скилл входит в набор Plinth Toolkit и запускает интерактивный аудит изменений в репозитории. Он работает строго в режиме чтения: анализирует контракты команд, метаданные и триггеры скиллов, схемы данных, ключи конфигурации, параметры сборки CI и правила генерации артефактов из XML. Сам скилл исходные файлы или сгенерированный код не правит, пока вы прямо об этом не попросите.
В основе процесса лежит файл references/056-design-avoid-breaking-changes.md, который агент читает в первую очередь. Все найденные нестыковки разбиваются по четырём категориям: BREAKING, POTENTIALLY BREAKING, NON-BREAKING и UNKNOWN. Без файла справки в репозитории аудит не начнётся.
В итоговом отчёте модель ранжирует риски по серьезности, указывает затронутые контракты и предлагает шаги для миграции: окна устаревания, пометки в чейнджлоге или дополнительные тесты.
Какие задачи решает
- найти риски поломки обратной совместимости в спецификации OpenSpec
- проверить контракты CLI-команд и скиллов перед релизом
- оценить влияние изменений в схемах API и конфигурации на пользователей
- разметить план миграции и депрекации для ломающих правок
Примеры запросов агенту
- Проверь риски несовместимости в этом OpenSpec
- Оцени совместимость контрактов команд и скиллов перед релизом
- Проверь изменения схемы данных на ломающие правки
Как установить 056-design-avoid-breaking-changes
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a claude-code2Вручную: положить файлы
~/.claude/skills/056-design-avoid-breaking-changes/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/056-design-avoid-breaking-changes/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a codex2Вручную: положить файлы
.agents/skills/056-design-avoid-breaking-changes/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a cursor2Вручную: положить файлы
.cursor/skills/056-design-avoid-breaking-changes/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/056-design-avoid-breaking-changes2Вручную: положить файлы
.github/skills/056-design-avoid-breaking-changes/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/056-design-avoid-breaking-changesВручную: положить файлы
.devin/skills/056-design-avoid-breaking-changes/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 056-design-avoid-breaking-changes
Как установить 056-design-avoid-breaking-changes в Claude Code?
Выполните команду npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a claude-code в терминале.
Что делает этот скилл?
Он проводит аудит спецификаций и кода, выявляя несовместимости в командах, скиллах, схемах данных и сгенерированных файлах без изменения самих исходников.
Меняет ли скилл файлы проекта во время проверки?
Нет, скилл работает в режиме только для чтения и формирует отчёт с оценкой рисков, не трогая код без явного указания.
Исходный текст
SKILL.md · Apache-2.0
--- name: 056-design-avoid-breaking-changes description: Use when you need to review a plan, OpenSpec change, specification, or implementation proposal for breaking-change risk across commands, skills, generated outputs, XML sources, README/docs, tests, CI, APIs, schemas, configuration, data, migration, and release guidance. This should trigger for requests such as Review breaking changes in this spec; Check compatibility risks; Avoid breaking changes in this OpenSpec change; Review migration impact before release; Assess command and skill compatibility. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Avoid Breaking Changes Review planned repository changes for breaking-change and compatibility risk before implementation or release promotion. **This is an interactive SKILL**. **What is covered in this Skill?** - Command contract compatibility: names, inputs, owning agents, outputs, safeguards, installer registration, and command inventories - Skill routing compatibility: identifiers, metadata, descriptions, triggers, references, generated local output, and acceptance coverage - Generated-output ownership: XML/source files versus `.agents/skills`, public `skills/`, `.cursor/commands`, `.cursor/rules`, and `docs/` - Source and generator contracts: XML, XInclude, XSLT, Maven modules, schema expectations, and module validation - README, localized README, changelog, migration, and deprecation guidance - External and runtime contracts: APIs, schemas, data formats, configuration keys, persistence, CLI behavior, and CI expectations - Structured compatibility reports with severity-ranked findings and validation guidance ## Constraints Keep the review evidence-based, read-only, and scoped to compatibility risk unless the user explicitly asks for implementation. - **MUST** read `references/056-design-avoid-breaking-changes.md` before producing compatibility guidance - **MUST** identify the source artifacts reviewed and the compatibility surfaces considered - **MUST** distinguish confirmed breaking changes, potential risks, non-breaking changes, and unknowns that need maintainer decision - **MUST** include migration, deprecation, validation, or release-note guidance for intentional breaking changes - **MUST** respect repository source ownership: edit XML and source docs, regenerate generated output through documented workflows, and avoid direct generated-output edits unless the repository explicitly owns that file - **MUST NOT** modify plans, specs, source files, generated outputs, or issue descriptions during review unless the user explicitly requests implementation ## When to use this skill - Review breaking changes in this spec - Check compatibility risks - Avoid breaking changes in this OpenSpec change - Review migration impact before release - Assess command and skill compatibility - Find generated output compatibility risks - Review API schema configuration or data contract changes ## Workflow 1. **Read the compatibility reference** Read `references/056-design-avoid-breaking-changes.md`, then identify the source artifacts to review, their authority, and whether the request is read-only review or approved implementation. 2. **Inventory compatibility surfaces** Check commands, skills, generated outputs, XML/source ownership, README/docs, tests, CI/build gates, external contracts, runtime behavior, data/configuration contracts, and release or migration guidance relevant to the proposed change. 3. **Classify findings** Classify each finding as `BREAKING`, `POTENTIALLY BREAKING`, `NON-BREAKING`, or `UNKNOWN`. Include the affected users, artifacts, contracts, and validation evidence or missing evidence. 4. **Recommend migration and validation** For each confirmed or potential risk, recommend deprecation, compatibility windows, migration notes, release-note updates, generator checks, focused tests, or owner decisions. 5. **Report the review outcome** Produce a concise compatibility report with reviewed sources, risk summary by surface, severity-ranked findings, recommended validation, and a clear no-risk statement when no breaking-change risks are found. ## Reference For detailed guidance, examples, and constraints, see [references/056-design-avoid-breaking-changes.md](references/056-design-avoid-breaking-changes.md).
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth