# Wt Review

> マージ前レビューのために、自分の worktree ブランチの diff から同梱テンプレート + render.py でレビュー用 HTML を subagent に生成させ、ブラウザで開いてユーザーの承認を待つ。worktree 側の Claude Code セッションで /wt-merge の前に使う。「/wt-review」「レビューページを作って」のとき使う。

- Skill: `kawase1295/wt-review` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add kawase1295/wt-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kawase1295/wt-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: kawase1295 (https://skillmd.com/u/kawase1295)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kawase1295/wt-review

---


# /wt-review — マージ前にレビュー用ページを作って承認を待つ

**worktree 側のセッションで実行する**。cwd が本体 checkout（worktree でない）なら、worktree 側セッションで実行するよう案内して止まる。実行後は**ユーザーの承認を待つ** — 承認を得る前に /wt-merge へ進まない。

ページの体裁は `assets/` の固定資産（テンプレート + `render.py`）が持つ。**HTML をゼロから書かせない。**

## 手順

1. `git status --porcelain` で未コミット変更を確認する。あれば先にコミットする（レビュー対象を確定させるため。/wt-merge と同じ方針）。
2. レビュー対象を求める:

   ```bash
   MAIN="$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")"
   BASE="$(git -C "$MAIN" rev-parse HEAD)"
   git log --oneline "$BASE"..HEAD        # 取り込まれるコミット
   git diff "$BASE"...HEAD --stat         # 変更ファイル一覧
   ```

   コミットも diff も無ければ「レビューする変更がありません」と報告して止まる。コミットはあるが diff が空（net-zero）なら、HTML は作らずコミット一覧を報告して承認を仰ぐ。
3. 変更の要約を**自分で**書く（subagent はこのセッションの経緯を知らない）: 何を・なぜ変えたか、主要な設計判断、検討して採らなかった案、実行したテストと結果、未検証で残っていること。レビューページの価値の半分はこの要約にある。**日本語の素文でよい** — HTML に起こすのは subagent の仕事。
4. 出力パスを決める: `<scratchpad>/wt-review-<task>.html`。scratchpad はシステムプロンプト記載のセッション scratchpad ディレクトリ、task はブランチ名から `worktree-` を除いたもの。**パスは固定する** — 再レビュー時に同じファイルへ上書きされ、ブラウザの再読み込みだけで最新化される。
5. 生成資産の場所を求める。skill は plugin 経由と `install.sh` 経由で置き場所が違うので、存在する方を採る:

   ```bash
   ASSETS=""
   for d in \
     ${CLAUDE_PLUGIN_ROOT:+"$CLAUDE_PLUGIN_ROOT/skills/wt-review/assets"} \
     "$(dirname "$(command -v wt || echo /x)")/../skills/wt-review/assets" \
     "$HOME/.claude/skills/wt-review/assets"
   do
     [ -f "$d/render.py" ] && ASSETS="$(cd "$d" && pwd)" && break
   done
   echo "${ASSETS:-NOT_FOUND}"
   ```

   `NOT_FOUND` なら「レビューページの生成資産が見つからない。`install.sh` を再実行するか plugin を入れ直してください」と報告して止まる。**assets 無しで HTML を自作して代替しない。**
6. HTML 生成を general-purpose subagent に委任する（Agent tool、`run_in_background: false`）。diff 本文と HTML を main context に持ち込まないための委任なので、自分で生成しない。prompt に含めるもの:
   - worktree のパス（cwd）、`BASE` の SHA、`ASSETS` の絶対パス、出力パス（絶対パス）、scratchpad ディレクトリ
   - 手順 3 で書いた要約とテスト結果（**材料**。これを HTML 断片に起こすのが subagent の仕事）
   - 手順:
     1. `git diff <BASE>...HEAD > <scratchpad>/net.diff`
     2. `<ASSETS>/README.md` を読む（プレースホルダー契約と、断片で使えるクラス一覧）
     3. `<scratchpad>/summary.html` と `<scratchpad>/tests.html` を書く。**README に載っているクラスだけを使う**（独自クラスはスタイルが当たらない）。`<h2>` の節見出しは書かない（テンプレートが持っている）。アーキテクチャ・依存関係・データフローに関わる変更なら `<pre class="mermaid">` の図を添える
     4. 実行する:

        ```bash
        python3 "<ASSETS>/render.py" \
          --diff "<scratchpad>/net.diff" --out "<出力パス>" \
          --title "<タスク名>" --base "<BASE>" \
          --summary "<scratchpad>/summary.html" --tests "<scratchpad>/tests.html"
        ```

        巨大な生成物ファイル（lock ファイル等）が邪魔なら `--collapse <path>` を足す。既定では増減の合計が 200 行を超えるファイルが折りたたまれる
     5. 返すのは `render.py` の stdout（files / 増減行数 / ファイルごとの開閉 / バイト数）と、断片で強調した点の一行要約だけ。**HTML 本文や diff 本文は返さない**
   - 禁止事項: テンプレートを書き換えない / HTML を自作して `render.py` を迂回しない / Artifact tool で publish しない / `local-artifact` skill をロードしない（skeleton・テーマトグル・mermaid はテンプレートが内包しているため不要）
7. 配信してブラウザで開く。承認ボタンを出すために HTTP 配信を試し、駄目なら `file://` に落とす:

   ```bash
   URL="$(wt serve "<出力パス>" 2>&1 | grep -m1 '^http' || true)"
   if [ -n "$URL" ]; then wt browse "$URL"; else wt browse "<出力パス>"; fi
   printf 'served: %s\n' "${URL:-file:// (承認ボタン無し)}"
   ```

   `wt serve` は `127.0.0.1` の空きポートに使い捨て HTTP サーバを立て、`?token=...` 付きの URL を stdout に 1 行出す。ページの「承認してマージ」ボタンはこの URL で開いたときだけ出る（`file://` では隠れる）。herdr が使えない / `python3` が無い / 起動に失敗した場合は URL が空になるので、**エラーにせず** 従来どおり `file://` で開く。開く手段が無い環境では `wt browse` が失敗するので、そのときは URL かパスを報告してユーザーに開いてもらう。
8. 出力パス（配信できたなら URL）と要約、`render.py` の統計を報告してターンを終え、レビューを待つ。配信できたときは「ページの『承認してマージ』を押すか、修正指摘をこのまま返信してください」、`file://` のときは「承認なら /wt-merge に進みます。修正指摘はこのまま返信してください」と添える。

## レビュー後

- **指摘があれば**: 修正 → コミット → /wt-review を再実行する（同じパスに上書きされ、配信サーバは HTML をリクエストごとに読み直すため、ブラウザは再読み込みだけでよい）。`wt serve` は配信中なら同じ URL を返すので、手順 7 はそのまま再実行してよい。
- **承認されたら**: /wt-merge → /wt-clean に進む。ページのボタンから来る場合は「承認します。/wt-merge に進んでください」がユーザーの入力として届き、配信サーバはそこで終了する。承認はマージまでの承認として扱われるので、PR モードの /wt-merge は CI の完了を待って `gh pr merge` まで実行する。
- 承認前に片付けることになった場合も、`wt rm`（/wt-clean）が残った配信サーバを止める。手動で止めるなら `wt serve --stop`。

## 禁止事項

- ユーザーの承認を得る前に /wt-merge を実行しない。自己判断で承認扱いしない。
- **承認エンドポイントを自分で叩かない。** `POST /approve` はユーザーがボタンを押す経路のためだけにある。`curl` などで自分で POST するのは承認の自作自演であり、レビューゲートの無効化になる。
- **レビューページを Artifact tool で publish しない。** 業務コードの diff を claude.ai へ送ることになる。ローカルファイルのまま `wt browse` で開く。
- テンプレート（`assets/wt-review-template.html`）をレビューのたびに書き換えない。体裁の変更は repo への変更として別途行う。