google-aip について
google-aipは、Protocol Buffers APIの設計やレビューに使うスキルです。収録されたGoogle AIP文書の検索と適用を案内し、結果では必須事項、推奨事項、意図的な逸脱を区別します。
主な機能
- 01概念に基づくAIPカタログ検索
- 02該当するAIP全文の確認
- 03AIPの状態と規範的な指針の考慮
- 04先例と指針が競合する場合のAIP-0200参照
- 05結果へのAIP番号の記載
活用シーン
- 01Protocol Buffers APIの設計
- 02既存API定義のレビュー
- 03API変更の要件と推奨事項の説明
インストール
コマンドをコピーしてターミナルで実行します。
$
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のように、4 桁の番号を使用してください。- カタログの概要ではなく、AIP の全文を適用してください。各 AIP の状態を考慮し、規範的なガイダンスと例を区別してください。
- 確立された API の先例が新しいガイダンスと矛盾する場合は、逸脱を推奨する前に AIP-0200 を読んでください。
- 結果には AIP 番号を記載し、必須の変更、推奨事項、意図的な逸脱を分けてください。
リソース
references/catalog.md:状態、タイトル、概要を含む検索可能なインデックスです。references/aips/:AIP の完全なローカル文書です。references/provenance.json:上流のリビジョン、変換、ライセンスの詳細です。
コメント
Markdown 対応