drillan /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
}
}
パース手順
- 各行を JSON としてパースする
- 最新のレビューセッション（最終行）を使用する
results[]配列の各エージェント結果を確認:status: "success"のエージェントからissues[]を収集status: "error"のエージェントはスキップし、警告を表示:エージェント "{agent_name}" はエラーで終了しました: {error_message}
- 全エージェントの
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 した各指摘に対して:
- 該当ファイルを読み込む
suggestionフィールドの内容を参考に修正を実装- 修正が正しいことを確認
Step 6: Commit Changes
全ての Accept した修正が完了したら:
- 変更されたファイルをステージング
- コミットメッセージを作成:
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} （他のエージェント結果は続行） |
| 修正の適用失敗 | 失敗した修正を報告、他の修正は続行 |