AIに手順書を渡しても、守られているかを確かめるのは結局こちらです。そのせいで抜けが出て困っている人に向けて書きました。読むと、手順書を「毎回渡すもの」から「勝手に効くもの」に変える仕組みの全体像が分かります。書いている私は元飲食店員で、IT未経験からPythonを始めました。
■ 手順書だけでは抜けが出た
手順書は、渡せば効きます。ただ、渡すのも、結果を確かめるのも人間なので、どうしても抜けが出ます。
自作の育成ゲームを公開したとき、説明書きに「あとで書く」つもりの空欄を残したままでした。この空欄は構文チェックでは見つかりません。見つけられるのは、あとで説明する3つ目の層(目で確かめる手順)です。手順書はあったのに、それを毎回守らせる仕組みがなかったことが原因でした。
■ 何が変わったのか
手順書だけで回していたころは、AIが間違ったコードを書いても、こちらが確認するまで誰も気づきませんでした。しかも確認するのは人間なので、疲れている日は飛ばします。
今の形では、AIの開発ツール(Claude Code)でAIがHTMLファイルを編集した直後に、構文のチェックが自動で走ります。結果はPASSかFAILでAIに返るので、壊れたまま次の作業に進むことが減りました。
■ 仕組みの全体像は3つの層
全体は、次の3つの層でできています。
・1つ目の層:自動チェック。編集のたびに構文を確認する。動かすのは自動(フック)
・2つ目の層:修正ループの約束事。FAILのときにAIが直す範囲と回数を決める。動かすのはAI(指示したときだけ)
・3つ目の層:人間の3手順。構文確認・目視・記録。動かすのは自分
1つ目は、編集のたびに勝手に挟まる確認です。「フック」は、Claude Codeで決まった操作の直後にコマンドを自動で走らせる設定のことです。渡し忘れが起きません。
2つ目は、FAILが出たときの直し方の約束事です。「直して」とだけ頼むのではなく、直してよい範囲と、直す回数をあらかじめ決めて渡しています。
3つ目は、最後に人間がやる手順です。
1. 「node check.mjs 対象のHTML」で構文を確認する(PASSが出ること)
2. 実際に起動して、目で動きを確かめる
3. 問題がなければ git commit で記録する
人間が覚えておくのは、この3つだけです。配布する前だけ、ここに「報告だけの監査」(問題を書き出すだけで、直すのは別にする点検)を1回足します。
■ まとめ
・手順書を渡すだけだと、渡す人と確かめる人が同じ人間なので、抜けが出た
・編集の直後に自動で確認が走るようにして、渡し忘れが減った(自分の作業での実感)
・人間が覚えるのは、構文確認・目視・記録の3手順だけ
■ 確かめていないこと
・ここで書いた仕組みは、自分のパソコンと、HTMLファイル1枚で作ったプロジェクトで使った内容です。ほかの種類のファイルや、複数人で使う場合は試していません。
・「抜けが減った」というのは自分の作業での実感で、回数を数えて比べた結果ではありません。
下書きにはAIを使い、内容は自分の作業記録と照らして確かめています。
■ 案内
同じ「AIに任せる範囲を先に決めておく」考え方で、Claude Codeの権限設定(AIが触ってよいファイルや操作を決める設定)を作るサービスを出品しています。この出品の納品物は権限設定ファイルと手順書で、構文チェックのフックや作業ルールの文章は含みません。下のサービスをご覧ください。