Document Review — ターン上限に達して失敗する問題

[gn-t-k]

パッケージ / 対象

.github/workflows/document-review.yml

問題

--max-turns 10 の設定により、複雑なPRの場合にターン上限に達してDocument Reviewが失敗する。

Claudeが diff 取得 → ドキュメント読み込み（最大6カテゴリ）→ コメント投稿と多くのターンを消費するため、10ターンでは足りないケースがある。

修正内容

前処理ステップでコンテキスト（diff、関連ドキュメント）を事前収集し、Claudeのプロンプトに含めることで、Claudeのターン消費を2ターン程度に削減する。

対象ファイル

• .github/workflows/document-review.yml

検証方法

• 実際のPRでワークフローが正常動作することを確認

[gn-t-k]

@claude これプルリク作って

[claude]

Claude finished @gn-t-k's task in 2m 2s —— View job

---

タスク一覧

• コンテキスト収集・リクエスト分析
• 現在のワークフローファイルを確認
• 修正内容を実装（ローカルコミット済み）
• プッシュ試行（権限エラーのため失敗）
• 手動適用用のdiffを提示

---

結果

.github/workflows/ ファイルへの変更はGitHub Appの権限制約（workflows 権限が必要）により、プッシュができませんでした。

詳細: FAQ

---

実装した変更内容

以下のdiffを手動で適用してください：

--- a/.github/workflows/document-review.yml
+++ b/.github/workflows/document-review.yml
@@ -19,12 +19,42 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: レビュー用コンテキスト収集
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          {
+            echo "# PRレビュー用コンテキスト"
+            echo ""
+            echo "## PR情報"
+            echo ""
+            echo "PR番号: ${{ github.event.pull_request.number }}"
+            echo "タイトル: ${{ github.event.pull_request.title }}"
+            echo ""
+            echo "## PRのdiff"
+            echo ""
+            echo '```diff'
+            gh pr diff ${{ github.event.pull_request.number }}
+            echo '```'
+            echo ""
+            echo "## ドキュメント"
+            echo ""
+            for doc in CLAUDE.md .claude/rules/coding-style.md .claude/rules/error-handling.md .claude/rules/testing.md docs/architecture-decision-record/overview.md docs/project/overview.md; do
+              if [ -f "$doc" ]; then
+                echo "### $doc"
+                echo ""
+                cat "$doc"
+                echo ""
+              fi
+            done
+          } > REVIEW_CONTEXT.md
+
       - uses: anthropics/claude-code-action@edd85d61533cbba7b57ed0ca4af1750b1fdfd3c4 # v1
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           allowed_bots: "next-lift-merge-master"
           prompt: |
-            このPRの変更内容を分析し、ドキュメント更新漏れがないかチェックしてください。
+            `REVIEW_CONTEXT.md` にPRのdiffと関連ドキュメントが用意されています。このファイルを読み込み、ドキュメント更新漏れがないかチェックしてください。
 
             ## チェック対象ドキュメント

           claude_args: |
-            --max-turns 10
+            --max-turns 3
             --allowedTools Bash

変更のポイント

1. 前処理ステップ追加: gh pr diff でdiffを取得し、主要ドキュメント（CLAUDE.md、.claude/rules/*.md、overview.md等）の内容をREVIEW_CONTEXT.mdに事前収集
2. プロンプト変更: Claudeに「REVIEW_CONTEXT.mdを読み込んで分析する」よう指示（ファイル読み込み自体は1ターンで完了）
3. --max-turns 3に変更: ファイル読み込み(1ターン) + コメント投稿(1ターン) = 2ターン、余裕を持って3に設定