maro114510 pr-lessons
PR レビュー教訓まとめ。責務の分担：
| 担当 | 処理内容 |
|---|---|
scripts/fetch-pr-reviews.sh |
データ収集（決定論的: gh 呼び出し・jq 変換） |
references/batch-agent-prompt.md |
バッチ分析 Agent へのプロンプトテンプレート |
references/summary-format.md |
最終 Markdown のフォーマット仕様 |
| この SKILL.md | 引数解釈・スクリプト起動・Agent 管理・統合判断 |
Step 0: スキルディレクトリの特定
以下を実行し、出力された 実パス文字列 を後続ステップで使う。
Read ツール・Bash コマンドともに、この Bash 出力に表示されるパスをそのまま使うこと（シェル変数名 $SKILL_DIR をそのまま Read に渡さない）。
# marketplace を優先（cache より新しいため）
SKILL_DIR=$(find ~/.claude/plugins/marketplaces -path "*/pr-lessons" -type d 2>/dev/null | head -1)
# marketplace になければ cache を探す（バージョン降順で最新を選ぶ）
[ -z "$SKILL_DIR" ] && \
SKILL_DIR=$(find ~/.claude/plugins/cache -path "*/pr-lessons" -type d 2>/dev/null \
| sort -rV | head -1)
# それでもなければ git リポジトリ内を探す
[ -z "$SKILL_DIR" ] && \
SKILL_DIR=$(find "$(git rev-parse --show-toplevel 2>/dev/null || echo .)" \
-path "*/pr-lessons" -type d 2>/dev/null | head -1)
# 取得できなければ即停止
if [ -z "$SKILL_DIR" ]; then
echo "ERROR: pr-lessons スキルディレクトリが見つかりません。"
echo "確認: claude plugin list | grep pr-lessons"
exit 1
fi
echo "SKILL_DIR: $SKILL_DIR"
上記の出力例: SKILL_DIR: /Users/xxx/.claude/plugins/marketplaces/maro114510-agent-skills/skills/pr-lessons
この実パスを以降のすべての Read・Bash で使う。
Step 1: 引数のパースとデフォルト値の決定
$ARGUMENTS から以下を解析する：
| 引数パターン | 例 | 意味 |
|---|---|---|
repo <owner/repo> |
repo myorg/myapp |
対象リポジトリを明示指定 |
since <YYYY-MM-DD> |
since 2025-02-01 |
取得開始日を明示指定 |
| 省略 | — | 下記デフォルト値を使用 |
# リポジトリ: git remote から自動判定（SSH/HTTPS 両対応）
git remote get-url origin \
| sed 's|.*github.com[:/]\(.*\)\.git|\1|' \
| sed 's|.*github.com[:/]\(.*\)|\1|'
# 取得開始日: 今日から 90 日前（macOS / Linux 自動判定）
date -v-90d +%Y-%m-%d 2>/dev/null || date -d '90 days ago' +%Y-%m-%d
リポジトリが特定できない場合はユーザーに repo <owner/repo> を指定するよう案内して停止する。
Step 2: データ収集
bash "$SKILL_DIR/scripts/fetch-pr-reviews.sh" "<owner/repo>" "<since>"
終了コードに応じた処理：
| 終了コード | 意味 | 対応 |
|---|---|---|
| 0 | 成功 | Step 3 へ |
| 1 | 期間内に自分の PR が 0 件 | 期間拡大を提案して停止 |
| 2 | 全 PR がスキップ（レビューなし） | skipped.json を Read してスキップ一覧を報告して停止 |
| 3 | 引数不足 / gh 認証エラー | エラーメッセージを報告して停止 |
成功後に /tmp/pr-lessons/summary.json を Read してリポジトリ・期間・件数を確認する。
Step 3: バッチ分割と並列 Agent 分析
/tmp/pr-lessons/raw/pr-*.json を確認し、ファイル名の数値順でソートして 15 件ずつのバッチに分割する（端数は最終バッチにまとめる）。
$SKILL_DIR/references/batch-agent-prompt.md を Read してプロンプトテンプレートを取得し、
対象ファイルパスとバッチ番号を差し替えて各 Agent に渡す。
並列で全 Agent を同時に起動する。単一メッセージ内で全バッチの Agent 呼び出しを並べること。
Step 4: 全バッチの統合
$SKILL_DIR/references/summary-format.md を Read してフォーマット仕様を確認する。
全 /tmp/pr-lessons/batch-*.md を Read で読み込み、フォーマット仕様に従って統合し、
カレントディレクトリの lessons-summary.md に Write で保存する。