关于 google-aip
google-aip 是用于设计或评审 Protocol Buffers API 的 skill,帮助开发者查找并应用本地收录的 Google AIP 文档,并在结果中区分要求、建议和有意偏离。
主要功能
- 01按主题搜索 AIP 目录
- 02读取匹配的完整 AIP 文档
- 03考虑 AIP 状态及规范性内容
- 04冲突时查阅 AIP-0200
- 05在结论中引用 AIP 编号
适用场景
- 01设计新的 Protocol Buffers API
- 02评审现有 API 定义
- 03说明 API 变更的要求与建议
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ juanmarin-co/ skills --skill google-aip安装后在 Claude Code 中输入/google-aip确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/aips/0001.md0002.md0003.md0008.md0009.md0100.md0111.md0121.md0122.md0123.md0124.md0126.md0127.md0128.md0129.md0130.md0131.md0132.md0133.md0134.md0135.md0136.md0140.md0141.md0142.md0143.md0144.md0145.md0146.md详细介绍
在设计或审查 protobuf API 时,应用随附的 Google AIP。
工作流
- 检查请求和相关 API 定义。
- 在
references/catalog.md中搜索相关概念。尽可能使用rg或其他文本搜索,而不是加载整个目录。 - 只阅读
references/aips/{NUMBER}.md中匹配的文档,使用四位数编号,例如0132.md。 - 应用完整的 AIP 内容,而非目录预览。考虑每个 AIP 的状态,并区分规范性指导与示例。
- 当既有 API 先例与较新的指导相冲突时,在建议偏离之前阅读 AIP-0200。
- 在结果中引用 AIP 编号,并分别列出必需的更改、建议和有意偏离。
资源
references/catalog.md:可搜索的索引,包含状态、标题和简介。references/aips/:完整的本地 AIP 文档。references/provenance.json:上游修订版本、转换和许可证详情。
评论
支持 Markdown