GitHub操作を支援するスキル集(PRレビュー対応など)

version
1.0.0
GitHub stars
5

Install

/plugin install github@korosuke613

Run it inside Claude Code after adding the marketplace with /plugin marketplace add korosuke613/coding-agent-recipe.

Contents

Discovered from source

Skills 2

PR Respond

概要

GitHub Pull Requestのレビューコメントに対して、適切な判断と返信を行い、スレッドをresolveするまでの一連のワークフローをサポートするスキル。

重要: GitHub API直接呼び出しの禁止

以下のコマンドは絶対に使用しないこと:

# 禁止: gh api を直接使用
gh api /repos/{owner}/{repo}/pulls/{pr_number}/comments
gh api graphql -f query="..."
gh api /repos/{owner}/{repo}/pulls/comments/{comment_id}/replies -X POST

# 代わりに: 必ず ./scripts/ 配下のスクリプトを使用する
./scripts/get-review-comments.sh owner repo 123
./scripts/reply-to-comment.sh owner repo 123 comment_id "返信内容"

理由:

  • スクリプトはエラーハンドリング、入力検証、出力整形を含む
  • API仕様の変更時にスクリプトのみ修正すれば対応可能
  • 一貫した出力形式でワークフローの自動化が容易

利用可能なスクリプト

このスキルでは、./scripts/ 配下の以下のスクリプトを使用する:

スクリプト役割
parse-pr-url.shPR URLからowner/repo/pr_numberを抽出
get-review-comments.shレビューコメント一覧を取得
reply-to-comment.shコメントに返信を投稿
get-review-threads.shレビュースレッドID・状態を取得(GraphQL)
resolve-threads.shスレッドを一括resolve(GraphQL)

ワークフロー

Step 1: PR情報の取得

PR URLからリポジトリ情報を抽出する。

# PR URLをパース
./scripts/parse-pr-url.sh "https://github.com/owner/repo/pull/123"
# Output: {"owner": "owner", "repo": "repo", "pr_number": 123}

Step 2: レビューコメントの取得と確認

PRのレビューコメントを取得し、内容を確認する。

# 詳細なJSON形式で取得
./scripts/get-review-comments.sh owner repo 123

# 簡潔なサマリー形式で取得
./scripts/get-review-comments.sh owner repo 123 --format=summary

各コメントについて以下を確認:

  • コメントID
  • 対象ファイルと行番号
  • 指摘内容

Step 3: 対応判断

各レビューコメントについて、対応するかどうかを判断する。

対応すべきコメント
  • 明確なバグや問題点の指摘 → 修正してコミット
  • セキュリティ上の懸念 → 必ず対応
  • 具体的な改善提案(suggestion付き) → 基本的に採用
対応を検討すべきコメント

以下の基準で判断:

テストカバレッジの指摘

  • 内部関数でAPIモックが必要 → 費用対効果が低い、対応しない
  • 既存のロジックが十分テストされている → 対応不要の可能性
  • プロジェクト規模が小さい → 過剰品質になる可能性

エラーハンドリングの指摘

  • 関数内部と呼び出し側の両方で指摘 → 重複を避け、呼び出し側のみ対応
  • すでに別の箇所で対応済み → 対応済みであることを説明
判断の原則
  1. 重複を避ける: 同じエラーハンドリングを複数箇所に追加しない
  2. 費用対効果: テストの実装コストと効果を天秤にかける
  3. 実用性優先: 理想論より実用上の問題解決を優先

Step 4: 必要に応じてコードを修正

対応が必要なコメントについて、コードを修正してコミットする。

# 修正をコミット
git add <modified_files>
git commit -m "fix: <コミットメッセージ>

<修正内容の説明>

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

# リモートにpush
git push origin <branch_name>

Step 5: 各コメントに返信

すべてのレビューコメントに対して、返信を作成する。すべてのコメントに返信することが重要。

返信パターン

対応済みの場合:

修正しました (<commit_hash>)

<具体的な修正内容の説明>

対応しない場合:

この件は対応しません

**理由:**
- <理由1>
- <理由2>

<補足説明>

間接的に対応済みの場合:

対応済み (<commit_hash>)

コメント#X の修正で、<具体的な対応内容>。これにより<問題が解決した理由>。
返信の実行
# コメントに返信(コメントIDを使用)
./scripts/reply-to-comment.sh owner repo 123 <comment_id> "返信内容"

Step 6: レビュースレッドをresolve

すべてのコメントに返信したら、レビュースレッドをresolve状態にする。

# スレッド情報を取得
./scripts/get-review-threads.sh owner repo 123

# 未解決のスレッドのみ取得
./scripts/get-review-threads.sh owner repo 123 --unresolved-only

# スレッドをresolve(単一)
./scripts/resolve-threads.sh "PRRT_kwDOQ8GWfs5p4t_j"

# スレッドを一括resolve(複数)
./scripts/resolve-threads.sh "PRRT_kwDOQ8GWfs5p4t_e" "PRRT_kwDOQ8GWfs5p4t_h" "PRRT_kwDOQ8GWfs5p4t_j"

ベストプラクティス

返信の品質

  • 具体的に: 何を修正したか、なぜ対応しないかを明確に
  • コミットハッシュを含める: 修正内容を追跡可能にする
  • 敬意を持って: 対応しない場合も丁寧に理由を説明

効率的な対応

  1. 一度に全コメントを確認: 重複や関連性を把握
  2. 関連コメントをまとめて対応: 同じ修正で複数の指摘に対応できる場合
  3. 返信とresolveを同時に: 返信後すぐにresolveすることで漏れを防ぐ

判断の透明性

  • 対応しない理由は具体的に説明
  • プロジェクトの規模や状況を考慮
  • 実用上の問題がないことを明確に

参考資料

詳細なスクリプト使用例は references/github-api-examples.md を参照してください。

Review Actions Workflow

概要

GitHub Actionsワークフローファイル(.github/workflows/*.yml)をレビューし、以下の4つの観点から問題点を検出して改善提案を行うスキル。

実行方法

基本使用

ワークフローをレビューして
GitHub Actionsをチェック

オプション

オプション説明例
--securityセキュリティチェックのみ/review-actions-workflow --security
--performanceパフォーマンスチェックのみ/review-actions-workflow --performance
--best-practicesベストプラクティスチェックのみ/review-actions-workflow --best-practices
--maintainability保守性チェックのみ/review-actions-workflow --maintainability
--file <path>特定のファイルのみレビュー/review-actions-workflow --file ci.yml
--fix修正提案を詳細に表示/review-actions-workflow --fix

使用例

# 全観点でレビュー
ワークフローをレビューして

# セキュリティのみチェック
GitHub Actionsのセキュリティをチェックして

# 特定ファイルのレビュー
ci.ymlをレビューして

チェック観点

1. セキュリティ

セキュリティ上のリスクを検出し、対策を提案する。

チェック項目重要度説明
スクリプトインジェクション高ユーザー入力が安全に処理されているか
pull_request_target高フォークからのPRで安全に使用されているか
シークレット管理高シークレットが安全に扱われているか

Note: SHA固定、@main/@master参照、permissions最小化はlinterでチェック可能なため、このスキルではチェックしません。詳細はreferences/security-checks.mdを参照してください。

詳細: references/security-checks.md

2. ベストプラクティス

GitHub Actionsの効率的な使用パターンを確認する。

チェック項目説明重要度
キャッシュ活用setup-*のcacheオプション、actions/cacheの使用中
マトリックスビルド複数環境テストの効率化低
Reusable Workflowsワークフローの再利用機会中
Composite Actions共通ステップの切り出し機会低
case関数の活用**&&/`
bashのif文簡素化GitHub Actions式を使ったbashのif文をステップレベルif条件へ移動中

⚠️ 重要: case関数関連のチェックは必須です。以下の3パターンを必ず確認してください:

  1. GitHub Actions式での&&/||使用
  2. bashスクリプト内でGitHub Actions式(${{ }})を使った条件分岐
  3. bashスクリプト内の値分岐のみのif-else文

詳細: references/best-practices.md、references/technic-case-function.md

3. パフォーマンス

実行時間とリソース効率を最適化する。

チェック項目説明
並列実行ジョブ間の依存関係最適化
concurrency重複実行の制御
timeout-minutes適切なタイムアウト設定
checkout最適化fetch-depth、sparse-checkout
不要なステップ削除可能なステップの特定

詳細: references/performance-checks.md

4. 保守性・可読性

長期的なメンテナンスを容易にする。

チェック項目説明重要度
命名規則ジョブ・ステップの明確な名前中
環境変数管理マジックナンバーの排除低
ファイル分割適切な粒度での分割低
コメント複雑な処理の説明低
DRY原則重複の排除中
条件式の可読性**&&/`
bashのif文簡素化ステップレベルif条件への移動、case関数での値分岐簡素化中

詳細: references/maintainability-checks.md、references/technic-case-function.md

レポート出力フォーマット

サマリー

## ワークフローレビュー結果

### 対象ファイル
- .github/workflows/ci.yml
- .github/workflows/cd.yml

### サマリー
| 観点 | 問題数 | 重要度高 | 重要度中 | 重要度低 |
|------|--------|----------|----------|----------|
| セキュリティ | 3 | 2 | 1 | 0 |
| ベストプラクティス | 2 | 0 | 1 | 1 |
| パフォーマンス | 1 | 0 | 0 | 1 |
| 保守性 | 4 | 0 | 2 | 2 |
| **合計** | **10** | **2** | **4** | **4** |

詳細レポート

## 詳細

### セキュリティ

#### [高] スクリプトインジェクションのリスク (ci.yml:25)

**現状:**
```yaml
- run: echo "PR Title: ${{ github.event.pull_request.title }}"

推奨:

- run: echo "PR Title: $PR_TITLE"
  env:
    PR_TITLE: ${{ github.event.pull_request.title }}

理由: ユーザー入力を直接シェルコマンドに展開すると、任意のコードが実行される可能性があります。環境変数経由で渡すことで安全に処理できます。



## 実装の流れ

### 必須チェック項目

以下の全てのチェックを**必ず実行**してください。各チェックで問題が見つからなくても「なし」として記録し、レポートに反映させること。

> **Note:** 各チェックは`check-workflow.sh`スクリプトで自動実行されます。スクリプトの詳細は本ファイルと同じディレクトリにあります。

---

### Step 1: ワークフローファイルの検出と読み込み

!`bash "${CLAUDE_PLUGIN_ROOT}/skills/review-actions-workflow/scripts/check-workflow.sh" --list-files`

各ファイルをReadツールで読み込み、YAML構造を解析する。

---

### Step 2: セキュリティチェック(3項目必須)

!`bash "${CLAUDE_PLUGIN_ROOT}/skills/review-actions-workflow/scripts/check-workflow.sh" --security`

**チェック内容:**
1. スクリプトインジェクションリスクを検出
2. シークレットを直接echoしているパターンを検出
3. pull_request_targetとhead.sha参照の危険な組み合わせを検出

---

### Step 3: ベストプラクティスチェック(5項目必須)

!`bash "${CLAUDE_PLUGIN_ROOT}/skills/review-actions-workflow/scripts/check-workflow.sh" --best-practices`

**チェック内容:**
1. cache未使用のsetup-*を検出
2. Reusable workflow使用状況
3. 【重要】GitHub Actions式での&&/||使用を検出(case関数への置き換え候補)
4. 【重要】bashでGitHub Actions式を使ったif文を検出(ステップレベルif条件への移動候補)
5. 【重要】bash内の複数行runスクリプトのif文を検出(case関数への置き換え候補)

---

### Step 4: パフォーマンスチェック(4項目必須)

!`bash "${CLAUDE_PLUGIN_ROOT}/skills/review-actions-workflow/scripts/check-workflow.sh" --performance`

**チェック内容:**
1. concurrency未設定を検出
2. timeout-minutes未設定のジョブを検出
3. checkout最適化の確認
4. キャッシュの保存/復元の対応確認

---

### Step 5: 保守性チェック(5項目必須)

!`bash "${CLAUDE_PLUGIN_ROOT}/skills/review-actions-workflow/scripts/check-workflow.sh" --maintainability`

**チェック内容:**
1. name未設定のステップを検出
2. ハードコードされたバージョンを検出
3. @main/@master参照を検出(linter推奨だが参考情報として記録)
4. 【重要】case関数で改善可能な条件式を検出
5. 【重要】bashスクリプト内の値分岐if-else文を検出

---

### Step 6: case関数適用可能性の詳細確認(必須・最重要)

!`bash "${CLAUDE_PLUGIN_ROOT}/skills/review-actions-workflow/scripts/check-workflow.sh" --case-function`

**⚠️ このステップは特に重要です。必ず実行してください。**

case関数は以下の3つのパターンで改善効果があります:

#### パターン1: GitHub Actions式での三項演算子風記述

```yaml
# 改善前
run: echo ${{ github.event_name == 'push' && 'production' || 'staging' }}

# 改善後(case関数で明示的に)
run: echo ${{ github.event_name == 'push' && 'production' || github.event_name == 'pull_request' && 'staging' || 'development' }}
パターン2: bashスクリプト内でGitHub Actions式を使った分岐
# 改善前
run: |
  if [[ "${{ github.ref }}" == "refs/heads/main" ]]; then
    echo "production"
  else
    echo "staging"
  fi

# 改善後(ステップレベルif + case関数)
パターン3: 値の分岐だけのif-else文
# 改善前
run: |
  if [[ "$ENV" == "production" ]]; then
    URL="https://example.com"
  elif [[ "$ENV" == "staging" ]]; then
    URL="https://staging.example.com"
  else
    URL="https://dev.example.com"
  fi

# 改善後(case関数)

この検出結果を基に、case関数での改善提案を必ずレポートに含めること。


Step 7: レポート生成

検出された全ての項目(問題なしも含む)をサマリーと詳細レポートにまとめる。

参考資料

使用タイミング

  • 新しいワークフローファイルを作成した後
  • ワークフローの修正・更新時
  • 定期的なセキュリティ監査
  • CI/CDパイプラインのパフォーマンス改善時
  • チームへのワークフロー引き継ぎ前

注意事項

  • このスキルはワークフローファイルの静的解析を行います
  • 実行時の動作やパフォーマンスは実測が必要です
  • セキュリティの問題は特に優先して対応してください
  • 修正提案は参考情報であり、プロジェクトの要件に合わせて判断してください

チェック漏れ防止のための注意事項

必須実行チェックリスト

レビュー時に以下の全項目を実行したことを確認してください:

セキュリティチェック(3項目)
  • スクリプトインジェクション検出
  • シークレット直接echo検出
  • pull_request_target危険パターン検出
ベストプラクティスチェック(5項目)
  • cache未使用検出
  • reusable workflow確認
  • 【重要】GitHub Actions式での&&/||検出
  • 【重要】bashでActions式を使ったif文検出
  • 【重要】bash内の値分岐if-else検出
パフォーマンスチェック(4項目)
  • concurrency未設定検出
  • timeout-minutes未設定検出
  • checkout最適化確認
  • キャッシュ保存/復元対応確認
保守性チェック(5項目)
  • name未設定ステップ検出
  • ハードコードバージョン検出
  • @main/@master参照検出
  • 【重要】case関数改善可能な条件式検出
  • 【重要】bash値分岐if-else詳細確認

特に注意: case関数関連チェック

case関数関連のチェックは3箇所で実施する必要があります:

  1. ベストプラクティスチェック(Step 3) - 項目3, 4, 5
  2. 保守性チェック(Step 5) - 項目4, 5
  3. case関数適用可能性の詳細確認(Step 6) ← これが最重要

Step 6を必ず実行し、3つのパターン全てを確認してください。

チェック実行時の注意

  • 各コマンドの実行結果は、問題が見つからなくても「なし」または「✓」として記録する
  • Step 6のcase関数チェックは省略禁止
  • レポートには全てのチェック項目の結果を含める(問題なしも含む)

Sponsors

Details

Marketplace
korosuke613/coding-agent-recipe
Source
claude-plugins/github
Author
korosuke613
Category
Productivity

More from korosuke613/coding-agent-recipe

All 6