パーソルクロステクノロジー様 第3回架空の社内ヘルプデスクに届いた問い合わせ5件を、一次回答のループで順に処理します。ハーネスは完成した状態で配布し、今夜さわるのはループの設計書の空欄だけです。打ち込む依頼文と、講師の環境で返ってきた結果をStepごとに載せていますので、手元で動かせない方も読むだけで追えます。
ZIPを展開し、TYPE A、B、Cのどれで参加するかを決めます。
フォルダを開き、ループの設計書の5項目を確かめます。
問い合わせ1件に一次回答を作り、検証スクリプトに通します。
停止条件が空欄のまま起動を頼み、断られることを確かめます。
件数と差し戻しの上限、2回落ちたら人を呼ぶ条件を書き込みます。
ループを2回まわし、完了、人を呼ぶ、持ち越しの3つの結果を確かめます。
AIの記録と仕組みの記録を突き合わせ、設計書の改善案を1つ出させます。
自分の業務のループ設計書と、毎朝決まった時刻に起動する例です。
配布データは20261126_handson.zip(Windows用)と20261126_handson_Mac.zip(Mac用)の2本です。中身は同じで、展開するとloop-kitというフォルダが1つできます。
| 段階 | 使うもの | 今夜できること |
|---|---|---|
| TYPE A | Claude Code | Step 1からStep 6まで手元で動かせます。検証スクリプトとフックの記録も残ります |
| TYPE B | GitHub Copilot | 同じフォルダで、copilot/prompts.mdの依頼文を送ります。検証スクリプトは動き、フックの部分は講師の投影で見ます |
| TYPE C | なし | 投影と、このページに載せた結果を読み比べます。Step 4の設計書だけは手元のエディタで書けます |
準備の手順は事前セットアップガイドにあります。
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が終わると、VS Codeでloop-kitが開き、AIがループの設計書の5項目を説明できる状態になります。
TYPE A 下の操作をそのまま行ってください。TYPE B 3の前に、copilot/README.mdの手順で.github/copilot-instructions.mdを置きます。TYPE C loop/LOOP.mdをエディタで開けば、同じ5項目を読めます。
VS Codeの「ファイル」から「フォルダーを開く」を選び、loop-kitそのものを開いてください。1つ上のフォルダを開くと、CLAUDE.mdと.claude/が読まれません。
VS Codeのターミナルで、次を1回だけ実行してください。Windowsの方はREADME.mdの「Windowsの方へ」に従ってください。
chmod +x checks/check-reply.sh hooks/approval-gate.sh hooks/record-write.sh
Claude Codeのパネルを開き、次の依頼文を送ってください。フォルダの信頼を尋ねる画面が出たら、信頼してください。
loop/LOOP.md を読んで、5つの項目がそれぞれ何を決めているかを1行ずつ説明してください。空欄になっている項目があれば教えてください。
5項目の説明と一緒に、「3. 停止条件」の2行と「5. 人を呼ぶ条件」の1行が空欄(TODO)だと返ってきます。この3か所を、Step 4で埋めます。
AIがloop/LOOP.mdを見つけられない場合は、開いているフォルダがloop-kitそのものかを確かめてください。ほかはhints/step01_setup_hint.mdにあります。
このStepが終わると、out/101.mdに一次回答が1件でき、logs/loop-log.tsvに検証の結果が1行残ります。ループに載せる前に、ハーネスが1件を正しく通せるかを確かめるStepです。
TYPE A 下の依頼文を送ってください。TYPE B copilot/prompts.mdのStep 2の依頼文を、エージェントを選んでから送ります。TYPE C 下の結果を読めば、流れを追えます。
ループは、1件の処理を繰り返すだけの仕組みです。1件が正しく通らないままループに載せると、やり直しが件数分に増えます。先に1件を手で通し、検証スクリプトが何を見ているかを確かめます。
inbox/ticket-101.mdを開いてください。勤怠システムにログインできないという、3行の依頼です。
次の依頼文を送ってください。検証スクリプトの実行やout/への書き込みで許可を求められたら、許可してください。
inbox/ticket-101.md だけ、一次回答を作って検証してください。通ったら out/ に書いて、state/processed.txt に1行足してください。
講師の環境では、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 -
1行目は検証スクリプトが、2行目はフックが書いた記録です。どちらもAIの判断を通らずに残るので、AIが「通りました」と報告しても、この2行が無ければ検証は動いていません。.claude/settings.jsonでlogs/の編集をAIに禁じているのも、この記録を書き換えさせないためです。
FAILと出たら、理由の行を読んで「理由に沿って直して、もう一度検証して」と頼んでください。このStepは1回で通らなくても構いません。ほかはhints/step02_single_ticket_hint.mdにあります。
このStepが終わると、停止条件が空欄のループは起動しないことを、画面で確かめた状態になります。
TYPE A 下の依頼文を送ってください。TYPE B copilot/prompts.mdのStep 3の依頼文を使います。TYPE C 下の結果を読めば、流れを追えます。
ループを1回まわして
/loop-runと打っても、同じSkillが呼ばれます。
ループは始まらず、空欄の3項目が返ってきます。講師の環境では14秒で止まりました。
| 節 | 空欄の項目 |
|---|---|
| 3. 停止条件 | 1回の実行で処理する件数の上限 |
| 3. 停止条件 | 検証に落ちたときに差し戻して直す回数の上限 |
| 5. 人を呼ぶ条件 | 検証に何回落ちたら人を呼ぶか |
ループのSkillの最初の手順に、「停止条件か人を呼ぶ条件にTODOが残っていたら、ループを始めない」と書いてあります。止め方の決まっていないループは、終わる条件を満たせない問い合わせが1件あるだけで、上限まで回り続けます。始める前に止め方を確かめる手順は、どのループにも入れてください。
このStepが終わると、loop/LOOP.mdのTODOが3か所とも埋まった状態になります。今夜の中心です。
TYPE A・B エディタでloop/LOOP.mdを開き、自分の手で書き換えてください。TYPE C 手元のエディタに同じ3行を書けば、同じ練習になります。
停止条件は、AIに決めさせずに人が書きます。何件で止め、何回で諦め、いつ人を呼ぶかは、業務の側の判断だからです。今夜はAIに書き換えを頼まず、エディタで直接書いてください。
迷ったら、次の値で書いてください。件数の上限を3件にすると、Step 5の2回目で持ち越しが起きます。
- 1回の実行で処理する件数の上限: 3件 - 検証に落ちたときに差し戻して直す回数の上限: 1回
TODOの行を、次の1行に書き換えてください。
- 検証に2回落ちた(差し戻して直しても通らなかった)
TODOという文字が1つでも残っていると、Skillはループを始めません。
差し戻しの上限を1回にすると、1件あたりの検証は最大2回になります。人を呼ぶ条件の「2回落ちた」と数が合っているかを、書いたあとに読み直してください。上限と人を呼ぶ条件の数が食い違うと、AIはどちらに従うかを自分で選ぶことになります。
my-loop/LOOP.mdを開き、自分の業務で毎日か毎週繰り返している作業を1つ選んで、「3. 停止条件」だけを先に埋めてください。止め方が書けない作業は、まだループに載せる段階ではありません。
このStepが終わると、5件の問い合わせが、out/に出たものとneeds-human/に回ったものに分かれた状態になります。
TYPE A 下の依頼文を2回送ってください。TYPE B copilot/prompts.mdのStep 5の依頼文を2回使います。TYPE C 下の結果を読めば、流れを追えます。
次の依頼文を送ってください。許可を求められたら、内容が検証スクリプトかwork/、out/、needs-human/、state/への書き込みであることを確かめてから許可してください。
ループを1回まわして
処理した3件の結果と、持ち越した件数が返ってきます。
次の依頼文を送ってください。持ち越していた1件だけが処理されます。
もう1回ループをまわして
講師の環境での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回目と同じです
## 回答案
件名: シンセイの承認者の候補に部長が出てこない件
高橋さん、お問い合わせありがとうございます。シンセイはヘルプデスクのシステム台帳に載っていないため、承認者の候補の仕組みと担当の窓口をこちらでは確認できません。担当者が確認してから、改めてご連絡します。
二次対応の要否: 判断できません
人を呼んだ2件は、理由が違います。102はAIが判断ルールを読んで、下書きを作る前に止めました。104は、判断ルールどおりに「判断できません」と書いた下書きを、検証スクリプトが2回とも落としました。前者は判断で止まり、後者は仕組みで止まっています。
104は、何回直しても通りません。根拠になる台帳が無いことは、様式を直しても解決しないためです。差し戻しの上限は、直して通るものと、直しても通らないものを見分けるために置いています。上限が無ければ、このループは104を直し続けます。
104がout/に出てしまった場合は、out/104.mdの最後の行を見てください。AIが二次対応の要否を書き換えて通した可能性があります。途中で止まって動かない場合は、許可の確認が出ていないかを見てください。ほかはhints/step05_run_loop_hint.mdにあります。
このStepが終わると、ループが何をしたかを記録だけで説明でき、設計書の改善案が1つ手元に残ります。
TYPE A 下の依頼文を送ってください。TYPE B copilot/prompts.mdのStep 6の依頼文を使います。TYPE C 下の2つの記録を見比べれば、同じことを確かめられます。
state/processed.txt と logs/loop-log.tsv を突き合わせて、AIの記録と仕組みの記録が食い違っていないか確かめてください。そのうえで、loop/LOOP.md を直すとよい点を1つだけ提案してください。直すかどうかは私が決めます。
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 -
講師の環境では、AIは「判断できませんになる件は必ず2回落ちるので、最初から人を呼ぶ条件に入れれば検証を1回むだに回さずに済む」と提案しました。採るなら、AIに直させずに、自分で「5. 人を呼ぶ条件」に1行足してください。
AIが自分の結果を読んで手順の直し方を出し、人が採るかどうかを決める。これが、座学の最後に扱った自己改善のループの、業務で今すぐ使える形です。設計書と検証を書き換える権限を人が持っている限り、AIが通らない課題を検証を緩めて通すことは起きません。
配布データは開催後もそのまま使えます。第2回の配布データをお持ちの方は、context/を第2回で書いたものに差し替えても動きます。
手で3回動かして、3回とも直さずに使えた作業を選んでください。直したことがあるなら、先にハーネスを直します。
my-loop/LOOP.mdの5項目を埋め、my-loop/CHECKLIST.mdの7項目に照らしてください。停止条件と人を呼ぶ条件が埋まるまでは起動しません。
3回とも記録を読み、止まった理由を記録だけで説明できるかを確かめてください。
schedule/README.mdの例で、毎朝決まった時刻に起動させます。Macでは、作業フォルダをデスクトップ、書類、ダウンロードの外に移してから登録してください。
schedule/run-loop.shは--permission-mode dontAskで起動し、.claude/settings.jsonで許可したものだけを使わせます。夜中に確認の画面で止まったまま朝を迎えることを防ぐためです。claude -pの--max-budget-usdで、1回の実行で使ってよい金額を渡します。schedule/run-loop.shでは1ドルにしています。講師の環境では、このループの1回は0.4ドル台でした。copilot -pで、対話なしに1回動かせます。使ってよい道具は--allow-toolで渡す形です。リポジトリを相手にする作業なら、Issueを割り当てるとクラウドで実装するcoding agentも使えます。work/、out/、needs-human/の中身(.gitkeepは残す)と、state/processed.txt、logs/loop-log.tsvの中身を空にしてください。配布したときの状態に戻ります。