关于 aip
用于在 API 和 protobuf 设计或审查中应用 Google API Improvement Proposals 的 Skill。它要求先查看实时 AIP 索引,再获取相关已发布指南并据此执行。
主要功能
- 01查看 AIP 索引
- 02识别适用的 AIP 指南
- 03获取相关已发布规则
- 04将标准用于 API 和 protobuf 工作
适用场景
- 01设计 API 端点或 protobuf 消息
- 02审查拉取请求中的 API 变更
- 03命名字段、方法或资源
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fredrikaverpil/ dotfiles --skill aip安装后在 Claude Code 中输入/aip确认已加载。
详细介绍
Google API 改进提案(AIP)
处理 API 设计、protobuf 定义或任何涉及 Google API 标准的任务时,请重新熟悉相关的 AIP 规则。
AIP 是不断更新的文档,因此应以已发布的页面为准,把自己的记忆当作待核实的线索——即使你确信某条规则也要核实。
流程
- 浏览 AIP 索引 - 访问 https://google.aip.dev/general,查看所有可用的 AIP 指南
- 确定相关 AIP - 根据当前任务,判断可能适用的 AIP 规则
- 获取并阅读相关 AIP - 使用 WebFetch 获取具体的 AIP 页面
- 应用标准 - 确保你的工作遵循文档所述的 AIP 指南
何时调用此技能
- 设计新的 API 端点或 protobuf 消息
- 审查 PR 中的 API 变更
- 实现面向资源的服务
- 为字段、方法或资源命名
- 使用
google.api注解
评论
支持 Markdown