# step04 実行サマリーと、コマンド一つで回るパイプライン

対応する演習ステップ: A-4 実行サマリーの出方を確認する [7min] ／ A-5 コマンド一つでパイプラインを回す [20min] ／ A-6 ハーネスの有無を比較する [10min]
対応する演習md: `exercises/exA4_exec_summary.md` ／ `exercises/exA5_pipeline.md` ／ `exercises/exA6_compare.md`
VSCode で開くフォルダ: `handson`

演習Aの山場です。ここは待ち時間が発生します。待っているあいだに何を見ておくかまで含めて書いています。

---

## 参考プロンプト

### A-4 実行サマリーを出させる

```
@kadaiA/index.html に、在庫が5個以下の備品の行を目立たせる表示を追加してください。
```

応答のいちばん下に「実行サマリー」が出ます。4項目（動作 / 従った設定 / 対象ファイル / 未実施・保留）を読んでから、書かれているファイルを実際に開いて照合します。

### A-5 パイプラインを回す

Claude Code パネルの入力欄に、次のとおり入力して送信します。引数を省略すると `kadaiA` が対象になります。

```
/selfcheck kadaiA
```

3分から5分かかります。終わったら `kadaiA/REPORT.md` を開きます。読んだあとで、中間データについて質問すると理解が早くなります。

```
@.work/02_findings.json の指摘を、深刻度別に何件ずつあるかで数えて、
そのうち @.work/03_fix_plan.md で「直す」と判断されたものが何件かを表にしてください。
```

### A-6 比較ファイルを作る

```
@memo.md の A-2 に書いた懸念点と、@kadaiA/REPORT.md の指摘・修正結果を突き合わせて、kadaiA/COMPARE.md を作ってください。
「素の状態で気づけたこと」「ハーネスを入れてから拾えたこと」「まだ誰も拾えていないこと」の3列の表にしてください。
```

## なぜその形か

A-4 の依頼は、わざと小さくしてあります。1ファイルへの表示の追加なので、サマリーの「対象ファイル」欄と実際の変更を目で照合できます。大きな依頼で試すと、サマリーが正しいかどうかを人間が確かめられません。**サマリーは信じるものではなく、照合に使うものです。** 照合できる大きさの仕事で試すのが先です。

A-5 の `/selfcheck` は、`.claude/commands/selfcheck.md` に書いてある手順書です。プログラムではなく日本語の文章で、開けば全部読めます。この手順書が、点検の観点（`docs/` の3つのチェックリストと `.claude/skills/kadaia-review/SKILL.md`）と、`memo.md` に書いたあなたの懸念を入力に取り、`.work/` に4つの中間データを残し、直して、直しきれたかを読み取り専用のサブエージェントで再点検し、`REPORT.md` にまとめます。人がやるとこの一連を毎回覚えていなければなりませんが、文章1本にしておけば全員が同じ順番で回せます。

中間データを4つに分けて残しているのは、途中を人が読めるようにするためです。結論だけ出てくると、納得できなかったときに確かめる先がありません。何を対象にしたか（`01_inventory.md`）、何を見つけたか（`02_findings.json`）、どれを直すと決めたか（`03_fix_plan.md`）、何周回ったか（`04_loop_log.md`）が分かれていれば、疑わしい箇所だけを開けます。

ループの上限は3周です。深刻度「高」が0件になった時点でも止まります。上限を置いているのは、直し続けさせると別の場所を壊し始めるからです。止める条件を先に決めておくのが、AI に反復作業をさせるときの基本の作りです。

A-6 で `memo.md` と `REPORT.md` を突き合わせるのは、この2つが別の時点の別の視点だからです。前者は素の状態で人間が気づいたこと、後者は文脈を渡した AI が観点に沿って拾ったこと。3列目に「まだ誰も拾えていないこと」を置いているのは、両方を足しても埋まらない領域があると示すためです。

参考リンク: スラッシュコマンドの仕組みは https://docs.claude.com/en/docs/claude-code/slash-commands 、サブエージェントは https://docs.claude.com/en/docs/claude-code/sub-agents に公式ドキュメントがあります。

## 比較観点

- A-1 の応答の末尾と、A-4 の応答の末尾。サマリーが付くようになったのは、`CLAUDE.md` の末尾に1節を書き足したからです。設定ファイルの1節が、毎回の出力の形を変えます。
- サマリーの「対象ファイル」と、実際に変わったファイル。一致していましたか。一致しない場合、それは AI の申告と事実がずれた瞬間で、レビューで最初に見るべき箇所です。
- 「未実施・保留」に何が書かれていましたか。空でない場合、AI が自分の判断で省いたものがあります。省いてよかったかどうかは人間が決めます。
- A-2 であなたが書いた5個と、`02_findings.json` の件数。増えた分は何を見て出てきたものですか。観点の一覧は `.claude/skills/kadaia-review/SKILL.md` にあります。
- `04_loop_log.md` の周回数。1周で止まった人と2周回った人がいます。差はどこから来ましたか。1周目の指摘件数が少なければ1周で止まります。
- 隣の受講者の `REPORT.md` と自分の `REPORT.md`。指摘の内容は違っても、見出しの構成は同じはずです。A-1 の時点では画面すら全員違いました。**同じ観点で見ると、出力の形がそろいます。** この差が、チームで使うときに効いてきます。

## よくある勘違い

- 「`/selfcheck` は Claude Code に元から入っているコマンド」。違います。`.claude/commands/selfcheck.md` を置いたから使えるようになりました。ファイル名がそのままコマンド名です。自分で1本書けば、自分のコマンドが増えます。
- 「指摘が多いほど良いパイプライン」。違います。深刻度の判断と、直す・直さないの仕分けが書けているかを見てください。全部を直そうとするパイプラインは、依頼していない機能追加まで始めます。
- 「`.work/` は消していい一時ファイル」。研修中は消さないでください。A-6 の比較と、講師の巡回確認に使います。
- 「AI が直したのだから動作確認は不要」。必要です。修正後にブラウザを再読込して、一覧・検索・詳細が動くことを自分で確かめてください。OK基準に入っています。
- 「`REPORT.md` の第5節（人間に判断してほしいこと）が空でも問題ない」。手順書では必ず1件以上書かせています。空の場合は、パイプラインが最後まで回りきっていない可能性があります。
- 「`COMPARE.md` は AI が作ったので完成」。3列目に自分の手で1行足し、`## 自分の職場に持ち帰るなら` を書いて初めて完成です。ここが研修後にいちばん残る部分です。

## 次のアクション

1. `.work/` に4ファイルそろっているか、エクスプローラで数えます。`01_inventory.md` / `02_findings.json` / `03_fix_plan.md` / `04_loop_log.md` の4つです。
2. `REPORT.md` の第5節を読み、自分ならどちらの選択肢を採るかを決めます。決めた理由を `memo.md` に1行残してください。S05 の振り返りでそのまま使えます。
3. 時間が余ったら `.claude/skills/kadaia-review/SKILL.md` の観点リストに、自分の職場でレビューされる観点を1行足して、もう一度 `/selfcheck kadaiA` を回してください。指摘が増えるかどうかで、観点の書き方の効き方がわかります。
4. 演習Aはここで終わりです。次は B-0 です。参考プロンプトは `step05_comment_insert.md` にあります。

うまくいかないときは次を確認してください。

- `/selfcheck` が候補に出てこない: `.claude/commands/selfcheck.md` が `handson` 直下の `.claude` にありますか。パネルを開き直しましたか。
- 途中で止まったように見える: `.work/` のファイルが増えているかを見てください。増えていれば動いています。5分を超えて何も増えないときは挙手してください。
- 修正でアプリが壊れた: `直前の修正でブラウザの表示が壊れました。@kadaiA/index.html を確認して、壊れた箇所だけを直してください。` と伝えます。作り直させないでください。
- `REPORT.md` が生成されない: `.work/` の中間データが残っていれば、`@.work/ の中間データをもとに kadaiA/REPORT.md を作ってください。` で作り直せます。
