---
session: S03
exercise: A-4
title: 実行サマリーの出方を確認する
duration: 7min
difficulty: 2
prerequisite: [A-3]
phases:
  依頼: 2min
  読む: 3min
  照合: 2min
files_to_edit:
  - kadaiA/index.html  # AI に更新させます
  - memo.md            # ## A-4 にサマリーを貼り付けます
hints: hints/step04_pipeline.md
challenge: true
tags: [実行サマリー, 照合, レビュー]
---

# 演習 A-4: 実行サマリーの出方を確認する

AI が「何をしたか」を毎回自己申告する状態を体験します。作業のログが応答に残ると、確認の手間がどう変わるかを見ます。

| 項目 | 内容 |
|---|---|
| 所要 | 7分 |
| 触るフォルダ | `kadaiA/` |
| 生成物 | 更新された `kadaiA/index.html` と、`memo.md` の `## A-4` |
| 終わったと言える状態 | サマリーの記載と実ファイルの変更が一致していることを確認できた |

---

## 目的

AI の作業を人間が追える形で受け取ることの効果を確かめます。

コードレビューで一番手間がかかるのは、変更内容を読むことではなく「どこが変わったかを探すこと」です。AI に作業させると、この探す作業が毎回発生します。応答の末尾に「どのファイルに何をしたか」が出ていれば、探す時間がなくなります。

ここではもう1つ、書かれていることと実際が一致しているかを自分で確かめます。自己申告は便利ですが、鵜呑みにする前に1回は照合してください。1回照合すると、どの欄が信用できて、どの欄を毎回見るべきかの感覚がつかめます。

---

## 操作

### 1. 機能を1つ追加させる

`@kadaiA/index.html` に対して、在庫が少ない備品の行を目立たせる表示を足してもらいます。伝える条件は次の2つです。

- 対象は在庫が **5個以下** の備品（5個ちょうども含みます）
- 一覧を見たときに、その行が他と違って見えること

見せ方は指定しません。背景色でも、文字色でも、印を付けるのでも構いません。AI が選んだ見せ方を見てから、気に入らなければ次の指示で変えられます。

「5個以下」に5を含めるかどうかを明示しているのは、ここが取り違えやすい箇所だからです。課題Bの業務ルールでも同じ論点が出てきます。

### 2. 応答のいちばん下を読む

応答の末尾に「実行サマリー」というブロックが出ています。次の4項目を上から順に読んでください。

| 欄 | 何が書かれているか | どう使うか |
|---|---|---|
| 動作 | 読み取り・編集・新規作成・コマンド実行を何回ずつ行ったか | 想定より数が多ければ、頼んでいない作業が混ざっている合図 |
| 従った設定 | `CLAUDE.md` のどの見出し、どの Skill、どのコマンドに従ったか | 見出し名が書いてあるので、その箇所を開いて照合できる |
| 対象ファイル | どのパスに何をしたか | 変更箇所を探さずに開ける |
| 未実施・保留 | 頼まれたが今回やらなかったこと | 人間が判断すべき残件がここに出る |

「従った設定」の欄には、`## 出力の作法` のように `CLAUDE.md` の見出し名がそのまま書かれているはずです。書かれていたら、実際に `CLAUDE.md` を開いてその見出しを探してください。設定と応答が1対1でつながっていることが目で見えます。

### 3. 書かれているとおりか照合する

サマリーの「対象ファイル」に挙がっているファイルを開き、書かれているとおりの変更が入っているかを目で確かめます。

見るのは2点です。挙がっているファイルが実際に変わっているか。そして、挙がっていないファイルが変わっていないか。VSCode のエクスプローラでは、変更のあったファイルに印が付くわけではないため、気になる場合はファイルの更新日時を見てください。

### 4. ブラウザで確認する

ブラウザを再読み込みして、在庫の少ない備品の行が目立っているかを確認します。`dummy_data.csv` の中で在庫5個以下の備品は **4件** です。目立っている行が4件あれば、条件の解釈も表示も合っています。

3件しかない場合は、5個ちょうどの備品が対象から外れています。境目の取り違えです。「5個ちょうども含めてください」と伝えて直してもらってください。

### 5. サマリーを `memo.md` に貼る

出てきた実行サマリーの中身を、`memo.md` の `## A-4` にそのまま貼り付けます。A-6 の比較で、ハーネスを入れる前後の応答の違いを説明する材料になります。

---

## 自分で考える

サマリーの「未実施・保留」に何か書かれていましたか。

書かれていた場合、それは AI の判断で今回やらなかったことです。省いてよかったものでしたか。それとも、頼んだつもりだったのに落ちていたものでしたか。

「なし」と書かれていた場合も1つ考えてみてください。本当に残件はゼロでしょうか。たとえば、在庫のしきい値である5という数字は、いまコードのどこに書かれているでしょうか。直書きされているとしたら、しきい値を変えたい人はコードを探すことになります。これは残件と呼べる状態かもしれません。

判断したことを1行、`memo.md` に書いてください。

---

## 生成物の名前と場所

- `handson/kadaiA/index.html`（更新）
- `handson/memo.md` の `## A-4`（実行サマリーの貼り付けと、気づいたこと1行）

---

## OK基準

1. 応答の末尾に実行サマリーの4項目（動作／従った設定／対象ファイル／未実施・保留）がすべて出ている
2. サマリーの「対象ファイル」に書かれたファイルと、実際に変更されたファイルが一致している
3. ブラウザで、在庫5個以下の **4件** が他の行と区別できる表示になっている
4. `memo.md` の `## A-4` にサマリーを貼り付けた

---

## 追加と考察

A-1 のときの応答には、このサマリーは出ていませんでした。出るようになったのは、`CLAUDE.md` の末尾に `## 応答の最後に必ず出すもの` という節が1つあるからです。

`CLAUDE.md` を開いて、その節を読んでみてください。書かれているのは日本語の指示文です。プログラムではありません。「出力位置は応答の最終行に固定します」「読み取りだけの依頼でも出してください」といった決めごとが並んでいます。

読み取りだけでも出させているのには理由があります。出たり出なかったりすると、出なかったときに「壊れたのか、そういう仕様なのか」がわからなくなります。毎回出ると決めておけば、出ないこと自体が異常の合図になります。

設定ファイルの1節で、AI の振る舞いをここまで変えられます。逆に言えば、書いていないことは変わりません。

---

## 発展課題

実行サマリーに、あなたの仕事で欲しい項目を1つ足すとしたら何ですか。

例を挙げます。「参照した外部情報の一覧」「変更前の状態に戻す方法」「この変更で影響を受けそうな他のファイル」。自分の職場のレビューで毎回聞かれることを思い出すと出てきます。

決まったら `CLAUDE.md` の `## 応答の最後に必ず出すもの` を書き換えて、実際にその項目が出るか試してください。書き換えたあとはパネルを開き直します。

出なかった場合、書き方に問題があります。何を書けば出るようになるかを2通り試して、違いを `memo.md` に書いてください。ここでの試行錯誤が、そのまま「AI に指示を届ける書き方」の練習になります。

なお、この演習で書き換えた `CLAUDE.md` は元に戻さなくて構いません。A-5 の点検には影響しません。

在庫の表示そのものを深めたい場合は `exercises/challenges/ch02_low_stock_highlight.md` に進んでください。しきい値を画面から変えられるようにする課題です。

---

## うまくいかないとき

**サマリーが出ない、または途中で切れる**

まずパネルを開き直してください。それでも出ない場合は `CLAUDE.md` の末尾を確認します。`## 応答の最後に必ず出すもの` の節がそのまま残っているかを見てください。A-3 の発展課題で書き換えた場合、書式が崩れていることがあります。`_harness_kit/step1_kadaiA/CLAUDE.md` からコピーし直せば元に戻ります。

**サマリーは出るが「従った設定」がいつも同じ**

依頼の内容が変わっても同じ見出しが並ぶことはあります。読み取りだけの依頼なら `## フォルダ構成` だけ、コードを書き換える依頼なら `## コーディング規約` が加わる、といった違いが出ているかを見てください。まったく変わらない場合は、「今回の依頼で実際に参照した見出しだけを書いてください」と一言添えます。

**目立つ行が4件より多い、または少ない**

多い場合は条件が「10個以下」などになっていないかを確認します。少ない場合は境目の取り違えです。どちらも、いま画面に出ている件数を伝えて「在庫5個以下の4件が対象です」と直してもらいます。件数で伝えるのが一番速い指摘の仕方です。

**サマリーに書かれていないファイルが変更されていた**

その旨をそのまま AI に伝えてください。「サマリーに `kadaiA/style.css` が載っていませんが、更新されています」と伝えると、書き漏らしか、意図的に省いたかが返ってきます。自己申告を1回検算する経験として、むしろ良い状態です。`memo.md` に記録しておいてください。

**表示は変わったが、元の一覧が壊れた**

件数を数えてください。50件が出ていれば表示だけの問題です。50件でなければ、データの読み込みに手が入っています。「一覧は50件のまま、表示だけを変えてください」と伝えて直します。

---

## 次のステップ

[A-5 コマンド一つでパイプラインを回す](exA5_pipeline.md) に進みます。演習Aの山場です。コマンド1本で、点検から修正、報告書までを回します。
