056-design-avoid-breaking-changes

仓库创建 2025年2月9日最近提交 3 天前SkillHot 收录 16 小时前

▸ 精选理由

用于发布前兼容性检查，降低破坏性回归概率。

这个 Skill 做什么

评审提案以识别跨命令、API、文档与数据的破坏性变更风险。

用来审查变更提案，找出会不会破坏现有命令、API、文档、测试、CI、数据迁移等兼容性的风险。在发布、合并或改规范前用它把全局影响梳一遍，既能发现命名/接口问题，也会提示数据和部署层面的迁移隐患。特别之处在于跨多层级、交互式地检查兼容性，而不是只看单个文件。

▸ 展开 SKILL.md 英文原文

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

开发编程向后兼容变更评审API通用

423

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/jabrena/plinth/main/skills/056-design-avoid-breaking-changes/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/jabrena/plinth/main/skills/056-design-avoid-breaking-changes/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# 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, sc

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有