Protobuf 与 gRPC 兼容性审查

原名：protobuf-grpc-api-review

检查 proto 变更对传输格式、JSON 映射和新旧客户端的影响。

中文 Skills 技能说明

适合修改消息字段、枚举或 RPC 服务前做兼容性复核。重点检查字段编号、保留规则、默认值、可选语义及发布顺序，输出破坏性变化和迁移建议。需要实际的新旧 proto 文件和调用范围；没有客户端证据时说明不确定性，不凭编译通过认定兼容。默认只读，生产 schema 发布仍须独立审批和跨版本测试。

上游能力依据

上游原始适用说明：Review Protocol Buffer (.proto) and gRPC API changes for wire and JSON compatibility, safe schema evolution, rollout hazards, and RPC contract quality. Use when reviewing proto diffs, adding or changing messages and services, planning migrations, or diagnosing cross-version failures.

上游 SKILL.md 主要章节（保留原文标题）：

Start With the Compatibility Envelope
Review Workflow
1. Inventory Contract Changes
2. Evaluate Four Compatibility Dimensions
3. Trace Mixed-Version Scenarios
4. Review Repository Evidence
5. Produce an Actionable Review
Default Safety Principles
Avoid False Positives

使用边界

先复现问题并固定测试范围，再生成或执行测试。测试通过只能证明已覆盖的场景，不能代替生产环境验收。

作者、翻译与许可证

原作者: GitHub, Inc. 与 awesome-copilot contributors
中文翻译: CEOFans翻译
许可证: MIT
上游来源: https://github.com/github/awesome-copilot/tree/a19b3101cc797a35de8b1c1698c13d1344703522/skills/protobuf-grpc-api-review

适用范围

平台：linux、macos、windows；标签：测试与质量、Protobuf 与 gRPC 兼容性审查、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。