github について
`gh` で GitHub を操作するスキルです。リポジトリ、Issue、PR、Actions、リリース、設定などのタスクを個別のリファレンスに振り分け、状態を変更する操作には確認ルールを設けます。
主な機能
- 01GitHub のタスクを詳細リファレンスに振り分け
- 02リポジトリ、Issue、PR の管理
- 03Actions、CI、リリースの操作
- 04リポジトリ、Issue、PR、コードの検索
- 05状態変更前の確認を必須化
活用シーン
- 01Issue の整理と PR のレビュー
- 02CI チェックとワークフロー実行の監視
- 03リリース準備とリポジトリ設定の管理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bntvllnt/ agent-skills --skill githubインストール後、Claude Code で/githubを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdreferences/actions.mdapi.mdauth.mdci-monitor.mdcli-help.mdconfig.mdextensions.mdgists.mdissue.mdpr-dashboard.mdpr.mdprojects.mdrelease-assets.mdrelease-create.mdrelease-manage.mdrelease-strategy.mdrelease.mdrepo.mdsearch.mdsecrets-vars.md詳細
GitHub
gh を使用した GitHub の操作です。
ルーター
| ユーザーの発言 | 読み込むリファレンス | 実行内容 |
|---|---|---|
| help / gh help / flags / options | references/cli-help.md | CLI のヘルプを安全に表示する |
| auth / login / token | references/auth.md | gh を認証する |
| repo / clone / fork / sync | references/repo.md | リポジトリを操作する |
| issue / issues | references/issue.md | issue のトリアージと管理 |
| pr / pull request / review | references/pr.md | PR の作成/レビュー/マージのワークフロー |
| actions / workflow / run | references/actions.md | GitHub Actions(ワークフローと実行) |
| ci / monitor ci / check ci / ci status / watch ci | references/ci-monitor.md | ライブポーリングで CI チェックを監視する(ユーザーが単独で「ci」と言った場合は、チェックの監視かワークフローの表示かを確認する) |
| pr dashboard / pr overview / open prs / my prs / pr status | references/pr-dashboard.md | ステータス分類付きの PR 概要 |
| release / publish release | references/release.md | リリース、アセット、検証 |
| release strategy / release format / versioning | references/release-strategy.md | バージョン管理、タイトル/説明の形式、生成プロトコル |
| secrets / variables | references/secrets-vars.md | シークレットと変数を管理する |
| project | references/projects.md | プロジェクトを操作する |
| gist | references/gists.md | gist を操作する |
| search | references/search.md | リポジトリ/issue/PR/コードを検索する |
| api | references/api.md | gh api(上級者向け) |
| extension | references/extensions.md | gh 拡張機能を管理する |
| config | references/config.md | gh の設定の基本 |
安全規則
- 状態を変更する操作(作成/編集/削除/マージ/クローズ)の前に確認します。
- シークレットをアセットとしてアップロードしないでください。
gh apiは強力な機能として扱い、書き込み操作の前に確認します。- 明示的に依頼されない限り、公開済みのリリース/タグを削除または移動しないでください。
- PR を作成するときは、必ず担当者を設定します。ユーザーが別の担当者を明示的に指定しない限り、デフォルトは
@meです。 - PR を作成するときは、可能であれば関連する既存のラベルを適用します。PR のコンテキスト(タイトル/本文/ブランチと変更されたパス)から自動的に選び、新しいラベルの作成は本当に必要な場合を除いて避けます。
- ラベルの作成が必要な場合は、まず既存のラベルを取得し(
gh label list)、リポジトリの命名規則に沿った最小限の候補を提示してから、gh label createの実行前に確認します。
確認ポリシー
読み取り専用コマンドは常に実行できます。
次の場合は確認が必要です。
gh issue create/edit/close/reopen/deletegh pr create/edit/close/merge/reviewgh repo create/edit/rename/archive/delete/syncgh release create/edit/delete、gh release upload、gh release delete-assetgh secret set/delete、gh variable set/deletegh run rerun、gh run cancel- 状態を変更する
gh api呼び出し(POST/PATCH/PUT/DELETE)
読み取り専用(確認不要)
gh auth status
gh release list
gh release view <tag>
gh release view <tag> --web
gh help
gh pr checks <number> --json ...
gh run list --branch <branch> --json ...
gh run view <run-id>
gh run view <run-id> --log-failed
コメント
Markdown 対応