resolve-review

Files (5)

• SKILL.md
• check.sh
• fetch.sh
• minimize.sh
• resolve.sh

SKILL.md (first lines)

# PRレビュー指摘対応

PRのレビューコメントを取得し、未解決の指摘を分類・対応する。

## 入力

`$ARGUMENTS` に PR 番号とオプションフラグが渡される。

- PR 番号は省略可（現在のブランチから自動検出）
- `--bg` フラグ指定でバックグラウンド実行モードに切り替え

例

- `/resolve-review 20` → フォアグラウンド、PR番号 20
- `/resolve-review --bg` → バックグラウンド、PR番号は自動検出
- `/resolve-review 20 --bg` → バックグラウンド、PR番号 20

## モード判定

`$ARGUMENTS` に `--bg` が含まれるかどうかで実行モードを判定する。
`--bg` を除いた残りの引数をスクリプトに渡す。

- `--bg` なし → フォアグラウンドモード（デフォルト）
- `--bg` あり → バックグラウンドモード

## フォアグラウンドモード（デフォルト）

### 1. CI ステータスの確認（オプション）

`bash ${CLAUDE_SKILL_DIR}/check.sh $SCRIPT_ARGS --watch` を実行する。
Bash tool の timeout パラメータは 600000（最大値）を指定する。

- `$SCRIPT_ARGS` が空の場合は引数なしで実行（スクリプト側で自動検出）
- status が "fail" → 失敗チェック名を記録し、後続の分類で参考にする
- status が "pass" → そのまま次のステップに進む
- タイムアウト（exit 2）→ その時点の状態を記録し、次のステップに進む
- エラー終了 → 無視して次のステップに進む（この手順はオプション）

### 2. ヘルパースクリプトの実行

`bash ${CLAUDE_SKILL_DIR}/fetch.sh $SCRIPT_ARGS` を実行する。

- `$SCRIPT_ARGS` が空の場合は引数なしで実行（スクリプト側で自動検出）
- スクリプトが非ゼロ終了した場合は、stderr のエラーメッセージをユーザーに報告して終了

### 3. 共通分析ステップへ

fetch.sh の出力を「共通分析ステップ」に従って処理する。

## バックグラウンドモード（--bg）

### 起動フェーズ

#### 1. CI ステータス確認の開始

`bash ${CLAUDE_SKILL_DIR}/check.sh $SCRIPT_ARGS --watch` を Bash tool の `run_in_background` パラメータを `true` にして実行する。

- `$SCRIPT_ARGS` が空の場合は引数なしで実行（スクリプト側で自動検出）

#### 2. ユーザーへの報告

以下を報告してスキルの実行を終了する。

- バックグラウンドで CI 待機を開始したこと
- 他のコマンドを実行可能であること
- 完了したら自動的に結果を処理すること（手動確認は `/check-bg`）

### 結果処理フェーズ

以下のいずれかの条件で結果処理フェーズを開始する。

1. ユーザーが結果確認を依頼した場合
2. メッセージに該当バックグラウンドタスクの system-reminder が含まれる場合

条件2の場合はまず BashOutput でステータスを確認し、まだ実行中であればユーザーのメッセージを優先して処理する（結果処理は行わない）。

#### 3. CI ステータスの取得

BashOutput ツールで check.sh の出力を確認する。

- まだ実行中の場合はステータスを報告し、再度確認を依頼するよう案内する
- 完了した場合は CI ステータスを記録する
  - status が "fail" → 失敗チェック名を記録し、後続の分類で参考にする
  - status が "pass" → そのまま次のステップに進む
  - タイムアウト（exit 2）→ その時点の状態を記録し、次のステップに進む
  - エラー終了 → 無視して次のステップに進む（この手順はオプション）

#### 4. ヘルパースクリプトの実行

`bash ${CLAUDE_SKILL_DIR}/fetch.sh $SCRIPT_ARGS` を実行する。

- `$SCRIPT_ARGS` が空の場合は引数なしで実行（スクリプト側で自動検出）
- スクリプトが非ゼロ終了した場合は、stderr のエラーメッセージをユーザーに報告して終了

#### 5. 共通分析ステップへ

fetch.sh の出力を「共通分析ステップ」に従って処理する。

## 共通分析ステップ

### 出力の解析

スクリプトの stdout は JSON 形式で以下のフィールドを含む。

- `pr_number` - PR番号
- `title` - PRタイトル
- `url` - PR URL
- `review_threads` - レビュースレッドの配列
  - `id` - スレッドID
  - `is_resolved` - 解決済みかどうか
  - `is_outdated` - コード変更により古くなったかどうか
  - `comments` - コメント配列（最初のコメントがレビュー指摘、以降が議論）
    - `body` - コメント本文
    - `author` - コメント投稿者
    - `created_at` - 投稿日時
    - `path` - 対象ファイルパス
    - `line` - 対象行番号
    - `diff_hunk` - 差分コンテキスト
- `reviews` - サマリー本文付きレビューの配列（`PENDING` と空 body は除外済み）

From rysk-tanaka/skills, MIT.

More from rysk-tanaka/skills