К основному содержанию
скилл CX Codex

056-design-avoid-breaking-changes — скилл для Claude Code

Скилл 056-design-avoid-breaking-changes проверяет планы, спецификации OpenSpec и код на риск несовместимости перед релизом.

Apache-2.0 172 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 056-design-avoid-breaking-changes -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/056-design-avoid-breaking-changes/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/056-design-avoid-breaking-changes/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
review-compatibility Rudolf S. Субагент review-compatibility для Claude Code, который проверяет код на breaking changes в API, базах данных и конфигах. CX Codex ★ 587звёзд репо dotnet-breaking-changes dotnet Скилл dotnet-breaking-changes для Claude Code и Codex выявляет нарушения обратной совместимости в коде .NET или C#. Используется перед редактированием библиотек и проектов с внешними потребителями API. CX Codex +1 614установок Asynthetic asynthetic-ai MCP-сервер Asynthetic поставляет ИИ-агентам проверенные карты миграций библиотек: списки ломающих изменений, примеры кода до и после обновления, а также ссылки на первоисточники. CX Codex +1 422установок api-design Aaronontheweb Скилл api-design для Claude Code и ещё пяти платформ, который задаёт правила проектирования публичных API: только расширять, ничего не ломать. CX Codex +1 702установок avoid-ai-design ungspirit Скилл avoid-ai-design для Claude Code находит в вёрстке следы нейросети и переписывает её вокруг одной дизайн-идеи. Убирает шаблоны, из-за которых фронтенд выглядит как у всех. CX Codex +1 998установок pr-review-expert borghei Скилл pr-review-expert для Claude Code и Codex анализирует последствия правок в пулл-реквестах перед слиянием. Проверяет затронутые зависимости, бреши безопасности и поломки контрактов API. CX Codex +1 118установок

Из того же набора123

Весь набор →
806-regulations-eu-data-act Скилл 806-regulations-eu-data-act разбирает Java-сервисы, API и пайплайны на инженерные контроли EU Data Act: доступ к данным, экспорт, переносимость, переход между облаками. Полезен до релиза функции обмена данными. CX Codex +1 212установок 500-frameworks-micronaut-create-project Скилл 500-frameworks-micronaut-create-project создаёт Maven-проект на Micronaut 4.x через SDKMAN и Micronaut CLI. Он пригодится, когда нужно подготовить новый сервис и проверить сборку. CX Codex +1 211установок 054-design-tdd Скилл 054-design-tdd ведёт разработчика через цикл «красный-зелёный-рефакторинг» при тестировании Java-кода. Пишешь падающий тест, минимум кода для прохода, потом переделываешь — всё время держа тесты зелёными. CX Codex +1 177установок 707-technologies-hexagonal-architecture Скилл 707-technologies-hexagonal-architecture помогает проверить и улучшить границы Hexagonal architecture в Java-проектах без привязки к Spring Boot, Quarkus или Micronaut. CX Codex +1 174установок 055-design-parallel-change Скилл 055-design-parallel-change помогает спланировать безопасную миграцию схемы базы данных, когда старая и новая версии приложения должны работать одновременно. Разбивает сложные изменения на три отдельные фазы развёртывания. CX Codex +1 172установок 052-design-hamburger-method Скилл 052-design-hamburger-method разбивает крупные фичи и задачи на вертикальные срезы по методу гамбургера. Помогает выделить минимальную работающую версию вместо горизонтальных техзадач. CX Codex +1 172установок 053-design-simple-rules Скилл 053-design-simple-rules разбирает дизайн и рефакторинг Java-кода по четырём правилам Кента Бека: тесты, ясность замысла, отсутствие дублирования, минимум элементов. CX Codex +1 172установок 057-design-feature-toggles Скилл 057-design-feature-toggles для Claude Code помогает проектировать и проверять feature toggles в Java-сервисах — от kill switch до rollout и удаления старых флагов. CX Codex +1 171установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой