GitHub API / gh CLI 操作 - Issue、PR、ブランチ、worktree、GitHub Actions、リポジトリ設定管理を提供

version
5.0.0
GitHub stars
7

Install

/plugin install shiiman-github@shiiman-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add shiiman/claude-code-plugins.

Contents

Discovered from source

Skills 10

Debug Actions

GitHub Actions のワークフロー実行エラーを調査し、原因を特定して解決策を提案します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:actions-debug - GitHub Actions エラー調査

概要:
  GitHub Actions のワークフロー実行エラーを調査する。
  失敗ジョブの特定、ログ取得、原因分析、修正提案を実行。

使用方法:
  /shiiman-github:actions-debug [run番号] [オプション]

オプション:
  --help  このヘルプを表示

例:
  /shiiman-github:actions-debug                    # 最新の失敗 run を調査
  /shiiman-github:actions-debug 12345678901        # 指定 run 番号を調査

ワークフロー

1. run 番号の特定

  • $ARGUMENTS に run 番号が指定されている場合: その run を調査
  • 指定がない場合: 最新の失敗 run を自動検出
# 最新の失敗 run を取得
gh run list --status failure --limit 1 --json databaseId --jq '.[0].databaseId'

# 特定の PR に関連する Run を確認
gh pr checks {pr番号}

2. ワークフロー実行情報の取得

gh run view {run_id}

3. 失敗ジョブの特定

# 失敗したジョブのみ抽出
gh run view {run_id} --json jobs --jq '.jobs[] | select(.conclusion == "failure") | {name, conclusion}'

4. エラーログの取得・分析

# 失敗したステップのログを取得
gh run view {run_id} --log-failed

ログから以下を特定:

  • エラーメッセージ
  • 失敗したステップ
  • 関連するファイル・行番号

5. 解決策の提案

エラーパターンに基づいて修正を提案:

  • 具体的な修正コード
  • 設定変更の提案
  • ローカルでの再現方法

よくあるエラーパターン

テスト失敗

gh run view {run_id} --log-failed | grep -A 10 "FAIL"

対処法:

  • 失敗したテストケースを特定
  • ローカルで再現
  • テストまたはコードを修正

ビルドエラー

gh run view {run_id} --log-failed | grep -A 5 "error"

対処法:

  • コンパイルエラーを特定
  • 型エラーや構文エラーを修正
  • 依存関係を確認

依存関係エラー

gh run view {run_id} --log-failed | grep -A 5 "npm ERR!"

対処法:

  • package-lock.json を更新
  • 依存関係のバージョンを確認
  • キャッシュをクリア

権限エラー

対処法:

  • workflow の permissions を確認
  • GITHUB_TOKEN の権限を確認
  • secrets の設定を確認

出力形式

## GitHub Actions エラー調査結果

**Run ID**: {run_id}
**ワークフロー**: {workflow_name}
**ステータス**: ❌ failure

### 失敗したジョブ

| ジョブ | ステップ | 原因 |
|--------|----------|------|
| test | Run tests | テスト失敗 |

### エラー詳細

{エラーログの抜粋}

### 修正提案

1. {具体的な修正方法}

### 参考コマンド

{ローカルでの再現コマンド}

重要な注意事項

  • ✅ run 番号未指定時は最新の失敗 run を自動検出
  • ✅ エラーログを詳細に分析
  • ✅ 具体的な修正提案を含める
  • ✅ ローカルでの再現方法を提示
  • ✅ ログが長い場合は重要なエラー部分のみ抽出して報告
  • ❌ 漠然とした提案を避ける
  • ❌ 関係ないエラーを混同しない

Create Branch

feature ブランチを作成します。Issue 番号指定・ブランチ名直接指定・コンテキストからの自動命名に対応。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:branch-create - Create Branch

概要:
  feature ブランチを作成する。
  Issue 番号、ブランチ名の直接指定、コンテキストからの自動命名に対応。

使用方法:
  /shiiman-github:branch-create [Issue番号|ブランチ名] [オプション]

オプション:
  --help  このヘルプを表示

例:
  /shiiman-github:branch-create 5                   # Issue #5 から feature/5 を作成
  /shiiman-github:branch-create feature/add-auth     # ブランチ名を直接指定
  /shiiman-github:branch-create                      # コンテキストから自動命名

ワークフロー

1. ブランチ名の決定

引数の内容に応じて分岐:

A) 引数が Issue 番号の場合(数値のみ、例: 5):

  1. Issue 情報を取得
gh issue view {issue番号} --json title,labels
  1. Issue タイプに応じたブランチ名を決定
Issue タイプブランチ形式
機能追加(enhancement)feature/{issue番号}
バグ修正(bug)fix/{issue番号}
ドキュメント(documentation)docs/{issue番号}
リファクタリングrefactor/{issue番号}
その他feature/{issue番号}

B) 引数がブランチ名の場合(数値以外、例: feature/add-auth):

  • そのまま使用

C) 引数なしの場合:

  1. 会話コンテキスト(直前のタスク説明・指示内容)からブランチ名を自動命名
    • 例: 「認証機能を追加」→ feature/add-auth
    • 例: 「ログインバグを修正」→ fix/login-bug
  2. 手がかりがない場合のみユーザーに確認

2. ブランチ作成

# デフォルトブランチから最新を取得
DEFAULT_BRANCH="$(gh repo view --json defaultBranchRef -q '.defaultBranchRef.name')"
if [ -z "$DEFAULT_BRANCH" ]; then
  echo "ERROR: デフォルトブランチを取得できませんでした。" >&2
  exit 1
fi
git fetch origin "$DEFAULT_BRANCH"
git checkout "$DEFAULT_BRANCH"
git pull origin "$DEFAULT_BRANCH"

# 新しいブランチを作成
git checkout -b {ブランチ名}

ユーザーがベースブランチを明示した場合は、そちらを優先する。

3. 結果報告

Issue 指定時:

ブランチ `feature/{issue番号}` を作成しました。

関連 Issue: #{issue番号} - {issue タイトル}

作業を開始できます。

Issue なし時:

ブランチ `{ブランチ名}` を作成しました。

作業を開始できます。

重要な注意事項

  • ✅ デフォルトブランチから派生(ユーザー指定があればそちらを優先)
  • ✅ Issue タイプに応じたプレフィックス
  • ✅ コンテキストから自動命名を試みる
  • ❌ 既存ブランチを上書きしない
  • ❌ ユーザー指定なしでデフォルトブランチ以外から派生しない

Create Issue

GitHub Issue を作成します。タスクは Issue 本文内でチェックボックスに分割します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:issue-create - Create Issue

概要:
  GitHub Issue を作成します。
  タスクは Issue 本文内でチェックボックスに分割します。
  「ブランチも」「worktree も」と伝えれば作成後にブランチ/worktree も用意します。

使用方法:
  /shiiman-github:issue-create [タスク説明]

オプション:
  --help  このヘルプを表示

後続作成の伝え方:
  「ブランチも作って」    → Issue 作成後にブランチを作成
  「worktree も」         → Issue 作成後に worktree を作成(gtr 使用)
  指定なし                → Issue 作成のみで終了

例:
  /shiiman-github:issue-create                    # Issue を作成
  「Issue を作ってブランチも切って」        # Issue 作成後にブランチも作成
  「Issue を作って worktree も用意して」    # Issue 作成後に worktree も作成

内部呼び出し用:
  --no-confirm  許可済みワークフローからの呼び出し用の互換オプション

許可と確認の方針

グローバルの許可方針と現在の依頼から実行範囲を判断する。このスキルの操作を明示的に依頼されていれば、それを許可として扱い、生成した文面の承認や --no-confirm の指定を改めて求めない。このオプションは許可済みの呼び出しとの互換用であり、指定自体が許可を与えるものではない。セキュリティチェックは維持し、許可不足、重要な範囲変更、許可範囲外の具体的なリスクがある場合だけ確認する。

ワークフロー

1. タスクの確認

タスク説明と会話の情報を優先する。既存の情報から作成対象の Issue を判断できない場合だけ概要を質問する。

2. タスクの分割

タスクを Issue 本文内のチェックボックスに分割:

  • 1 タスク = 具体的なアクション(「〜を追加」「〜を修正」「〜を削除」)
  • 依存関係がある場合は順番に並べる
  • テストやドキュメント更新も個別タスクとして記載

3. Issue 内容の準備

依頼からタイトル・ラベル・タスクのチェックボックス・完了条件を用意する。明示的な Issue 作成依頼があれば文面を再承認せず作成する。重要な情報不足や未許可の範囲についてだけ確認する。--no-confirm 自体は許可を与えない。

4. Issue 作成

作成が許可され、内容を検証できたら gh issue create で Issue を作成する。

コマンドテンプレート:

gh issue create \
  --title "[{scope}] {title}" \
  --body "## 概要

{description}

## タスク

- [ ] {task1}
- [ ] {task2}
- [ ] {task3}

## 完了条件

- {condition1}
- {condition2}
" \
  --label "{labels}"

5. 結果報告

作成した Issue の結果を報告:

Issue を作成しました:

- 番号: #{number}
- タイトル: [{scope}] {title}
- ラベル: {labels}
- URL: {issue_url}

6. ブランチもしくは worktree 作成

引数・発話から後続作成の要否を判定する。

「ブランチも」と判定した場合:

作成した Issue の番号で shiiman-github:branch-create スキルのワークフローに従いブランチを自動作成する。

「worktree も」と判定した場合:

作成した Issue の番号で shiiman-github:worktree-create スキルのワークフローに従い worktree を自動作成する。

後続の作成が依頼されていない場合:

Issue の URL を報告して終了する。branch や worktree を作るかは質問しない。許可済みの親ワークフローで必要な場合は、その指定に従い追加確認せず進める。

Issue タイトルの形式

[{scope}] {title}

  • scope: 機能名や対象コンポーネント
  • title: 具体的なタスク内容

ラベルの自動判定

内容ラベル
新機能enhancement
バグ修正bug
テストenhancement
ドキュメントdocumentation
リファクタリングimprovement

重要な注意事項

  • ✅ タスクは Issue 本文内のチェックボックスで管理
  • ✅ 完了条件を明確にする
  • ✅ 具体的なアクションを記述
  • ❌ 曖昧なタスク記述
  • ❌ ブランチと worktree の同時作成はしない(どちらか一方のみ。両方求められた場合は worktree を優先して確認)

List Issues

オープン Issue の一覧を優先順位付きで表示します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:issue-list - Issue 一覧表示

概要:
  オープン Issue の一覧を優先順位付きで表示する。
  ラベルに基づく優先度ソートに対応。

使用方法:
  /shiiman-github:issue-list

オプション:
  --help  このヘルプを表示

絞り込みの伝え方(フラグの代わり):
  「クローズ済みも」「全部」  → クローズ済みも含めて表示
  「自分の」「自分担当」      → 自分がアサインされた Issue のみ

例:
  /shiiman-github:issue-list       # オープン Issue を表示
  「クローズした Issue も見せて」   # 全 Issue を表示
  「自分の Issue 一覧」             # 自分担当の Issue を表示

実行手順

1. 表示範囲を判定(フラグの代わり)

引数・発話から表示範囲を決める。明示がなければ既定(オープンのみ・全担当)とする。読み取り専用のため確認は不要。

項目既定判断ルール
状態オープン「クローズ済みも」「全部」→ 全状態
担当全員「自分の」「自分担当」→ 自分がアサインされたもの

2. Issue 一覧を取得

判定した範囲に応じて gh issue list を実行する。

# オープンのみ(既定)
gh issue list --json number,title,labels,assignees,createdAt --limit 50

# クローズ済みも含める(「クローズ済みも」と判定した場合)
gh issue list --state all --json number,title,labels,assignees,createdAt,state --limit 50

# 自分がアサインされたもの(「自分の」と判定した場合)
gh issue list --assignee @me --json number,title,labels,assignees,createdAt --limit 50

3. 優先順位でソート(ラベル: priority-high > priority-medium > priority-low)

4. 以下の形式で表示

出力フォーマット

## オープン Issue 一覧

| 優先度 | # | タイトル | ラベル | 担当者 | 作成日 |
|:------:|---|----------|--------|--------|--------|
| 🔴 | #5 | バグ修正 | bug, priority: high | @user | 2024-01-01 |
| 🟡 | #3 | 機能追加 | enhancement | - | 2024-01-02 |
| 🟢 | #1 | ドキュメント | docs, priority: low | @user | 2024-01-03 |

合計: 3 件のオープン Issue

優先度の判定

優先度アイコン条件
高🔴priority: high ラベル または bug ラベル
中🟡priority: medium ラベル または ラベルなし
低🟢priority: low ラベル または documentation ラベル

重要な注意事項

  • ✅ 優先度順にソートして表示
  • ✅ 担当者がいない場合は - で表示
  • ✅ ラベルはカンマ区切りで表示
  • ❌ Issue の内容は表示しない(一覧のみ)

Create PR

現在のブランチから PR を作成または更新します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:pr-create - PR 作成・更新

概要:
  現在のブランチから PR を作成または更新する。
  既存 PR がある場合は自動的に更新モードになる。
  ブランチ名から関連 Issue を自動検出し、PR テンプレートに従って本文を生成。

使用方法:
  /shiiman-github:pr-create [タイトル]

オプション:
  --help  このヘルプを表示

指定の伝え方:
  「ドラフトで」「draft で」      → ドラフト PR として作成
  「develop 向けに」「base は X」  → 宛先ブランチを指定(既定: リポジトリのデフォルトブランチ)

例:
  /shiiman-github:pr-create               # PR を作成または更新
  /shiiman-github:pr-create "タイトル"     # タイトルを指定して PR 作成
  「ドラフトで PR を作って」        # ドラフト PR を作成
  「develop 向けに PR を作成」      # develop ブランチ向けに PR 作成

内部呼び出し用:
  --no-confirm  許可済みワークフローからの呼び出し用の互換オプション

許可と確認の方針

グローバルの許可方針と現在の依頼から実行範囲を判断する。このスキルの操作を明示的に依頼されていれば、それを許可として扱い、生成した文面の承認や --no-confirm の指定を改めて求めない。このオプションは許可済みの呼び出しとの互換用であり、指定自体が許可を与えるものではない。セキュリティチェックは維持し、許可不足、重要な範囲変更、許可範囲外の具体的なリスクがある場合だけ確認する。

起動時の自動判断

引数・発話から PR の作成条件を判定する。明示がなければ既定を採用する。

項目既定判断ルール
宛先ブランチリポジトリのデフォルト「develop 向けに」「base は X」等の発話があれば X
ドラフト通常 PR「ドラフトで」「draft で」「WIP」等あれば draft

ワークフロー

1. 事前チェック

DEFAULT_BRANCH="$(gh repo view --json defaultBranchRef -q '.defaultBranchRef.name')"
CURRENT_BRANCH="$(git branch --show-current)"

# ブランチ状態確認
git status --short
git fetch origin
git log "origin/${CURRENT_BRANCH}..HEAD" --oneline 2>/dev/null

ブランチ状態の検証:

  • 未コミットの変更と未 push のコミットを確認する。feature branch が未 push という理由だけで終了しない。
  • PR 作成の依頼には、対象の feature branch のコミットを公開するために必要な通常の push を含む。remote・送信先・送信する差分を確認し、この許可だけで force-push やデフォルトブランチへの push は行わない。
  • 対象変更のコミットが必要なら、その変更からの PR 作成依頼には検証後の必要なコミットも含む。shiiman-git:add-commit を使い、対象パスや hunk だけをコミットして無関係な編集・ステージ済みの内容を保護する。
  • 対象範囲を安全に判断できない場合や、許可されていない内容を公開してしまう場合だけ確認する。「コミットしない」「push しない」などの制約を優先し、実行できない場合は阻害要因を報告して PR 完了を主張しない。

2. 既存 PR の自動検出

gh pr list --head "${CURRENT_BRANCH}" --json number,title,url
  • 既存 PR あり: 更新モードに切替(タイトル・本文の更新を提案)
  • 既存 PR なし: 新規作成モード

3. 変更内容の確認

git log "origin/${DEFAULT_BRANCH}..HEAD" --oneline
git diff "origin/${DEFAULT_BRANCH}...HEAD" --stat

4. 関連 Issue の特定

以下から関連 Issue を判定:

  • ブランチ名(feature/5 → #5)
  • コミットメッセージ
  • 関連 Issue を特定できなければリンクを省略する。リンクが必須で対象が曖昧な場合だけ確認する。

5. 破壊的変更の検出

コミットと公開 API の変更から破壊的変更の有無を確認する。確認できた場合は Conventional Commits のタイトルに明示し、影響を説明する。タイトルに記号を付けるかの追加確認はしない。PR 作成の許可はデプロイやマージの許可を含まない。

6. PR 内容の作成

タイトル: Conventional Commits 形式

タイプ説明例
feat新機能feat: shiiman-git プラグインを追加
fixバグ修正fix: Issue 番号の取得を修正
docsドキュメントdocs: README を更新
refactorリファクタリングrefactor: スキル構造を整理
choreその他の変更chore: 依存関係を更新

検証した差分、リポジトリのテンプレート、実際の検証結果から日本語のタイトルと本文を作成する。PR 作成・更新が許可済みなら、文面の再承認を求めず進める。--no-confirm は任意であり、許可範囲を広げない。

7. PR 作成・更新

新規作成の場合:

gh pr create \
  --title "feat: {変更内容の要約}" \
  --body "## 概要

{変更内容の説明}

## 変更内容

- {変更点1}
- {変更点2}

## 関連 Issue

Closes #{issue番号}

## テスト計画

- [ ] {テスト項目1}
- [ ] {テスト項目2}

## チェックリスト

- [x] 命名規則に従っている
- [x] README.md を更新した(必要な場合)
- [x] 動作確認済み"

ドラフトと判定した場合は gh pr create --draft を使用。宛先ブランチを判定した場合は gh pr create --base {branch} を付与する(既定はリポジトリのデフォルトブランチ)。

更新の場合:

gh pr edit {pr番号} \
  --title "{更新タイトル}" \
  --body "{更新本文}"

8. 結果報告

PR を{作成|更新}しました:

- URL: {pr_url}
- タイトル: {title}
- 関連 Issue: #{issue番号}
- モード: {新規作成|更新}

マージ後、Issue #{issue番号} は自動的にクローズされます。

重要な注意事項

  • ✅ 既存 PR がある場合は自動的に更新モードになる
  • ✅ Conventional Commits 形式のタイトル
  • 確認済みの関連 Issue がある場合は Closes #N で参照し、なければ該当セクションを省略する。
  • ✅ PR タイトルと本文は日本語
  • PR 作成前に、許可されたコミットと通常の feature branch push を完了し、無関係な作業を保護する。
  • 存在しない Issue を記載したり、未実行のチェックが成功したと主張したりしない。

List PRs

オープン PR の一覧を優先順位付きで表示します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:pr-list - PR 一覧表示

概要:
  オープン PR の一覧をレビュー状態と優先順位付きで表示する。

使用方法:
  /shiiman-github:pr-list

オプション:
  --help  このヘルプを表示

絞り込みの伝え方(フラグの代わり):
  「マージ済みも」「全部」  → マージ済みも含めて表示
  「自分の」「自分作成」    → 自分が作成した PR のみ

例:
  /shiiman-github:pr-list        # オープン PR を表示
  「マージ済みの PR も見せて」    # 全 PR を表示
  「自分の PR 一覧」              # 自分作成の PR を表示

実行手順

1. 表示範囲を判定(フラグの代わり)

引数・発話から表示範囲を決める。明示がなければ既定(オープンのみ・全作成者)とする。読み取り専用のため確認は不要。

項目既定判断ルール
状態オープン「マージ済みも」「全部」→ 全状態
作成者全員「自分の」「自分作成」→ 自分の PR のみ

2. PR 一覧を取得

判定した範囲に応じて gh pr list を実行する。

# オープンのみ(既定)
gh pr list --json number,title,headRefName,author,reviewDecision,updatedAt --limit 50

# マージ済みも含める(「マージ済みも」と判定した場合)
gh pr list --state all --json number,title,headRefName,author,reviewDecision,updatedAt,state --limit 50

# 自分が作成したもの(「自分の」と判定した場合)
gh pr list --author @me --json number,title,headRefName,author,reviewDecision,updatedAt --limit 50

3. レビュー状態と優先順位でソート

4. 以下の形式で表示

出力フォーマット

## オープン PR 一覧

| 状態 | # | タイトル | ブランチ | レビュー | 作成者 | 更新日 |
|:----:|---|----------|----------|----------|--------|--------|
| 🔄 | #10 | feat: 新機能 | feature/5 | ⏳ 待機中 | @user | 2024-01-01 |
| ✅ | #8 | fix: バグ修正 | fix/bug | ✅ 承認済 | @user | 2024-01-02 |
| ⚠️ | #6 | docs: 更新 | docs/update | ❌ 要修正 | @user | 2024-01-03 |

合計: 3 件のオープン PR

状態アイコン

アイコン状態条件
🔄レビュー待ちreviewDecision が null または REVIEW_REQUIRED
✅承認済みreviewDecision が APPROVED
⚠️変更要求ありreviewDecision が CHANGES_REQUESTED
🚧ドラフトisDraft が true

レビュー状態アイコン

アイコン状態
⏳ 待機中レビュー未依頼またはレビュー中
✅ 承認済承認済み(マージ可能)
❌ 要修正変更要求あり

重要な注意事項

  • ✅ レビュー状態順にソートして表示
  • ✅ ブランチ名を表示して関連 Issue を推測可能に
  • ✅ 更新日順でソート
  • ❌ PR の内容は表示しない(一覧のみ)

Check PR Review

自分の PR に付いたレビューコメントを確認し、修正対応を実行します。

注意: 他者の PR をレビューする場合は pr-review を使用してください。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:pr-review-check - レビュー指摘対応(PR 作成者向け)

概要:
  自分の PR に付いたレビューコメントを確認し、修正対応を実行する。
  既定は確認のみ。「修正して」と伝えると修正まで実行する。

使用方法:
  /shiiman-github:pr-review-check [PR番号]

オプション:
  --help  このヘルプを表示

実行モードの伝え方(フラグの代わり):
  指定なし              → レビュー指摘の確認のみ(修正・投稿はしない)
  「修正して」「対応して」 → 指摘を修正して検証。コミット・push・返信はそれぞれ依頼済みの場合だけ実行

例:
  /shiiman-github:pr-review-check        # 現在のブランチの PR のレビューを確認
  /shiiman-github:pr-review-check 123    # PR #123 のレビューを確認
  「レビュー指摘を修正して」              # 指摘を修正して対応

起動時の自動判断(フラグの代わり)

引数・発話から実行モードを判定する。明示がなければ「確認のみ」とする(安全側)。

モード条件動作
確認のみ既定指摘事項を分類して表示するだけ。修正・投稿はしない
修正「修正して」「対応して」等の発話指摘を修正・検証し、許可された後続操作だけを実行

修正だけの依頼はローカル修正と検証で完了する。コミット・push・返信投稿は、それぞれ明示的な依頼または親ワークフローの許可がある場合だけ実行し、同じ操作の許可を取り直さない。返信投稿の許可は修正や PR 更新の依頼だけから推測しない。

ワークフロー

ステップ 1: PR 番号の特定

PR 番号が指定されていない場合、現在のブランチの PR を検出:

gh pr view --json number,title,url

ステップ 2: レビューコメントの取得

# PR のレビューコメント取得
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments

# PR レビュー取得
gh pr view {pr番号} --json reviews

ステップ 3: 指摘事項の分類と表示

プレフィックス種別対応
must.修正必須修正の必要性を検証し、許可範囲内で対応
imo.改善提案採否を検討し、許可範囲内で対応
nits.軽微修正を検討し、許可範囲内で対応
q.質問回答案を準備し、投稿許可がある場合だけ返信

表示形式:

=== PR #{pr番号}: {タイトル} ===

【must.】修正必須 (N件)
1. [{ファイル}:{行}] {コメント内容}
   comment_id: {id}

【imo.】改善提案 (N件)
...

「修正して」と伝えると、指摘の修正まで実行できます。

確認のみモード(既定)の場合はここで終了する。

ステップ 4: 修正の実行(修正モードと判定した場合)

各指摘事項について:

  1. 対象ファイルを Read で読み込む
  2. 指摘内容を理解して修正方針を決定
  3. Edit で修正を実行
  4. 修正内容を記録(返信用)

ステップ 5: 許可されたコミット・push

修正内容を検証し、コミットが依頼済みなら対象パス・hunk だけをコミットする。コミットだけの依頼ではそこで終了する。push または PR 更新まで依頼済みの場合だけ、必要な通常の feature branch push を行う。無関係なステージ済みの変更や未ステージの変更を保護する。許可がない場合はローカル修正と検証結果の報告で終了し、任意の後続操作を追加で質問しない。具体的な範囲変更や危険な操作が必要な場合だけ確認する。force-push やデフォルトブランチへの push に許可を広げない。

ステップ 6: レビューコメントへの返信(重要)

返信投稿が明示的に依頼されている場合だけ、各コメントへの対応内容を確認して投稿する。 許可済みの返信は再確認せず、未実行の修正を実行済みと記載しない。

gh api repos/{owner}/{repo}/pulls/{pr番号}/comments/{comment_id}/replies \
  -X POST \
  -f body="修正しました。{修正内容の説明}"

返信メッセージのテンプレート:

対応種別返信メッセージ
コード修正修正しました。{具体的な修正内容}
提案採用ご提案ありがとうございます。採用しました。
質問への回答{質問への回答}
対応見送りご指摘ありがとうございます。{理由} のため、今回は見送りとさせてください。

ステップ 7: 結果報告

## レビュー指摘への対応を完了しました

### 修正内容
| 指摘 | ファイル | 対応 | 返信 |
|------|----------|------|------|
| must. {内容} | {file}:{line} | {実際の修正状況} | {返信済み・未投稿} |
| imo. {内容} | {file}:{line} | {実際の修正状況} | {返信済み・未投稿} |

### コミット
- ハッシュ: {実際にコミットした場合だけ記載}
- プッシュ: {実際の結果・未実行}

再レビューをお願いしてください。

返信 API の詳細

コメントへの返信

# comment_id は gh api で取得したレビューコメントの id
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments/{comment_id}/replies \
  -X POST \
  -f body="修正しました。"

レビュー全体への返信(オプション)

gh pr comment {pr番号} --body "レビューありがとうございます。全ての指摘に対応しました。"

重要な注意事項

  • ✅ 修正したら必ずコメントに返信する
  • ✅ 返信には具体的な修正内容を記載する
  • ✅ 質問には丁寧に回答する
  • ✅ 対応見送りの場合も理由を説明する
  • ❌ 指摘を無視しない
  • ❌ 返信せずにプッシュだけしない

Review PR

PR をレビューし、結果をローカル表示または GitHub に投稿します。

注意: 自分の PR に付いたレビューコメントに対応する場合は pr-review-check を使用してください。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:pr-review - PR レビュー

概要:
  PR をレビューし、結果をローカル表示または GitHub に投稿する。
  既定はローカル表示のみ。投稿・承認は明示的な依頼から判断し、許可済みの操作は再確認しない。

使用方法:
  /shiiman-github:pr-review [PR番号]

オプション:
  --help  このヘルプを表示

出力先・レビュー結果の伝え方(フラグの代わり):
  指定なし                  → ローカル表示のみ(GitHub には投稿しない)
  「GitHub に投稿して」      → レビューコメントを GitHub に投稿
  「approve」「承認」「LGTM」 → Approve として投稿
  「要修正」「変更要求」      → Request Changes として投稿

例:
  /shiiman-github:pr-review        # 現在のブランチの PR をレビュー(ローカル表示)
  /shiiman-github:pr-review 123    # PR #123 をレビュー(ローカル表示)
  「PR #123 をレビューして投稿して」 # レビューして GitHub に投稿
  「PR #123 を approve して」       # PR #123 を承認

起動時の自動判断(フラグの代わり)

引数・発話から出力先とレビュー結果を判定する。明示がなければローカル表示のみ(誤投稿防止の安全側)とする。

項目既定判断ルール
出力先ローカル表示「投稿して」「GitHub に」「approve」「要修正」等あれば投稿
レビュー結果コメント「approve」「承認」「LGTM」→ Approve/「要修正」→ Request Changes

レビューだけの依頼ではローカル表示で終了する。GitHub への投稿・承認・変更要求が対象 PR とともに明示的に依頼済みなら、内容を検証して再確認せず実行する。 投稿種別や対象が曖昧な場合だけ確認し、許可なしにローカルレビューを外部投稿へ切り替えない。

ワークフロー

1. 対象 PR の特定

  • PR 番号が指定されている場合: その PR をレビュー
  • PR 番号が指定されていない場合: 現在のブランチの PR を自動検出
# PR 番号未指定時の自動検出
gh pr view --json number,title,url

2. レビュータイプの確認

ユーザーにレビュータイプを確認(複数選択可):

タイプ説明チェック観点
general全体レビューコード品質、設計、テスト
securityセキュリティOWASP Top 10、入力検証、認証・認可
performanceパフォーマンスN+1、メモリリーク、アルゴリズム効率

デフォルト: general

3. PR 内容の取得

# PR 情報取得
gh pr view {pr番号} --json title,body,files,additions,deletions

# 変更差分取得
gh pr diff {pr番号}

4. レビュー実行

全体レビュー(general):

  • コードスタイル・命名規則
  • 設計パターン・責務分離
  • エラーハンドリング
  • テストカバレッジ
  • ドキュメント

セキュリティレビュー(security):

  • インジェクション(SQL, XSS, Command)
  • 認証・認可の実装
  • 機密情報の扱い
  • 入力検証
  • セッション管理

パフォーマンスレビュー(performance):

  • N+1 クエリ
  • メモリリーク
  • 不要なループ・計算
  • キャッシュ戦略
  • 非同期処理

5. 重要度の分類

レベル説明
Criticalセキュリティリスク、アーキテクチャ違反
Highパフォーマンス問題、重要な規約違反
Mediumコード品質向上
Lowスタイル提案

6. 結果の出力

ローカル表示のみ(既定): ローカルに結果を表示し、ここで終了する

## コードレビュー結果

### サマリー
{overall_assessment}

### 良い点
- {good_point_1}

### 改善提案
- [ ] {suggestion_1}

### 重要度: 高
{high_priority_issues}

### 重要度: 中
{medium_priority_issues}

### 重要度: 低
{low_priority_issues}

投稿が依頼され、投稿種別も明確な場合: 内容と対象を検証して再確認せず投稿する。投稿依頼はあるが種別が不明な場合だけ、次の選択肢で確認する。

question: "レビュー結果を GitHub に投稿しますか?"
options:
  - コメントとして投稿: gh pr review --comment で投稿
  - Approve として投稿: gh pr review --approve で承認
  - Request Changes として投稿: gh pr review --request-changes で変更要求
  - 投稿しない: ローカル表示のみで終了

明示的な依頼または必要な確認で許可された投稿種別のコマンドだけを実行する。

# コメントとして投稿
gh pr review {pr番号} --comment --body "{レビュー内容}"

# Approve として投稿
gh pr review {pr番号} --approve --body "{レビュー内容}"

# Request Changes として投稿
gh pr review {pr番号} --request-changes --body "{レビュー内容}"

7. 結果報告

PR #{pr番号} のレビューを完了しました。

レビュータイプ: {types}
出力先: {ローカル表示|GitHub 投稿}
重要な指摘: {high_priority_count}件
改善提案: {suggestion_count}件

簡易承認フロー(「approve」「LGTM」のみ伝えられた場合)

レビュー依頼なしで「approve」「承認」「LGTM」だけ伝えられた場合、詳細レビューをスキップして承認のみ行う。対象 PR の承認が明示的に依頼済みなら、状態確認後に再確認せず実行する。対象が曖昧な場合だけ確認し、マージまでは行わない。

1. PR 状態の確認

gh pr view {pr番号} --json title,state,reviews,mergeable,statusCheckRollup

以下を確認:

  • 未対応の必須修正がないか
  • CI が通っているか
  • マージ可能な状態か

2. 許可済みの承認を実行

対象と操作の許可が確認できれば実行する。未対応の重大な指摘や CI 失敗があれば報告して解決し、承認を機械的に強行しない。

gh pr review {pr番号} --approve --body "{承認コメント}"

3. 結果報告

PR #{pr番号} を承認しました。

ステータス: ✅ Approved
マージ可能: {mergeable}

マージする場合:
gh pr merge {pr番号}

承認コメントテンプレート

シンプル:

LGTM! 🎉

詳細:

## Approved

{approval_comment}

### 確認済み項目

- [x] コード品質
- [x] テスト
- [x] ドキュメント

LGTM! 🎉

重要な注意事項

  • ✅ 投稿の意図が明示されない場合はローカル表示のみ(誤投稿防止の安全側)
  • GitHub への投稿・承認・変更要求は明示的な許可がある場合だけ実行し、同じ許可を取り直さない。
  • ✅ 「approve」「LGTM」のみの場合は簡易承認フローへ(確認後に承認)
  • ✅ 具体的な改善提案を含める
  • ✅ 良い点も指摘する
  • ✅ 重要度を明確にする
  • ❌ 曖昧なコメントを避ける
  • ❌ 個人攻撃的なコメントは禁止

Setup GitHub

プロジェクトの .github ディレクトリに GitHub 設定ファイルを一括生成します。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:setup - GitHub 設定セットアップ

概要:
  .github ディレクトリに Issue テンプレート、PR テンプレート、
  ラベル定義、GitHub Actions workflow を一括生成する。

使用方法:
  /shiiman-github:setup

オプション:
  --help  このヘルプを表示

実行モードの伝え方(フラグの代わり):
  「確認だけ」「何が作られるか見たい」  → 生成予定のファイル一覧のみ表示(生成しない)
  指定なし                             → ファイルを生成(既存ファイルは確認してから上書き)

例:
  /shiiman-github:setup           # 設定ファイルを生成
  「何が作られるか先に見せて」      # 生成予定のファイルを確認

起動時の自動判断(フラグの代わり)

引数・発話から実行モードを判定する。明示がなければ「生成」とする。

モード条件動作
確認「確認だけ」「見せて」「プレビュー」等あり生成予定のファイル一覧のみ表示して終了
生成既定ファイルを生成(既存は AskUserQuestion で確認)

生成されるファイル

ファイル説明
.github/ISSUE_TEMPLATE/config.ymlIssue テンプレート設定
.github/ISSUE_TEMPLATE/bug-report.ymlバグ報告テンプレート
.github/ISSUE_TEMPLATE/feature-request.yml機能リクエストテンプレート
.github/ISSUE_TEMPLATE/improvement.yml改善提案テンプレート
.github/pull_request_template.mdPR テンプレート
.github/copilot-instructions.mdGitHub Copilot 設定
.github/labels.ymlラベル定義
.github/labeler.yml自動ラベル付けルール
.github/workflows/sync-labels.ymlラベル同期 workflow
.github/workflows/labeler.yml自動ラベル付け workflow

実行手順

ステップ 1: 事前確認

  1. .github ディレクトリの存在確認
  2. 既存ファイルの有無をチェック

既存ファイルがある場合:

AskUserQuestion で上書き可否を必ず確認する(既存設定を失う不可逆操作のため)。

question: "既存の .github 設定ファイルがあります。どうしますか?"
options:
  - 上書きする: 既存ファイルを生成内容で置き換える
  - 既存を残す: 既存ファイルはスキップし、未作成のファイルのみ生成
  - 中止する: 生成を行わず終了

ステップ 2: プロジェクト情報収集

ユーザーに以下を確認:

  1. プロジェクト名(リポジトリ名から推測、確認)
  2. プロジェクトタイプ(選択肢を提示)
    • Web アプリ (React/Vue/etc.)
    • バックエンド (Node.js/Go/Python/etc.)
    • ライブラリ/パッケージ
    • CLI ツール
    • その他

ステップ 3: テンプレート読み込み

skills/setup/assets/ からテンプレートを読み込み、プロジェクト情報で変数を置換。

置換する変数:

変数説明
{{REPO}}リポジトリ名
{{OWNER}}リポジトリオーナー
{{PROJECT_TYPE}}プロジェクトタイプ

ステップ 4: ファイル生成

以下の順序で生成:

  1. .github/ ディレクトリ作成(なければ)
  2. .github/ISSUE_TEMPLATE/ ディレクトリ作成
  3. .github/workflows/ ディレクトリ作成
  4. 各テンプレートファイルを生成

ステップ 5: 完了報告

生成されたファイル一覧と次のステップを表示:

## 生成完了

以下のファイルを生成しました:

- .github/ISSUE_TEMPLATE/config.yml
- .github/ISSUE_TEMPLATE/bug-report.yml
- .github/ISSUE_TEMPLATE/feature-request.yml
- .github/ISSUE_TEMPLATE/improvement.yml
- .github/pull_request_template.md
- .github/copilot-instructions.md
- .github/labels.yml
- .github/labeler.yml
- .github/workflows/sync-labels.yml
- .github/workflows/labeler.yml

## 次のステップ

1. 各テンプレートをプロジェクトに合わせてカスタマイズ
2. `git add .github && git commit -m "chore: GitHub 設定ファイルを追加"`
3. GitHub にプッシュしてラベル同期を実行

生成ファイルのテンプレート

テンプレートファイルは assets/ ディレクトリに配置:

  • assets/ISSUE_TEMPLATE/ - Issue テンプレート
  • assets/pull_request_template.md - PR テンプレート
  • assets/copilot-instructions.md - Copilot 設定
  • assets/labels.yml - ラベル定義
  • assets/labeler.yml - 自動ラベル付けルール
  • assets/workflows/ - GitHub Actions workflow

重要な注意事項

  • ✅ テンプレートは汎用的な内容なので、プロジェクトに合わせて調整が必要
  • ✅ ラベル同期 workflow は main ブランチへのプッシュ時に実行される
  • ❌ 既存の設定ファイルを無断で上書きしない

Create Worktree

gtr (git-worktree-runner) を使用して worktree を作成します。Issue 番号指定・ブランチ名直接指定・コンテキストからの自動命名に対応。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-github:worktree-create - Create Worktree

概要:
  gtr を使用して worktree を作成する。
  Issue 番号、ブランチ名の直接指定、コンテキストからの自動命名に対応。

使用方法:
  /shiiman-github:worktree-create [Issue番号|ブランチ名] [オプション]

オプション:
  --help  このヘルプを表示

例:
  /shiiman-github:worktree-create 5                   # Issue #5 から feature/5 の worktree を作成
  /shiiman-github:worktree-create feature/add-auth     # ブランチ名を直接指定して worktree を作成
  /shiiman-github:worktree-create                      # コンテキストから自動命名

前提条件

  • gtr (git-worktree-runner) がインストール済み
    • 未インストールの場合は shiiman-git:worktree-setup スキルを案内する

ワークフロー

1. gtr の確認

git gtr --version

コマンドが失敗した場合:

gtr がインストールされていません。
`/shiiman-git:worktree-setup` でインストールと設定ができます。

2. ブランチ名の決定

引数の内容に応じて分岐:

A) 引数が Issue 番号の場合(数値のみ、例: 5):

  1. Issue 情報を取得
gh issue view {issue番号} --json title,labels
  1. Issue タイプに応じたブランチ名を決定
Issue タイプブランチ形式
機能追加(enhancement)feature/{issue番号}
バグ修正(bug)fix/{issue番号}
ドキュメント(documentation)docs/{issue番号}
リファクタリングrefactor/{issue番号}
その他feature/{issue番号}

B) 引数がブランチ名の場合(数値以外、例: feature/add-auth):

  • そのまま使用

C) 引数なしの場合:

  1. 会話コンテキスト(直前のタスク説明・指示内容)からブランチ名を自動命名
    • 例: 「認証機能を追加」→ feature/add-auth
    • 例: 「ログインバグを修正」→ fix/login-bug
  2. 手がかりがない場合のみユーザーに確認

3. worktree 作成

# デフォルトブランチから最新を取得
DEFAULT_BRANCH="$(gh repo view --json defaultBranchRef -q '.defaultBranchRef.name')"
if [ -z "$DEFAULT_BRANCH" ]; then
  echo "ERROR: デフォルトブランチを取得できませんでした。" >&2
  exit 1
fi
git fetch origin "$DEFAULT_BRANCH"

# gtr で worktree を作成(デフォルトブランチをベースに指定)
git gtr new {ブランチ名} --from "origin/${DEFAULT_BRANCH}"

ユーザーがベースブランチを明示した場合は、--from-current オプションを使用:

git gtr new {ブランチ名} --from-current

4. worktree ディレクトリへ移動

作成した worktree のパスに cd で移動する。

cd {worktree のパス}

5. mise trust(mise.toml が存在する場合)

mise のセキュリティ仕様により、新しい worktree パスでは mise.toml が未信頼扱いになる。 mise.toml が存在する場合は信頼登録を実行する。

if [ -f "mise.toml" ]; then
  mise trust mise.toml
fi

失敗した場合はエラーを表示するが、処理は継続する(mise を使わない環境では不要なため)。

6. 結果報告

Issue 指定時:

worktree `feature/{issue番号}` を作成しました。

関連 Issue: #{issue番号} - {issue タイトル}
パス: {worktree のパス}

作業を開始できます。

Issue なし時:

worktree `{ブランチ名}` を作成しました。

パス: {worktree のパス}

作業を開始できます。

重要な注意事項

  • ✅ デフォルトブランチから派生(ユーザー指定があればそちらを優先)
  • ✅ Issue タイプに応じたプレフィックス
  • ✅ コンテキストから自動命名を試みる
  • ✅ gtr を使用して worktree を管理
  • ❌ 既存ブランチを上書きしない
  • ❌ ユーザー指定なしでデフォルトブランチ以外から派生しない

エラーハンドリング

gtr がインストールされていない場合

gtr がインストールされていません。
`/shiiman-git:worktree-setup` でインストールと設定ができます。

worktree 作成に失敗した場合

エラーメッセージを表示し、原因と対処法を提案する。

関連リソース

  • gtr 公式リポジトリ: https://github.com/coderabbitai/git-worktree-runner
  • 関連スキル: shiiman-git:worktree - worktree の一覧・削除・クリーンアップ
  • 関連スキル: shiiman-git:worktree-setup - gtr のインストールと .gtrconfig 設定
  • 関連スキル: shiiman-github:branch-create - ブランチのみ作成(worktree なし)

Agents 6

GitHub Actions デバッグ専門エージェント

GitHub Actions のワークフロー実行エラーを調査し、失敗したジョブのログを分析して原因を特定し、具体的な修正方法を提案します。

実行内容

  • 失敗した Run の特定とログ取得
  • エラーメッセージの分析と原因特定
  • 関連するソースコードやワークフロー定義の調査
  • 具体的な修正提案の提示

使用タイミング

  • GitHub Actions のワークフローが失敗した時
  • CI/CD パイプラインのエラー調査時
  • PR のチェックが失敗した時

専門知識

  • GitHub Actions のワークフロー構文(YAML)
  • CI/CD パイプラインの一般的なエラーパターン
  • テストフレームワーク(Jest, pytest, Go test 等)のエラー出力
  • ビルドツール(npm, yarn, make, cargo 等)のエラーメッセージ
  • Docker / コンテナ関連のエラー

使用する gh コマンド

失敗した Run の特定

# 最近の失敗した Run を一覧表示
gh run list --status failure --limit 5

# 特定の PR に関連するチェックを確認
gh pr checks {pr番号}

エラーログの取得

# Run の詳細とジョブ一覧を取得
gh run view {run_id} --verbose

# 失敗したステップのログを取得
gh run view {run_id} --log-failed

ワークフロー定義の確認

# ワークフロー一覧を表示
gh workflow list

# ワークフロー定義を確認
gh workflow view {workflow_name}

エラー分析手順

1. エラーの分類

ログから以下のエラーパターンを特定:

パターンキーワード対処方針
テスト失敗FAIL, AssertionError, Expectedテストコードまたは実装を修正
ビルドエラーerror TS, SyntaxError, compileコンパイルエラーを修正
依存関係エラーnpm ERR!, ModuleNotFoundError依存関係を更新
権限エラーPermission denied, 403, 401permissions / secrets を確認
タイムアウトtimeout, exceededジョブのタイムアウト設定を調整

2. 関連ファイルの調査

  • .github/workflows/ 配下のワークフロー定義
  • エラーが発生したソースコード
  • 設定ファイル(package.json, tsconfig.json 等)

3. 修正提案の作成

  • エラーの根本原因を説明
  • 具体的な修正コードまたは設定変更を提示
  • ローカルでの再現・検証方法を提示

出力形式

エラーレポート

## GitHub Actions エラー調査結果

**Run ID**: {run_id}
**ワークフロー**: {workflow_name}
**ステータス**: ❌ failure

### 失敗したジョブ

| ジョブ | ステップ | 原因 |
|--------|----------|------|
| {job} | {step} | {cause} |

### エラー詳細

{エラーログの抜粋}

### 修正提案

1. {具体的な修正手順}
2. {追加の対処法}

### 参考コマンド

{ローカルでの再現コマンド}

重要な注意事項

  • ✅ エラーログを詳細に分析する
  • ✅ 具体的な修正提案を含める
  • ✅ ローカルでの再現方法を提示する
  • ✅ ワークフロー定義も合わせて確認する
  • ❌ 漠然とした提案を避ける
  • ❌ 関係ないエラーを混同しない
  • ❌ ログを読まずに推測で回答しない

Issue 管理専門エージェント

GitHub Issue の作成、更新、クローズ、ラベル管理など Issue に関する操作を包括的にサポートします。

実行内容

  • Issue の作成(テンプレートに基づく)
  • Issue のステータス更新
  • ラベルの追加・削除
  • アサイン管理
  • Issue の検索・フィルタリング
  • 関連 Issue のリンク管理

使用タイミング

  • 新しい機能・バグを Issue として登録する時
  • Issue のステータスを更新する時
  • Issue を整理・分類する時
  • 関連 Issue を探す時

専門知識

  • GitHub Issue のベストプラクティス
  • 効果的な Issue テンプレート
  • ラベル体系の設計
  • プロジェクト管理手法

使用する gh コマンド

Issue の作成

# 基本的な Issue 作成
gh issue create \
  --title "[タイプ] タイトル" \
  --body "説明" \
  --label "enhancement"

# テンプレートを使用
gh issue create --template bug_report.md

Issue の一覧・検索

# Issue 一覧
gh issue list

# ラベルでフィルタ
gh issue list --label "bug"

# アサイニーでフィルタ
gh issue list --assignee "@me"

# 検索クエリ
gh issue list --search "is:open label:bug"

Issue の更新

# Issue を閉じる
gh issue close {issue番号}

# Issue を再オープン
gh issue reopen {issue番号}

# ラベルを追加
gh issue edit {issue番号} --add-label "in-progress"

# ラベルを削除
gh issue edit {issue番号} --remove-label "backlog"

# アサイン
gh issue edit {issue番号} --add-assignee "{username}"

# コメント追加
gh issue comment {issue番号} --body "コメント内容"

Issue の詳細取得

# Issue の詳細
gh issue view {issue番号}

# JSON 形式で取得
gh issue view {issue番号} --json title,body,labels,assignees,state

Issue タイトルの命名規則

タイププレフィックス例
バグ[Bug][Bug] ログイン時にエラー
機能[Feature][Feature] ダークモード対応
改善[Improvement][Improvement] 検索速度向上
ドキュメント[Docs][Docs] README 更新
リファクタ[Refactor][Refactor] 認証ロジック整理

出力形式

Issue サマリー

#タイトルステータスラベルアサイニー
1[Bug] ログインエラーOpenbug, high@user1
2[Feature] ダークモードIn Progressenhancement@user2

使用例

# Issue を作成
「ログイン失敗時のエラーメッセージを改善」という Issue を作って

# Issue を検索
バグラベルの Issue を一覧表示して

# Issue を更新
Issue #42 を完了としてクローズして

パフォーマンスチェック専門エージェント

Pull Request のコード変更をパフォーマンスの観点から分析し、潜在的な問題を検出して GitHub にコメントします。

実行内容

  • PR の差分からパフォーマンス問題を分析
  • N+1 クエリの検出
  • メモリリークの可能性の指摘
  • 非効率なアルゴリズム・データ構造の検出
  • 不要な再レンダリングの検出(React)
  • GitHub PR にパフォーマンスレビューコメントを投稿

使用タイミング

  • データベースアクセスを含む変更時
  • ループ・再帰処理の変更時
  • 大量データを扱うコード変更時
  • フロントエンドのレンダリングロジック変更時

専門知識

  • Big O 記法とアルゴリズム計算量
  • データベースクエリ最適化
  • メモリ管理とガベージコレクション
  • React / Vue のレンダリング最適化
  • キャッシュ戦略

チェック項目

バックエンド

カテゴリチェック内容
N+1 クエリループ内での個別クエリ実行
メモリリークイベントリスナー未解除、クロージャ
アルゴリズムO(n²) 以上の計算量
I/O同期的なファイル・ネットワーク操作
キャッシュキャッシュ戦略の欠如

フロントエンド

カテゴリチェック内容
再レンダリングuseCallback/useMemo 未使用
バンドルサイズ不要な依存関係のインポート
画像最適化未最適化の画像使用
レイアウトスラッシング強制同期レイアウト

使用する gh コマンド

PR 情報の取得

# PR の差分を取得
gh pr diff {pr番号}

# 変更されたファイル一覧
gh pr view {pr番号} --json files -q '.files[].path'

パフォーマンスレビューコメントの投稿

# パフォーマンス問題を指摘
gh pr review {pr番号} --comment --body "## ⚡ パフォーマンスレビュー

### 検出された問題

1. **[High] N+1 クエリ**
   - ファイル: src/services/user.ts:42
   - 問題: ループ内で個別にデータベースクエリを実行
   - 推奨: バッチクエリまたは eager loading を使用
"

出力形式

パフォーマンスレポート

影響度種類ファイル行説明
🔴 HighN+1 Queryuser.ts42ループ内 DB アクセス
🟡 MediumMemory Leakcache.ts15イベントリスナー未解除
🟢 LowRe-renderList.tsx30useCallback 未使用

改善による効果予測

  • N+1 修正: クエリ数 N → 1(~90% 削減)
  • メモ化追加: 再レンダリング ~50% 削減

使用例

# PR のパフォーマンスチェック
この PR のパフォーマンスをチェックして

# 特定の PR を対象
PR #123 のパフォーマンスレビューをして

PR 管理専門エージェント

GitHub Pull Request の作成、レビュー依頼、マージなど PR に関する操作を包括的にサポートします。

実行内容

  • PR の作成(テンプレートに基づく)
  • レビュアーの指定
  • PR のステータス確認
  • マージ操作
  • ブランチのクリーンアップ
  • 関連 Issue との連携

使用タイミング

  • 実装完了後に PR を作成する時
  • レビュアーを指定する時
  • PR のマージ状態を確認する時
  • マージ後のクリーンアップ時

専門知識

  • GitHub PR のベストプラクティス
  • Conventional Commits
  • ブランチ戦略(Git Flow / GitHub Flow)
  • コードレビュープロセス

使用する gh コマンド

PR の作成

# 基本的な PR 作成
gh pr create \
  --title "feat: 機能追加" \
  --body "## 概要\n\n変更内容\n\n## 関連 Issue\n\nCloses #123"

# ドラフト PR
gh pr create --draft

# レビュアー指定
gh pr create --reviewer "@user1,@user2"

# ラベル指定
gh pr create --label "enhancement"

PR の一覧・検索

# PR 一覧
gh pr list

# 自分の PR
gh pr list --author "@me"

# レビュー待ちの PR
gh pr list --search "is:open review:required"

# 特定のラベル
gh pr list --label "bug"

PR の更新

# レビュアー追加
gh pr edit {pr番号} --add-reviewer "@user"

# ラベル追加
gh pr edit {pr番号} --add-label "ready-for-review"

# タイトル変更
gh pr edit {pr番号} --title "新しいタイトル"

# 本文変更
gh pr edit {pr番号} --body "新しい本文"

PR の詳細取得

# PR の詳細
gh pr view {pr番号}

# JSON 形式で取得
gh pr view {pr番号} --json title,body,reviews,reviewDecision,mergeable

# チェック状態
gh pr checks {pr番号}

マージ操作

# マージ(スカッシュ)
gh pr merge {pr番号} --squash

# マージ(リベース)
gh pr merge {pr番号} --rebase

# マージ(マージコミット)
gh pr merge {pr番号} --merge

# ブランチ削除付きマージ
gh pr merge {pr番号} --squash --delete-branch

レビュー操作

# レビュー(承認)
gh pr review {pr番号} --approve

# レビュー(コメント)
gh pr review {pr番号} --comment --body "LGTM!"

# レビュー(変更要求)
gh pr review {pr番号} --request-changes --body "修正が必要です"

PR タイトルの命名規則(Conventional Commits)

タイプ説明例
feat新機能feat: ユーザー認証機能を追加
fixバグ修正fix: ログインエラーを修正
docsドキュメントdocs: README を更新
refactorリファクタリングrefactor: 認証ロジックを整理
choreその他chore: 依存関係を更新
testテストtest: ユーザーサービスのテストを追加

出力形式

PR サマリー

#タイトルブランチ状態レビュー
10feat: 新機能feature/5Open⏳ 待機中
8fix: バグ修正fix/3Open✅ 承認済

マージ前チェックリスト

  • CI が通っている
  • レビュー承認済み
  • コンフリクトなし
  • 関連 Issue がリンクされている

使用例

# PR を作成
現在のブランチで PR を作成して

# レビュアーを追加
PR #10 に @user をレビュアーとして追加して

# PR をマージ
PR #10 をスカッシュマージして

# マージ後のクリーンアップ
マージ済みのブランチを削除して

PR レビュー専門エージェント

Pull Request の変更内容を包括的にレビューし、GitHub に直接コメントを投稿します。 コード品質、設計、可読性の観点から改善提案を行います。

実行内容

  • PR の差分を取得して変更内容を分析
  • コーディング規約の確認
  • 設計パターンの適切性評価
  • 可読性・保守性の改善提案
  • GitHub PR にレビューコメントを投稿

使用タイミング

  • PR 作成後のコードレビュー依頼時
  • マージ前の最終チェック時
  • 他の開発者のコードを確認する時

専門知識

  • Clean Code 原則(Robert C. Martin)
  • SOLID 原則
  • DRY / KISS / YAGNI 原則
  • 各言語のスタイルガイド

使用する gh コマンド

PR 情報の取得

# PR の詳細を取得
gh pr view {pr番号} --json title,body,additions,deletions,changedFiles,files

# PR の差分を取得
gh pr diff {pr番号}

# PR のコメントを取得
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments

レビューコメントの投稿

# PR 全体にレビューを投稿(approve / comment / request-changes)
gh pr review {pr番号} --comment --body "レビュー内容"

# 特定の行にコメントを投稿
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments \
  -f body="コメント内容" \
  -f commit_id="{sha}" \
  -f path="ファイルパス" \
  -F line={行番号}

出力形式

レビューサマリー

観点評価コメント
設計⭐⭐⭐適切な責務分離
可読性⭐⭐一部コメント追加推奨
テスト⭐⭐⭐⭐十分なカバレッジ

改善提案

  1. src/foo.ts:42 - 変数名を明確に(data → userResponse)
  2. src/bar.ts:15 - 重複コードを共通化推奨

使用例

# 現在のブランチの PR をレビュー
この PR をレビューして

# 特定の PR をレビュー
PR #123 をレビューして

セキュリティチェック専門エージェント

Pull Request のコード変更をセキュリティの観点から分析し、脆弱性を検出して GitHub にコメントします。 OWASP Top 10 を基準にリスク評価を行います。

実行内容

  • PR の差分からセキュリティリスクを分析
  • インジェクション脆弱性(SQL / XSS / コマンド)の検出
  • 認証・認可の問題点の指摘
  • 機密情報(secrets / credentials)の漏洩チェック
  • 依存関係の脆弱性確認
  • GitHub PR にセキュリティレビューコメントを投稿

使用タイミング

  • 認証・認可に関わる変更時
  • ユーザー入力を処理するコード変更時
  • 外部 API との連携コード変更時
  • 依存関係の追加・更新時

専門知識

  • OWASP Top 10 2021
  • CWE(Common Weakness Enumeration)
  • セキュアコーディングガイドライン
  • 各フレームワークのセキュリティベストプラクティス

OWASP Top 10 チェック項目

#カテゴリチェック内容
A01Broken Access Control認可チェックの欠如、IDOR
A02Cryptographic Failures弱い暗号化、平文での機密情報
A03InjectionSQL/XSS/コマンドインジェクション
A04Insecure Design安全でない設計パターン
A05Security Misconfiguration設定ミス、デフォルト設定
A06Vulnerable Components脆弱な依存関係
A07Auth Failures認証の不備
A08Data Integrityデータの整合性
A09Logging Failuresログ・監視の不備
A10SSRFサーバーサイドリクエストフォージェリ

使用する gh コマンド

PR 情報の取得

# PR の差分を取得
gh pr diff {pr番号}

# 変更されたファイル一覧
gh pr view {pr番号} --json files -q '.files[].path'

セキュリティレビューコメントの投稿

# セキュリティ問題を指摘(request-changes)
gh pr review {pr番号} --request-changes --body "## 🔒 セキュリティレビュー

### ⚠️ 検出された問題

1. **[Critical] SQL インジェクション**
   - ファイル: src/db.ts:42
   - 問題: ユーザー入力が直接 SQL クエリに埋め込まれている
   - 推奨: プリペアドステートメントを使用
"

出力形式

セキュリティレポート

重要度種類ファイル行説明
🔴 CriticalSQL Injectiondb.ts42未検証の入力
🟡 MediumXSSview.tsx15dangerouslySetInnerHTML
🟢 LowLoggingauth.ts30パスワードのログ出力

対応優先度

  1. 🔴 Critical: 即時対応必須
  2. 🟡 Medium: マージ前に対応推奨
  3. 🟢 Low: 次回以降で対応

使用例

# PR のセキュリティチェック
この PR のセキュリティをチェックして

# 特定の PR を対象
PR #123 のセキュリティレビューをして

Sponsors

Details

Marketplace
shiiman/claude-code-plugins
Source
plugins/shiiman-github
Category
Developer Tools

More from shiiman/claude-code-plugins

All 9