mcpField
G
google-aip

google-aip

github.com/juanmarin-co开发036 次安装2 周前更新
代码仓库

关于 google-aip

google-aip 是用于设计或评审 Protocol Buffers API 的 skill,帮助开发者查找并应用本地收录的 Google AIP 文档,并在结果中区分要求、建议和有意偏离。

主要功能

  1. 01按主题搜索 AIP 目录
  2. 02读取匹配的完整 AIP 文档
  3. 03考虑 AIP 状态及规范性内容
  4. 04冲突时查阅 AIP-0200
  5. 05在结论中引用 AIP 编号

适用场景

  1. 01设计新的 Protocol Buffers API
  2. 02评审现有 API 定义
  3. 03说明 API 变更的要求与建议

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/juanmarin-co/skills --skill google-aip

安装后在 Claude Code 中输入/google-aip确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/aips/
0001.md
0002.md
0003.md
0008.md
0009.md
0100.md
0111.md
0121.md
0122.md
0123.md
0124.md
0126.md
0127.md
0128.md
0129.md
0130.md
0131.md
0132.md
0133.md
0134.md
0135.md
0136.md
0140.md
0141.md
0142.md
0143.md
0144.md
0145.md
0146.md

详细介绍

在设计或审查 protobuf API 时,应用随附的 Google AIP。

工作流

  1. 检查请求和相关 API 定义。
  2. 在 references/catalog.md 中搜索相关概念。尽可能使用 rg 或其他文本搜索,而不是加载整个目录。
  3. 只阅读 references/aips/{NUMBER}.md 中匹配的文档,使用四位数编号,例如 0132.md。
  4. 应用完整的 AIP 内容,而非目录预览。考虑每个 AIP 的状态,并区分规范性指导与示例。
  5. 当既有 API 先例与较新的指导相冲突时,在建议偏离之前阅读 AIP-0200。
  6. 在结果中引用 AIP 编号,并分别列出必需的更改、建议和有意偏离。

资源

  • references/catalog.md:可搜索的索引,包含状态、标题和简介。
  • references/aips/:完整的本地 AIP 文档。
  • references/provenance.json:上游修订版本、转换和许可证详情。

评论

支持 Markdown