HANDS-ON

ハンズオンガイド
1件の処理をループに組み替える

架空の社内ヘルプデスクに届いた問い合わせ5件を、一次回答のループで順に処理します。ハーネスは完成した状態で配布し、今夜さわるのはループの設計書の空欄だけです。打ち込む依頼文と、講師の環境で返ってきた結果をStepごとに載せていますので、手元で動かせない方も読むだけで追えます。

2026年11月26日(木)
ハンズオン [40min]
オンライン ZOOM ウェビナー
講師 安田 光喜(Givery)
このガイドの流れ
前日まで

配布データと参加の3段階

ZIPを展開し、TYPE A、B、Cのどれで参加するかを決めます。

[5min]

Step 1 環境設定と構成の把握

フォルダを開き、ループの設計書の5項目を確かめます。

[6min]

Step 2 1件を手で通す

問い合わせ1件に一次回答を作り、検証スクリプトに通します。

[4min]

Step 3 止め方のないループ

停止条件が空欄のまま起動を頼み、断られることを確かめます。

[7min]

Step 4 停止条件を書く

件数と差し戻しの上限、2回落ちたら人を呼ぶ条件を書き込みます。

[12min]

Step 5 ループを回す

ループを2回まわし、完了、人を呼ぶ、持ち越しの3つの結果を確かめます。

[6min]

Step 6 記録を読み返す

AIの記録と仕組みの記録を突き合わせ、設計書の改善案を1つ出させます。

開催後

持ち帰るものとFAQ

自分の業務のループ設計書と、毎朝決まった時刻に起動する例です。

BEFORE ・ 前日まで

配布データと参加の3段階

配布データは20261126_handson.zip(Windows用)と20261126_handson_Mac.zip(Mac用)の2本です。中身は同じで、展開するとloop-kitというフォルダが1つできます。

01 参加の3段階

段階使うもの今夜できること
TYPE AClaude CodeStep 1からStep 6まで手元で動かせます。検証スクリプトとフックの記録も残ります
TYPE BGitHub Copilot同じフォルダで、copilot/prompts.mdの依頼文を送ります。検証スクリプトは動き、フックの部分は講師の投影で見ます
TYPE Cなし投影と、このページに載せた結果を読み比べます。Step 4の設計書だけは手元のエディタで書けます

準備の手順は事前セットアップガイドにあります。

02 フォルダの中身

loop-kit/
  CLAUDE.md      起動時に自動で読まれる規約
  loop/LOOP.md   今夜さわる場所。ループ設計書
  .claude/       ループのSkill、フック、権限設定(完成済み)
  context/       ハーネス。用語集、台帳、判断ルール、回答の様式(完成済み)
  checks/        検証スクリプト。結果を logs/ に書き足す
  hooks/         承認ゲートと、書き込みの記録
  inbox/         架空の問い合わせ5件
  work/          回答の下書き
  out/           検証に通った回答
  needs-human/   人の判断が要る回答案と理由
  state/         処理済みの問い合わせの一覧
  logs/          仕組みが書く記録(AIには編集させない)
  schedule/      持ち帰り用。毎朝決まった時刻に起動する例
  my-loop/       持ち帰り用。自分の業務のループ設計書と、設計チェックリスト
  copilot/       GitHub Copilotへの読み替え版
  hints/         90秒以上詰まったら1ファイルだけ開く
  solutions/     完成版。リカバリ専用
  docs/          講師の環境で実行したときの記録
STEP 01 ・ [5min]

環境設定と構成の把握

このStepが終わると、VS Codeでloop-kitが開き、AIがループの設計書の5項目を説明できる状態になります。

TYPE A 下の操作をそのまま行ってください。TYPE B 3の前に、copilot/README.mdの手順で.github/copilot-instructions.mdを置きます。TYPE C loop/LOOP.mdをエディタで開けば、同じ5項目を読めます。

01 操作

1
フォルダを開く

VS Codeの「ファイル」から「フォルダーを開く」を選び、loop-kitそのものを開いてください。1つ上のフォルダを開くと、CLAUDE.mdと.claude/が読まれません。

2
実行の許可を与える(Macの方だけ)

VS Codeのターミナルで、次を1回だけ実行してください。Windowsの方はREADME.mdの「Windowsの方へ」に従ってください。

chmod +x checks/check-reply.sh hooks/approval-gate.sh hooks/record-write.sh
3
設計書を説明させる

Claude Codeのパネルを開き、次の依頼文を送ってください。フォルダの信頼を尋ねる画面が出たら、信頼してください。

loop/LOOP.md を読んで、5つの項目がそれぞれ何を決めているかを1行ずつ説明してください。空欄になっている項目があれば教えてください。

02 成功したときの画面

5項目の説明と一緒に、「3. 停止条件」の2行と「5. 人を呼ぶ条件」の1行が空欄(TODO)だと返ってきます。この3か所を、Step 4で埋めます。

90秒で復帰する手順

AIがloop/LOOP.mdを見つけられない場合は、開いているフォルダがloop-kitそのものかを確かめてください。ほかはhints/step01_setup_hint.mdにあります。

STEP 02 ・ [6min]

1件を手で通す

このStepが終わると、out/101.mdに一次回答が1件でき、logs/loop-log.tsvに検証の結果が1行残ります。ループに載せる前に、ハーネスが1件を正しく通せるかを確かめるStepです。

TYPE A 下の依頼文を送ってください。TYPE B copilot/prompts.mdのStep 2の依頼文を、エージェントを選んでから送ります。TYPE C 下の結果を読めば、流れを追えます。

01 この操作の狙い

ループは、1件の処理を繰り返すだけの仕組みです。1件が正しく通らないままループに載せると、やり直しが件数分に増えます。先に1件を手で通し、検証スクリプトが何を見ているかを確かめます。

02 操作

1
問い合わせを30秒だけ眺める

inbox/ticket-101.mdを開いてください。勤怠システムにログインできないという、3行の依頼です。

2
1件だけ処理させる

次の依頼文を送ってください。検証スクリプトの実行やout/への書き込みで許可を求められたら、許可してください。

inbox/ticket-101.md だけ、一次回答を作って検証してください。通ったら out/ に書いて、state/processed.txt に1行足してください。

03 成功したときの画面

講師の環境では、1回目の検証でPASSになり、out/101.mdに次の回答ができました。かかった時間は37秒です。

件名: 勤怠管理システム TimeBoardに入れないときのログイン手順

佐藤さん、お問い合わせありがとうございます。キンタイ(勤怠管理システム TimeBoard)は全社SSOでログインするため、TimeBoardだけのパスワードはリセットできません。SSOのセッションが切れていると、パスワードが違うという表示が出ることがあります。次の順に試してください。

1. 開いているTimeBoardの画面を閉じ、社内ポータルから全社SSOでログインし直してください。
2. 社内ポータルからTimeBoardを開き、今週の打刻ができるか確かめてください。
3. それでも入れない場合は、社内ポータルの「問い合わせ」からコーポレートIT サービスデスクにロック解除を依頼してください。

入れるようになってから、打刻できなかった日はTimeBoardの「打刻修正申請」から申請してください。申請は上長が承認します。

二次対応の要否: 不要

logs/loop-log.tsvには、検証スクリプトとフックが書いた2行が残ります。

2026-11-09 08:03:18	check	101.md	PASS	-
2026-11-09 08:03:29	write	101.md	out	-

04 解説

1行目は検証スクリプトが、2行目はフックが書いた記録です。どちらもAIの判断を通らずに残るので、AIが「通りました」と報告しても、この2行が無ければ検証は動いていません。.claude/settings.jsonでlogs/の編集をAIに禁じているのも、この記録を書き換えさせないためです。

90秒で復帰する手順

FAILと出たら、理由の行を読んで「理由に沿って直して、もう一度検証して」と頼んでください。このStepは1回で通らなくても構いません。ほかはhints/step02_single_ticket_hint.mdにあります。

STEP 03 ・ [4min]

止め方のないループ

このStepが終わると、停止条件が空欄のループは起動しないことを、画面で確かめた状態になります。

TYPE A 下の依頼文を送ってください。TYPE B copilot/prompts.mdのStep 3の依頼文を使います。TYPE C 下の結果を読めば、流れを追えます。

01 操作

ループを1回まわして

/loop-runと打っても、同じSkillが呼ばれます。

02 成功したときの画面

ループは始まらず、空欄の3項目が返ってきます。講師の環境では14秒で止まりました。

節空欄の項目
3. 停止条件1回の実行で処理する件数の上限
3. 停止条件検証に落ちたときに差し戻して直す回数の上限
5. 人を呼ぶ条件検証に何回落ちたら人を呼ぶか

03 解説

ループのSkillの最初の手順に、「停止条件か人を呼ぶ条件にTODOが残っていたら、ループを始めない」と書いてあります。止め方の決まっていないループは、終わる条件を満たせない問い合わせが1件あるだけで、上限まで回り続けます。始める前に止め方を確かめる手順は、どのループにも入れてください。

STEP 04 ・ [7min]

停止条件を書く

このStepが終わると、loop/LOOP.mdのTODOが3か所とも埋まった状態になります。今夜の中心です。

TYPE A・B エディタでloop/LOOP.mdを開き、自分の手で書き換えてください。TYPE C 手元のエディタに同じ3行を書けば、同じ練習になります。

01 この操作の狙い

停止条件は、AIに決めさせずに人が書きます。何件で止め、何回で諦め、いつ人を呼ぶかは、業務の側の判断だからです。今夜はAIに書き換えを頼まず、エディタで直接書いてください。

02 操作

1
「3. 停止条件」の2行を書き換える

迷ったら、次の値で書いてください。件数の上限を3件にすると、Step 5の2回目で持ち越しが起きます。

- 1回の実行で処理する件数の上限: 3件
- 検証に落ちたときに差し戻して直す回数の上限: 1回
2
「5. 人を呼ぶ条件」のTODOの行を置き換える

TODOの行を、次の1行に書き換えてください。

- 検証に2回落ちた(差し戻して直しても通らなかった)
3
保存する

TODOという文字が1つでも残っていると、Skillはループを始めません。

03 解説

差し戻しの上限を1回にすると、1件あたりの検証は最大2回になります。人を呼ぶ条件の「2回落ちた」と数が合っているかを、書いたあとに読み直してください。上限と人を呼ぶ条件の数が食い違うと、AIはどちらに従うかを自分で選ぶことになります。

早く終わった方へ

my-loop/LOOP.mdを開き、自分の業務で毎日か毎週繰り返している作業を1つ選んで、「3. 停止条件」だけを先に埋めてください。止め方が書けない作業は、まだループに載せる段階ではありません。

STEP 05 ・ [12min]

ループを回す

このStepが終わると、5件の問い合わせが、out/に出たものとneeds-human/に回ったものに分かれた状態になります。

TYPE A 下の依頼文を2回送ってください。TYPE B copilot/prompts.mdのStep 5の依頼文を2回使います。TYPE C 下の結果を読めば、流れを追えます。

01 操作

1
ループを1回まわす

次の依頼文を送ってください。許可を求められたら、内容が検証スクリプトかwork/、out/、needs-human/、state/への書き込みであることを確かめてから許可してください。

ループを1回まわして
2
結果の報告を読む

処理した3件の結果と、持ち越した件数が返ってきます。

3
もう1回まわす

次の依頼文を送ってください。持ち越していた1件だけが処理されます。

もう1回ループをまわして

02 成功したときの画面

講師の環境での1回目の結果です。かかった時間は2分32秒で、費用は0.45ドルでした。

問い合わせ結果検証の回数
102 協力会社に設計書を見せたい人を呼んだ。社外へ社内資料の所在を伝えるので承認が要る0回
103 経費精算が差し戻された完了。out/103.mdに出た1回
104 シンセイの承認者が出ない人を呼んだ。シンセイが台帳になく、2回とも落ちた2回
105 打刻の修正と経費の出し直し件数の上限で次の実行へ持ち越しなし

2回目は105だけを処理し、1回目の検証でPASSになりました。104のneeds-human/104.mdには、次の内容が書かれます。

# 問い合わせ 104 人の判断が要る件

## 理由

検証に2回落ちたため、人を呼びます。問い合わせのシンセイはcontext/systems.mdに載っていません。context/rules.mdの決まりにより、二次対応の要否を「判断できません」にしました。検証スクリプトはこの値を通さないので、判断を変えない限り検証に通りません。判断を変えて通すことは運用規約で禁じられているため、下書きは2回とも同じ内容で検証にかけました。

担当の方に、次の2点を確認してください。

- シンセイの正式名と担当の窓口
- 承認者の候補に部長が出てこない理由を、どの部署が調べるか

## 検証の結果

- 1回目: FAIL。二次対応の要否が「判断できません」です
- 2回目: FAIL。理由は1回目と同じです

## 回答案

    件名: シンセイの承認者の候補に部長が出てこない件

    高橋さん、お問い合わせありがとうございます。シンセイはヘルプデスクのシステム台帳に載っていないため、承認者の候補の仕組みと担当の窓口をこちらでは確認できません。担当者が確認してから、改めてご連絡します。

    二次対応の要否: 判断できません

03 解説

人を呼んだ2件は、理由が違います。102はAIが判断ルールを読んで、下書きを作る前に止めました。104は、判断ルールどおりに「判断できません」と書いた下書きを、検証スクリプトが2回とも落としました。前者は判断で止まり、後者は仕組みで止まっています。

104は、何回直しても通りません。根拠になる台帳が無いことは、様式を直しても解決しないためです。差し戻しの上限は、直して通るものと、直しても通らないものを見分けるために置いています。上限が無ければ、このループは104を直し続けます。

90秒で復帰する手順

104がout/に出てしまった場合は、out/104.mdの最後の行を見てください。AIが二次対応の要否を書き換えて通した可能性があります。途中で止まって動かない場合は、許可の確認が出ていないかを見てください。ほかはhints/step05_run_loop_hint.mdにあります。

STEP 06 ・ [6min]

記録を読み返す

このStepが終わると、ループが何をしたかを記録だけで説明でき、設計書の改善案が1つ手元に残ります。

TYPE A 下の依頼文を送ってください。TYPE B copilot/prompts.mdのStep 6の依頼文を使います。TYPE C 下の2つの記録を見比べれば、同じことを確かめられます。

01 操作

state/processed.txt と logs/loop-log.tsv を突き合わせて、AIの記録と仕組みの記録が食い違っていないか確かめてください。そのうえで、loop/LOOP.md を直すとよい点を1つだけ提案してください。直すかどうかは私が決めます。

02 2つの記録

AIが書いたstate/processed.txtです。101の行はStep 2で書いたので、ほかの行と形がそろっていません。

101	PASS	検証1回
102	人を呼んだ	検証0回	社外へ共有ドライブのURLを伝えるため承認が要る
103	完了	検証1回	1回目の検証で通った
104	人を呼んだ	検証2回	シンセイが台帳になく判断できませんのまま2回落ちた
105	完了	検証1回	1回目の検証で通った

検証スクリプトとフックが書いたlogs/loop-log.tsvです。104のFAILが2行あるので、AIの「検証2回」と数が合います。

2026-11-09 08:03:18	check	101.md	PASS	-
2026-11-09 08:03:29	write	101.md	out	-
2026-11-09 08:04:14	check	103.md	PASS	-
2026-11-09 08:04:18	write	103.md	out	-
2026-11-09 08:04:24	check	104.md	FAIL	二次対応の要否が「判断できません」です。根拠がないまま一次回答は出せません
2026-11-09 08:04:29	check	104.md	FAIL	二次対応の要否が「判断できません」です。根拠がないまま一次回答は出せません
2026-11-09 08:05:53	write	104.md	needs-human	-
2026-11-09 08:05:57	write	102.md	needs-human	-
2026-11-09 08:07:19	check	105.md	PASS	-
2026-11-09 08:07:24	write	105.md	out	-

03 解説

講師の環境では、AIは「判断できませんになる件は必ず2回落ちるので、最初から人を呼ぶ条件に入れれば検証を1回むだに回さずに済む」と提案しました。採るなら、AIに直させずに、自分で「5. 人を呼ぶ条件」に1行足してください。

AIが自分の結果を読んで手順の直し方を出し、人が採るかどうかを決める。これが、座学の最後に扱った自己改善のループの、業務で今すぐ使える形です。設計書と検証を書き換える権限を人が持っている限り、AIが通らない課題を検証を緩めて通すことは起きません。

AFTER ・ 開催後

持ち帰るものとFAQ

配布データは開催後もそのまま使えます。第2回の配布データをお持ちの方は、context/を第2回で書いたものに差し替えても動きます。

01 自分の業務へ持ち込む手順

1
作業を1つ選ぶ

手で3回動かして、3回とも直さずに使えた作業を選んでください。直したことがあるなら、先にハーネスを直します。

2
設計書を書く

my-loop/LOOP.mdの5項目を埋め、my-loop/CHECKLIST.mdの7項目に照らしてください。停止条件と人を呼ぶ条件が埋まるまでは起動しません。

3
手動で3回まわす

3回とも記録を読み、止まった理由を記録だけで説明できるかを確かめてください。

4
定期実行に移す

schedule/README.mdの例で、毎朝決まった時刻に起動させます。Macでは、作業フォルダをデスクトップ、書類、ダウンロードの外に移してから登録してください。

02 よくある質問

定期実行にしたら、許可の確認はどうなりますか
確認を出さずに断られます。schedule/run-loop.shは--permission-mode dontAskで起動し、.claude/settings.jsonで許可したものだけを使わせます。夜中に確認の画面で止まったまま朝を迎えることを防ぐためです。
費用の上限はどこで決めますか
claude -pの--max-budget-usdで、1回の実行で使ってよい金額を渡します。schedule/run-loop.shでは1ドルにしています。講師の環境では、このループの1回は0.4ドル台でした。
GitHub Copilotだけで定期実行できますか
Copilot CLIのcopilot -pで、対話なしに1回動かせます。使ってよい道具は--allow-toolで渡す形です。リポジトリを相手にする作業なら、Issueを割り当てるとクラウドで実装するcoding agentも使えます。
最初からやり直したいときは
work/、out/、needs-human/の中身(.gitkeepは残す)と、state/processed.txt、logs/loop-log.tsvの中身を空にしてください。配布したときの状態に戻ります。