aip について
API や protobuf の設計・レビューに Google API Improvement Proposals を適用するスキルです。最新の AIP 索引を確認し、関連する公開ガイドラインを取得してから適用するよう案内します。
主な機能
- 01AIP 索引の確認
- 02該当する AIP ガイドラインの特定
- 03関連する公開ルールの取得
- 04API と protobuf 作業への標準適用
活用シーン
- 01API エンドポイントや 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 対応