drillan/respond-review

/respond-review

hachimoku JSONL出力を読み取り、レビュー指摘に対応する。

Usage

/respond-review [PR_NUMBER]
/respond-review --diff

Arguments

| Argument | Type | Required | Description | |----------|------|----------|-------------| | PR_NUMBER | integer | No | GitHub PR番号（省略時は現在のブランチから検出） | | --diff | flag | No | diff型のレビュー結果を読み取る |

Instructions

When the user invokes /respond-review, follow these steps:

Step 1: Review File Detection

Determine the JSONL file path based on arguments:

Case 1: --diff が指定された場合

cat .hachimoku/reviews/diff.jsonl

Case 2: PR番号が指定された場合

cat .hachimoku/reviews/pr-{NUMBER}.jsonl

Case 3: 引数なし（PR番号を自動検出）

gh pr list --head "$(git branch --show-current)" --state open --json number --jq '.[0].number'

検出されたPR番号で .hachimoku/reviews/pr-{NUMBER}.jsonl を読み取る。

エラーハンドリング:

PRが検出できない場合:

現在のブランチに紐づくPRが見つかりません。PR番号を指定するか --diff を使用してください。

ファイルが存在しない場合:

レビュー結果が見つかりません。
  PR型: `8moku {NUMBER}` を実行してください
  diff型: `8moku` を実行してください

Step 2: Parse JSONL

JSONL ファイルの各行は 1つのレビューセッション を表す JSON オブジェクトです。

JSONL 構造

{
  "review_mode": "diff" | "pr",
  "commit_hash": "40文字の16進数",
  "branch_name": "ブランチ名",
  "reviewed_at": "ISO 8601 タイムスタンプ",
  "results": [
    {
      "status": "success" | "error",
      "agent_name": "エージェント名",
      "issues": [
        {
          "agent_name": "エージェント名",
          "severity": "Critical" | "Important" | "Suggestion" | "Nitpick",
          "description": "指摘内容",
          "location": {"file_path": "ファイルパス", "line_number": 行番号} | null,
          "suggestion": "修正提案" | null,
          "category": "カテゴリ名" | null
        }
      ],
      "elapsed_time": 秒数
    }
  ],
  "summary": {
    "total_issues": 指摘数,
    "max_severity": "最大重要度" | null
  }
}

パース手順

1. 各行を JSON としてパースする
2. 最新のレビューセッション（最終行）を使用する
3. results[] 配列の各エージェント結果を確認:
   • status: "success" のエージェントから issues[] を収集
   • status: "error" のエージェントはスキップし、警告を表示:

     エージェント "{agent_name}" はエラーで終了しました: {error_message}
     

4. 全エージェントの issues[] をフラット化して1つのリストにまとめる

パースに失敗した場合:

レビュー結果ファイルの解析に失敗しました

Step 3: Display Review Table

指摘を重要度順にソートして表示する。

ソート順: Critical > Important > Suggestion > Nitpick

| # | Severity | Agent | File | Line | Description | Decision | |---|----------|-------|------|------|-------------|----------| | 1 | Critical | code-reviewer | path/file.py | 28 | Description | (pending) | | 2 | Important | type-analyzer | path/other.py | 42 | Description | (pending) | | 3 | Suggestion | code-reviewer | .gitignore | 228 | Description | (pending) | | 4 | Nitpick | code-reviewer | tasks.md | 334 | Description | (pending) |

ヘッダーに以下のメタデータを表示:

## Review Results

Mode: {review_mode} | Commit: {commit_hash の先頭7文字} | Date: {reviewed_at}
Total Issues: {summary.total_issues} | Max Severity: {summary.max_severity}

Step 4: Accept/Reject Decisions

各指摘について対応方針を決定する:

• Accept: 修正を実装する
• Reject: 理由を記録してスキップ

テーブルを更新:

| # | Severity | Agent | File | Line | Description | Decision | |---|----------|-------|------|------|-------------|----------| | 1 | Critical | code-reviewer | path/file.py | 28 | Description | Accept | | 2 | Important | type-analyzer | path/other.py | 42 | Description | Reject: cosmetic only |

Step 5: Implement Fixes

Accept した各指摘に対して:

1. 該当ファイルを読み込む
2. suggestion フィールドの内容を参考に修正を実装
3. 修正が正しいことを確認

Step 6: Commit Changes

全ての Accept した修正が完了したら:

1. 変更されたファイルをステージング
2. コミットメッセージを作成: fix: address hachimoku review feedback

Output Format

最終サマリー:

## Review Response Summary

Mode: {review_mode} | Commit: {commit_hash の先頭7文字}
Accepted: {COUNT} | Rejected: {COUNT}

| # | Decision | File | Action |
|---|----------|------|--------|
| 1 | Accept | path/file.py | Fixed: added error handling |
| 2 | Reject | .gitignore | Reason: cosmetic only |

Error Handling

| エラー | 対応 | |--------|------| | PR番号が検出できない | 現在のブランチに紐づくPRが見つかりません。PR番号を指定するか --diff を使用してください。 | | JSONLファイルが存在しない | レビュー結果が見つかりません。8moku <番号> または 8moku を実行してください | | JSONLの解析失敗 | レビュー結果ファイルの解析に失敗しました | | エージェントがエラー終了 | エージェント "{name}" はエラーで終了しました: {message} （他のエージェント結果は続行） | | 修正の適用失敗 | 失敗した修正を報告、他の修正は続行 |