github スキル運用ガイド(実務強化版)
github スキルは、リポジトリの Issue 管理、プルリクエスト(PR)の作成、CI/CD 失敗分析など、開発運用の定型作業を AI エージェントが代行・支援するための強力なスキルです。
1. 対象読者
- GitHub を使ったチーム開発の効率を上げたいテックリード
- コードレビューやリリース作業のリードタイムを短縮したい開発チーム
- 障害発生時の一次切り分けを自動化したい運用担当者
2. 事前準備(Prerequisites)
- GitHub PAT (Personal Access Token):
repoおよびworkflow権限を持つトークン。 - OpenClaw 環境: すでに
openclawが動作しており、設定ファイルにアクセス可能であること。 - 対象リポジトリの整理: 自動化を適用するリポジトリの優先順位を決めておく。
3. 実装・導入手順
Step 1: 認証設定
openclaw config set を使用して、GitHub トークンを安全に設定します(環境変数の利用を推奨)。
Step 2: スキルの有効化
openclaw install github を実行し、対象となるリポジトリを指定します。
Step 3: ワークフローへの組み込み
「PR が作成されたら自動で要約を作成する」「テストが失敗したらエラー箇所を特定して報告する」などの指示(Prompt)を定義します。
4. 失敗例と対処法
- 権限エラー (401/403): トークンの有効期限切れ、または権限不足。トークンを再生成し、最小権限(Least Privilege)原則に則って付与し直してください。
- レート制限 (Rate Limit): 短時間に大量の API 呼び出しを行うと GitHub 側で制限されます。実行頻度の調整や、キャッシュスキルの併用を検討してください。
5. 再発防止と安全運用
- 秘密情報の秘匿: トークンをコードやログに直接書き込まない。
- レビューの必須化: AI が作成した PR やコメントをそのままマージせず、必ず人間が最終確認を行うプロセス(Human-in-the-loop)を維持する。
6. KPI(効果測定指標)
- PR作成までの時間: 手動と比較してどれだけ短縮されたか。
- 初期レビューの正確性: AI の要約や分析がそのまま採用された割合。
- デプロイ頻度: 自動化導入後のリリース回数の推移。
7. FAQ
- Q: プライベートリポジトリでも使えますか?
- A: はい、適切な PAT を設定すれば可能です。
- Q: 日本語でコメントを返せますか?
- A: はい、システムプロンプトで日本語を指示すれば、日本語での要約や回答が可能です。
8. 参考リンク
- GitHub CLI (gh) Documentation: https://cli.github.com/
- OpenClaw Official: https://github.com/openclaw/openclaw