パーソルクロステクノロジー様 第3回今夜の[120min]のうち、講師が話す[80min]分の資料です。前半でハーネスとループの違いを整理し、ループを5つの要素に分けます。後半では、講師が毎日動かしている2つのループを、設定ファイルと実行の記録で読みます。手元の環境は使いません。
最初の10分で、第1回と第2回で扱った範囲と、今夜進む範囲の境目をお伝えします。
第1回(2026年5月)では、Hooks・Skills・サブエージェントの3つの部品を1つずつ動かしました。第2回(2026年8月)では、その部品に何を読ませてどこで止めるかを決めるハーネスとコンテキストを扱い、架空のヘルプデスクへの問い合わせ1件に、人が見ている前で一次回答を作りました。
今夜は、第2回で組んだ1件の処理を、人が呼ばなくても繰り返し回る形に組み替えます。ハンズオンの配布データも、第2回の問い合わせの題材を引き継いでいます。
前回までの内容を覚えていることは前提にしていません。ハーネスの部品は完成した状態で配布し、今夜さわるのはループの設計書の空欄だけです。言葉の定義は補足ページの用語集にも置いています。
人が見ている前で1回動かすときは、おかしな出力が出ても、その場で人が気づいて止められます。繰り返し回す形に移ると、この前提が4つ外れます。
| 変わること | 1回動かすとき | 回し続けるとき |
|---|---|---|
| 許可の確認 | 画面の前の人が答える | 答える人がいない。事前に決めた範囲だけが通る |
| 失敗の気づき方 | 出力を見てすぐ気づく | 記録を読むまで気づかない |
| 費用 | 1回分 | 回数分。止まらなければ上限まで積もる |
| 直す場所 | 依頼文を言い直す | 設定と手順を直し、次の回から効かせる |
ループの設計は、人が受け持っていたこの4つを、仕組みの側に移す作業です。
今夜の言葉は、下の図の2つの層に分かれます。内側のハーネスが1回の実行の質を決め、外側のループが繰り返しの回り方を決めます。デモとハンズオンでファイル名が出てきたら、どちらの層のものかをこの図で確かめてください。
2つの言葉の定義をそろえてから、ループを5つの要素に分けます。最後に、回し続けるときの費用の考え方を扱います。
ハーネスエンジニアリングは、特定の作業をAIが再現できる形にし、AIモデル以外のすべての設定を設計する仕事です。同じモデルを使っていても、何を読ませ、何をさせず、どの手順で進ませ、どう確かめるかが変われば、結果も変わります。
| 部品 | 決めること | 今夜の配布データでの場所 |
|---|---|---|
| コンテキスト | 何を根拠にさせるか | CLAUDE.mdとcontext/ |
| Skills | どの手順で進ませるか | .claude/skills/loop-run/SKILL.md |
| Hooks | どこで必ず止め、何を必ず残すか | hooks/approval-gate.shとhooks/record-write.sh |
| MCP | 外のどの道具を呼ばせるか | 今夜は使いません |
| 権限 | どこに書かせ、何を打たせないか | .claude/settings.json |
ハーネスの出来は、同じ1件を何度動かしても同じ品質で返ってくるかで確かめます。第2回のハンズオンで、context/の数行を書き換えただけで出力が別物になったのは、この層の働きです。
コンテキストは.github/copilot-instructions.mdに置きます。Skillsは.github/skills/のほか、.claude/skills/に置いたものも読まれます。VS CodeのCopilotにもHooksがプレビュー機能として入っていて、置き場所は.github/hooks/です。Claude Codeの.claude/settings.jsonのHooksは読まれません。
ループエンジニアリングは、ハーネスで再現できるようになった作業を、いつ起動し、何を確かめ、どこで止め、何を残すかまで設計する仕事です。ハーネスが1回の質を決めるのに対し、ループは回数をまたいだ振る舞いを決めます。
ループの出来は、人が見ていない間に何が起きたかを、翌朝に記録だけで説明できるかで確かめます。
| 観点 | ハーネス | ループ |
|---|---|---|
| 決めるもの | 1回の実行の質 | 繰り返しの回り方 |
| 主な部品 | コンテキスト、Skills、Hooks、MCP、権限 | 起動、検証、停止条件、記録、人を呼ぶ条件 |
| 失敗の現れ方 | 1件の出力がおかしい | 止まらない、止まりすぎる、止まった理由が分からない |
| 直す場所 | コンテキストと手順 | 設計書と起動の設定 |
組み合わせるときは、ハーネスを先に仕上げます。手で動かしても毎回やり直しになる作業をループに載せると、やり直しが回数分に増えるだけです。今夜のハンズオンも、Step 2で1件を手で通してから、Step 5でループに載せる順にしています。
講師は、手で3回動かして3回とも直さずに使えた作業だけをループに載せています。1回でも直したなら、直した内容をハーネスの側に書き足してから、もう一度3回を数えます。
ループは5つの要素で書けます。講師のニュース収集と夜間の自動開発、今夜のハンズオンのループを並べると、次のようになります。
| 要素 | 決めること | ニュース収集 | 夜間の自動開発 | ハンズオン |
|---|---|---|---|---|
| 起動のきっかけ | いつ、何で始めるか | launchdが毎朝8:30 | launchdが毎晩1:30 | 受講者がチャットで頼む |
| 検証 | 何を機械で確かめるか | 字数、レイアウト、改行の検査 | 人が書いた受け入れテスト | checks/check-reply.sh |
| 停止条件 | どこで止めるか | 候補が出なければ中止。検査で落ちたら巻き戻して終了 | 1晩1件、2回まで、1.5ドル、20分 | 件数と差し戻しの上限 |
| 記録 | 何を残すか | collect.log | night.tsvと朝の報告書 | loop-log.tsvとprocessed.txt |
| 人を呼ぶ条件 | いつ人に知らせるか | 仕組みがない | 2回落ちたらMacに通知 | needs-human/に書く |
5つのうち後回しにされやすいのは、人を呼ぶ条件です。講師のニュース収集にもこの仕組みが入っていないので、止まった日に気づけるのは、ログを開いたときだけです。デモでその状態をお見せします。
起動のしかたは、PCの電源が要るかどうかと、許可の確認に誰が答えるかで選びます。Claude Codeの公式ドキュメントでは、次の仕組みが案内されています。
| 仕組み | どこで動くか | PCの電源 | 向いている使い方 |
|---|---|---|---|
/loop | 開いているセッションの中 | 要る | 作業中に決まった間隔で見張らせる。定期の繰り返しは7日で止まる |
| デスクトップ版の定期実行 | 手元のPC | 要る | 手元のファイルを使う作業を、毎朝決まった時刻に回す |
| クラウドの定期実行 | Anthropicのクラウド | 要らない | リポジトリを相手にする作業。間隔は最短1時間 |
claude -pとOSの定期実行 | 手元のPC(launchd、cron、タスク スケジューラ) | 要る | 起動の条件、使ってよい道具、記録の残し方を自分で決めたいとき |
| GitHub Actions | GitHubの実行環境 | 要らない | Issueやプルリクエストの動きをきっかけに回す |
GitHub Copilotでは、Issueを割り当てるとクラウドで実装してプルリクエストを作るcoding agentと、copilot -pで対話なしに動かすCopilot CLIが、同じ役割を持ちます。
講師の2つのループは、どちらもclaude -pとlaunchdで動かしています。起動の時刻、使ってよい道具、金額の上限を、1本のスクリプトに書いて残せるためです。
/loopを引数なしで打つと、.claude/loop.mdに書いた内容が依頼文として使われます。決まった見張りの作業があるなら、依頼文を毎回打たずに、このファイルに置いておけます。
講師の環境では2026年8月末にmacOSの設定が変わり、launchdから起動したジョブがデスクトップ配下を読めなくなりました。教材のドラフトを作る夜間ジョブは、それ以降一晩も完了していません。夜間開発のデモ用リポジトリをデスクトップの外に置いているのは、このためです。
ループの検証は、AIの報告ではなく、AIの外にある仕組みで行います。人が見ていない間は、AIが「通りました」と書いた報告を確かめる人がいないためです。
講師の夜間開発では、受け入れテストを人が先に書き、AIにはテストの編集を許可していません。テストを走らせて合否を決めるのも、AIではなくループのスクリプトです。AIがsrc/の外を書き換えていたら、テストが通っても不合格にしています。
verify() {
# 変更が src/ の中だけかを git の差分で見る
outside="$(git status --porcelain | awk '{print $2}' | grep -v '^src/' || true)"
[ -n "$outside" ] && return 1
# その課題と、これまでに終えた課題のテストを全部流す
node --test $TESTS > "logs/attempts/$TODAY-$ID-$1-test.txt" 2>&1
}
ハンズオンも同じ形です。検証スクリプトが結果をlogs/loop-log.tsvに書き、AIが書くstate/processed.txtと突き合わせられるようにしてあります。
停止条件には、止まらないことを防ぐ条件と、止まったまま気づかれないことを防ぐ条件の2種類があります。講師の夜間開発では、次の5つを決めています。
| 種類 | 決めること | 夜間開発での値 |
|---|---|---|
| 件数 | 1回で処理する数 | 1晩に1件 |
| 回数 | 同じものを直す回数 | 2回まで |
| 金額 | 1回で使ってよい額 | --max-budget-usd 1.5 |
| 時間 | 1回にかけてよい時間 | timeout 1200(20分) |
| 前提 | 始める前に確かめること | 前の晩の変更が残っていたら始めない |
回数の上限は、AIの見込みではなく、記録に残った回数で数えます。ハンズオンの準備で講師がループを試したとき、AIは1回落ちた時点で「直しても通らない」と判断し、2回目の検証を省いて人を呼びました。判断としては正しくても、設計書の「2回落ちたら」と記録が食い違います。手順に「見込みで回数を省かない」と書き足し、2回目も記録に残る形にしました。
Claude CodeのStopフックは、"decision": "block"と理由を返すと、Claudeに作業を続けさせられます。全部終わるまで止めないループを手早く組めますが、終わる条件を満たせない課題が1件あると、上限に当たるまで回り続けます。止めない仕組みを入れるときは、回数か金額の上限を同じ場所に書いてください。
人を呼ぶ条件には、誰がどこで気づくかまで書くのが決まりです。講師の環境には、ニュース収集の失敗をセッションの開始時に表示する仕組みがあります。ところが失敗の記録が消えるのは同じ日付のジョブが成功したときだけなので、11月4日から毎日成功していても、11月1日から3日の失敗が表示され続けている状態です。同じ通知が出続けると、人はやがて読まなくなります。
ループの費用は、1回の消費に回数を掛けたものです。講師の実測では、1回の消費は処理の中身より、起動のたびに読み直す設定とコンテキストの量で決まっていました。
| 実行 | 処理した数 | 費用 | 時間 |
|---|---|---|---|
| ハンズオンのループの1回目 | 3件 | 0.45ドル | 2分32秒 |
| ハンズオンのループの2回目 | 1件 | 0.43ドル | 1分19秒 |
| 夜間開発で1回目に合格した晩 | 1件 | 0.12〜0.13ドル | 26〜28秒 |
| 夜間開発で2回とも落ちた晩 | 1件 | 0.22ドル | 45秒 |
ハンズオンのループが3件でも1件でも0.4ドル台なのは、起動のたびにcontext/と手順を読み直す分が、毎回同じだけかかるためです。起動の回数を増やすほどこの分が積もるので、1回にまとめて処理する件数と、起動の間隔を一緒に決めます。
講師が費用を減らすために行っていることは3つあります。
| やり方 | 講師のループでの例 |
|---|---|
| ツールの出力を短くして渡す | 夜間開発では、テストの出力の全文はファイルに残し、AIには失敗の理由の行だけを渡す |
| モデルを使い分ける | 手順の決まった実装はsonnetを指定し、設計の判断が要る作業だけを上位のモデルに回す |
| 上限を分け合うループの数を数える | 2026年10月22日に利用の上限に当たり、ニュース収集、夜間の動画収集、採点、締切の同期の4つが同じ日に止まった |
手元のPCで動くローカルLLMも、モデルの使い分けの候補になります。利用料はかかりませんが、速さと品質がPCの性能で決まるので、手順の決まった短い作業から試すのが向いています。
配布データのmy-loop/CHECKLIST.mdにも同じ7項目を入れています。
講師が毎日動かしている2つのループを、設定ファイルと実行の記録で読みます。講師の画面で進めますので、手元の環境は使いません。
生成AIの最新トレンド資料に、毎朝1件ずつニュースを足しているループです。launchdが毎朝8:30にスクリプトを起動し、Claude Codeが7つの観点で調べて候補を3〜5件出します。スクリプトが1件を選んでスライドに足し、レイアウトと改行の検査で落ちたら追記を巻き戻します。顧客のサイトへの反映は人が判断するので、ループはそこまでは行いません。
2026年10月10日から11月8日までの30日の結果です。
| 止まり方 | 日数 | 日付と理由 |
|---|---|---|
| 候補が出ずに中止 | 4日 | 10月13日、11月1日、11月5日はネットにつながらなかった。10月22日は利用の上限に当たった |
| 検査で落ちて巻き戻し | 3日 | 10月26日と11月6日はレイアウトの検査で落ちた。10月30日は検査器そのものがファイルの読み込みで止まり、正しい候補まで巻き戻した |
| 採用なし | 2日 | 10月12日と10月24日は、候補が全部、字数か改行の検査で落ちた |
| 記録なし | 1日 | 10月31日は開始の行だけが残り、終わった記録も理由もない |
11月5日は8:50に始まり、失敗と判定されたのは10:21でした。ネットにつながらないまま1時間31分待っていたことになります。時間の上限を決めていないと、止まるまでの時間は相手の都合で決まります。
ヘルプデスクで使う小さな関数を、1晩に1件ずつ実装させるループです。今回のセミナーのために、2026年11月10日から毎晩1:30に動かしています。課題は10件あり、どの課題にも人が先に書いた受け入れテストが付いています。
検証に通った課題はmainに取り込み、2回とも落ちた課題はissues/blocked/に移してMacに通知を出します。4件目の課題は、総務部が用意する祝日一覧のファイルが無いと通らないように作ってあります。試運転では、AIは祝日を実装に直接書き込まずに2回とも止まり、朝の報告書に足りないものを書きました。
## AIの最後の報告 ISSUE-004 は実装せずに終わります。前提の data/holidays.json がないためです。 祝日を実装に直接書き込む回避もしていません。祝日一覧は総務部が持つデータだからです。 人が対応してほしいこと - 総務部から祝日一覧を受け取り、data/holidays.json に置いてください。
当日は、本番までの毎晩の記録をlogs/night.tsvで読み、止まった晩の報告書を開きます。
試運転の1回目は、AIの書き込みが全部断られました。新しいフォルダを一度も対話で開いておらず、Claude Codeがフォルダの許可設定を読まなかったためです。夜は信頼の確認に答える人がいないので、使ってよい道具はnight.shからclaude -pの引数で渡す形に直しました。
2つのループの記録を並べると、止まった理由は次の4つに分けて読めます。
| 分類 | 講師の記録での例 | 直す場所 |
|---|---|---|
| ループの外の環境 | ネットにつながらない、OSの権限が外れた | 起動の条件と時間の上限 |
| 上限 | 利用の上限、金額の上限 | 起動の回数と間隔、上限を分け合うループの数 |
| 検証で落ちた | レイアウトの検査、受け入れテスト | ハーネスか、課題そのもの |
| 仕組み自身の不具合 | 検査器の誤作動、終わりの記録がない | ループのスクリプト |
4つのうち、ループが設計どおりに働いた結果は3つ目の「検証で落ちた」だけです。残りの3つは、ループの設計か環境を直します。検査器が止まった日を内容の不合格と同じ記録にしていると、この区別がつかなくなります。
今夜の言葉と、ハンズオンと夜間開発のファイルの対応を1枚にまとめます。
| 今夜の言葉 | ハンズオンのファイル | 夜間開発のファイル |
|---|---|---|
| コンテキスト | CLAUDE.md、context/ | CLAUDE.md、issues/ |
| 手順 | .claude/skills/loop-run/SKILL.md | night/night.shの依頼文 |
| 権限 | .claude/settings.json | claude -pの--allowedTools |
| 起動のきっかけ | チャットで頼む。持ち帰ったあとはschedule/ | launchd |
| 検証 | checks/check-reply.sh | gitの差分とnode --test |
| 停止条件 | loop/LOOP.mdの3 | night/night.shの先頭の4つの値 |
| 記録 | logs/loop-log.tsv、state/processed.txt | logs/night.tsv、reports/ |
| 人を呼ぶ条件 | needs-human/ | issues/blocked/とMacの通知 |
ハンズオンの準備でループを回したとき、AIは処理の報告の最後に、設計書の直し方を1つ提案しました。「判断できません」になる件は必ず2回落ちるので、最初から人を呼ぶ条件に入れれば、検証を1回むだに回さずに済む、という案です。
研究の分野では、AIが自分自身を改良し続ける再帰的自己改善(RSI)が議論されています。業務のループで今すぐ使えるのはその手前で、AIが自分の結果を読み、手順や設定の直し方を出す範囲です。
講師の運用では、AIに出させるのは改善の案までにしています。設計書と検証を書き換える権限は人が持ちます。検証を直す権限までAIに渡すと、通らない課題を、検証を緩めて通せるようになるためです。ハンズオンのStep 6でも、AIに改善案を1つ出させ、採るかどうかは受講者が決める形にしています。
今夜は、1本ずつ独立したループを扱いました。複数のループが同じ利用上限や同じファイルを分け合うときの設計は、今夜の範囲の外に残っています。第4回のテーマは調整中です。
このあと、チャット欄でいただいた質問に時間の範囲でお答えします。答えきれなかった質問は、開催後にトップページへ回答を載せます。