破坏性变更审查
系统检查外部集成接口中的破坏性变更，降低升级和兼容性风险。
技能仅要求检查外部集成面的破坏性变更，没有声明执行写入、网络访问或凭据处理，因此未见红线风险；但未规定最小权限、用户确认、数据流披露、敏感数据处理、回滚或结果归因，扣11分。
范围列举了 app-server API、CLI 参数、配置加载和会话恢复，指令内部一致；但没有检查步骤、输入输出格式、依赖、异常处理或失败反馈，静态证据不足，扣15分。
目标场景和四类检查面较明确；但未说明触发条件、非适用范围、预期输入输出或中文环境支持，且没有证据证明对不同仓库结构的适配性，扣8分。
名称和描述基本指向破坏性变更审查，仓库提供 Apache-2.0 许可证和官方来源信息；但技能文件缺少安装依赖、示例、FAQ、限制、版本、变更记录、维护责任和更新路径，扣11分。
要求不要在发现一个问题后停止，能够提升审查完整性；但没有定义报告格式、判定标准或可直接使用的输出，且无静态可验证结果，因此仅评为部分完成核心任务，扣10分。
技能文件只提供行为要求，没有测试、示例输出、提交记录说明或第三方执行证据；结论可追溯性和复现性很弱，扣8分。
- 技能没有规定输出结构或严重性判定标准，使用者仍需自行设计审查方法和报告。
- “external integration surfaces”范围可能过宽，未明确是否应检查代码、文档、迁移兼容性或仅检查接口定义。
- 静态审查未执行技能，也未验证其能发现真实破坏性变更；不要将仓库测试证据泛化为该技能自身的测试证据。
- 技能未说明敏感配置、会话数据或外部服务信息的处理边界。
它能做什么 & 适用场景
这是一个面向软件工程审查的 Agent Skill，专门查找外部集成表面上的破坏性变更。覆盖 app-server API、CLI 参数、配置加载，以及从已有 rollout 恢复会话。它要求审查者不要在发现一个问题后停止，而应系统分析所有可能的破坏路径。SKILL.md 只包含审查指令，没有提供安装、触发方式或自动化脚本。
检查变更或集成设计是否可能破坏 app-server API、CLI 参数、配置加载流程，或从已有 rollout 恢复会话的能力；持续分析其他潜在破坏性变更，而不是只报告首个问题。具体输入、输出格式和执行工具未在 SKILL.md 中规定。
- 负责维护 app-server API 的工程师，在发布接口变更前检查客户端兼容性。
- 维护 CLI 的团队，在修改参数或命令行为前评估现有调用是否会失效。
- 负责配置系统的工程师，在调整配置加载逻辑后查找旧配置的兼容性问题。
- 需要支持从已有 rollout 恢复会话的团队，在升级流程中检查恢复路径是否被破坏。
- 进行代码或架构审查的工程师，希望系统覆盖多个外部集成表面，而不是只确认一个已知问题。
优缺点一览
- 明确覆盖四类容易被忽略的外部集成表面。
- 要求继续寻找其他问题，有助于避免只修复首个发现。
- 采用仅含 name 和 description 的简洁 SKILL.md 格式，没有显示的平台专属扩展。
- 没有提供测试套件、脚本或自动化检查命令。
- 没有定义审查输入、输出结构、严重性分级或修复建议格式。
- 没有说明具体安装、触发和权限流程。
- 源材料未证明其对其他 Agent 平台或 API 形态的直接支持。
如何安装
该 Skill 位于仓库的 .codex/skills/code-review-breaking-changes/SKILL.md。README 提供的是整个 Codex CLI 技能集合的安装方式：macOS 或 Linux 可运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh；Windows 可运行 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"；也可使用 npm install -g @openai/codex 或 brew install --cask codex。源材料没有说明如何单独安装或放置此 Skill。
如何使用
在支持该技能的 Agent 中，将待审查的变更、接口或升级方案提交给它，并明确要求检查 app-server API、CLI 参数、配置加载和已有 rollout 会话恢复路径。例如：Review this change for breaking changes across app-server APIs, CLI parameters, configuration loading, and resuming sessions from existing rollouts. Analyze every possible breakage path. SKILL.md 未规定具体触发命令、输入格式或报告格式。