Codex や Claude Code に実際の作業を任せる例として、予測モデルをつくるまでを Kindle の本『AIエージェントで機械学習をスキルにする』にまとめています。本日(11月16日)17時まで、無料で読めます
最終回です。第6回の最後に「この連載も、実は2つのAIに役割を分けて作っています。その舞台裏は第8回で」と予告しました。今回はその種明かしをして、連載を締めくくります。
この連載の原稿は、第5回から、GitHubのリポジトリの上で書いてきました。Issueで依頼を記録し、ブランチで書き、プルリクエストで確かめてから取り込む。第4回から第7回で紹介した手順を、そのまま原稿づくりに使っています。
リポジトリは非公開なので、そのまま見ていただくことはできません。代わりに、残っている記録を本文で引用します。日付や番号は、すべて記録のとおりです。
誰が何をしたのか
登場するのは、私(著者)と、第7回で紹介した2つのAIの道具です。
| 担当 | やったこと |
|---|---|
| 著者 | 回ごとのテーマと方針を決める。AIのレビューの指摘を採るかどうか決める。マージのボタンを押す |
| Claude Code | 原稿と編集メモを書き、修正を記録(コミット)して、プルリクエストを出す |
| Codex | プルリクエストを自動でレビューする。work-notes で操作して画面を撮影し、ボタンの表記を照らし合わせる |
骨子の相談や原稿の読み合わせには、チャットのAIも使いました。
数字で見ると、こうなります。リポジトリを作った10月17日から、第7回をマージした11月14日までの記録です。
- 連載のために立てた Issue は6件、プルリクエストも6件
- 原稿と編集メモの記録(コミット)は15件。すべて Claude Code が書いたか、Claude Code と共同で書いたもの
- Codex の自動レビューが付けた指摘は4件。そのうち3件は本文を直し、1件は理由を書いて見送った
- マージは6件。すべて著者が押した
第5回からの原稿の文章を書いたのは、主に Claude Code です。そのかわり、6回のマージは、1回もAIに任せていません。
書く役と確かめる役を、別のAIに分けたのには理由があります。自分で書いたものを自分で確かめると、見落としが出やすいからです。人のチームで「書く人」と「確かめる人」を分けるのと同じ考え方です。AIでも、書いた本人に見直させるより、別のAIに読ませたほうが、違う角度の指摘が返ってきます。
記録で見る4つの場面
うまくいった場面だけを並べても、種明かしになりません。失敗した場面も含めて、4つ紹介します。
指摘が残ったまま、マージしてしまった(第5回、PR #2)
第5回の原稿を出したのは、10月18日の朝です。プルリクエストを作ってから5分後に、私はマージしていました。
その間に、Codex のレビューが1件の指摘を付けていました。
Issueでは「担当部署を書く」と「連絡方法を書く」の2項目を依頼していますが、この手順でREADMEに追加するのは部署名だけです。
第5回の練習では、Issueのチェック項目を2つ作ります。ところが、READMEに書き足すのは部署名の1行だけで、「連絡方法」はどこにも出てきません。それなのに、最後に2つともチェックを入れるよう案内していました。
指摘に気づいたのは、マージしたあとです。あらためて Issue #3 を立て、別のプルリクエスト(#4)で直しました。元の指摘には「修正は次のプルリクエストで行いました」と、直した場所のリンクを付けて返信しています。
第4回で、片付いた指摘は「Resolve conversation(解決済みにする)」で畳む、と紹介しました。未解決の指摘だけが残るので、確認漏れを防げる、とも書きました。その確認をせずにマージしたのが、この場面です。マージのボタンを押す前に、Conversation のタブに未解決の指摘が残っていないかを見る。書いた本人が、いちばんよく分かった教訓です。
指摘を受けて、直して、返信する(第6回、PR #8)
第6回では、同じ流れがうまく回りました。Codex の指摘はこうです。
GitHub Desktop がバックグラウンドで取得を済ませていると、ブラウザで変更した後に戻った時点でボタンはすでに「Pull origin」になっており、この「Fetch origin」を押す手順を実行できません。
本文は「Fetch origin を押すと、ボタンが Pull origin に変わる」という前提で書いていました。実際には、最初から Pull origin が出ていることがあります。Claude Code が「すでにボタンが Pull origin になっている場合は、そのまま押してください」という一文を足して記録し、指摘に返信しました。
ご指摘ありがとうございます。155727f の修正で対応しました。
155727f は、その修正の記録(コミット)に付いた番号です。番号があるので、どの修正で対応したのかを、あとから誰でもたどれます。指摘、修正、返信、解決済み。第4回で紹介した流れの、お手本のような往復でした。
撮影を途中でやめた(第6回)
第4回から第6回の画面の画像は、Codex に撮影を頼みました。練習用の work-notes リポジトリで実際に操作し、画面を撮り、ボタンの表記が本文と合っているかを表にまとめて報告してもらう、という頼み方です。
第5回の報告には、こんな一文がありました。
指定の必須条件を満たしていないため、完成版としての掲載は推奨しません。(中略)画面の合成・文字の書き換えは行っていません。
6枚のうち1枚は、ボタンの文字が途中で切れていました。Codex はそれを隠さず、使わないほうがよいと書いてきました。こういう報告があると、人は判断に集中できます。
第6回では、撮影そのものが止まりました。Codex が GitHub Desktop のサインインを最後まで通せず、非公開の work-notes をクローンできなかったのです。何度も試してもらう手もありましたが、私は撮影を打ち切ると決めました。第6回の画像が1枚だけなのは、そのためです。手順は文章だけで追えるように、Claude Code に書き直してもらいました。
途中までの報告にも、収穫はありました。Codex が見た Windows の画面では、クローンの保存先の初期値が OneDrive の中のフォルダだったのです。第6回の「同期フォルダは避ける」という注意に、「筆者の Windows では」という実例を書き足せたのは、この報告のおかげです。
指摘を採ったものと、見送ったもの(第7回、PR #13)
第7回は、AIに作業を任せるときの「お願い」と「鍵」の話でした。Claude Code の設定で .env を読ませないようにできる、と書いた箇所に、Codex がいちばん重い指摘(P1)を付けました。
Read拒否ルールだけでは秘密ファイルを隔離できないことを明記する
読ませない設定が止めるのは、Claude Code が直接ファイルを読む操作だけです。別のプログラムを通して読む道は残ります。鍵の大切さを書いた記事で、鍵の抜け道を、別のAIが見つけたことになります。この指摘は採り、本文に「読ませない設定にも抜け道があり、置かないことの代わりにはならない」と書き足しました。
同じレビューには、もう1件の指摘がありました。脚注の Codex の日本語のページが、開けない(404)というものです。ブラウザで開き直してみると、どちらのページも問題なく表示されました。そこで本文は直さず、確かめた日付と結果を書いて返信しました。
AIの指摘も、そのまま受け入れるとは限りません。確かめて、採るか見送るかを決める。見送ったときは理由を残す。第7回の「判断は受け取る側の仕事」を、レビューを受け取る側としても実践した場面です。
第1回の佐藤さんに、足りなかったもの
第1回では、会議まであと10分の佐藤さんを描きました。手元にファイルはすべてそろっているのに、どれを使ってよいか判断できない。足りなかったのは、ファイル同士の関係を示す記録だ、という話でした。そのとき挙げた5つの問いに、連載で扱った道具を当てはめると、こうなります。
| 第1回の問い | 答えてくれる道具 | 扱った回 |
|---|---|---|
| 今回使うべき版はどれか | main(リポジトリの本体) | 第3回、第4回 |
| 前に確かめた版から、何が変わったのか | History(履歴)と差分 | 第3回 |
| 別々に行った修正を、どう一つにまとめるか | ブランチ、プルリクエスト、プル | 第4回、第6回 |
| その変更は、どんな依頼や相談から生まれたのか | Issue | 第5回 |
| 誰が、どの版で、何を確かめたのか | プルリクエストのコメントとレビュー | 第4回、第7回 |
この連載のリポジトリにも、5つの答えがそのまま残っています。第5回の練習の手順がなぜ変わったのかは、PR #2 の指摘と PR #4 の修正を見れば分かります。第7回の「抜け道」の一文がいつ、なぜ入ったのかも、PR #13 の記録に書いてあります。
第1回の仮説への、私なりの答え
第1回で、こんな仮説を立てました。
GitHubの基礎は、かつてのExcelのように、ビジネスパーソンの仕事の技能のひとつになっていくのではないか。
8回書き終えて、仮説は仮説のままです。それでも、手応えはありました。
この連載で、手を動かした量がいちばん多いのはAIです。原稿を書いたのも、画面を撮ったのも、レビューしたのも、主にAIでした。私がしたのは、依頼を書くこと、差分と指摘を読むこと、そして取り込むかどうかを決めることです。どれもコードを書く力は要りません。それでも、ここを人が手放すと、PR #2 のように確かめないまま取り込むことになります。
AIが手を動かす時代のGitHubの技能は、操作を覚えることより、記録を読んで判断することに近いのだと思います。Excelの関数をすべて覚えていなくても、表の数字がおかしいことに気づける人が頼りにされてきたのと同じです。
第1回で書いたとおり、これは GitHub という特定のサービスの話ではありません。依頼を記録し、変更を案として出し、確かめてから取り込む。この流れは、どの道具に移っても使えます。
次の一歩として
この連載は、私が書いたKindle本の前段として始めたものです。
『AIエージェントで機械学習をスキルにする』
【不動産鑑定士が教える、Codex・Claude Codeで予測モデルをつくるAIコーディング入門】
https://www.amazon.co.jp/dp/B0HR1XKM3J
本では、非エンジニアの主人公が、AIの道具(本文は Codex、付録で Claude Code)と一緒に、中古マンションの取引価格を説明する予測モデルを作り、それを「スキル」として仕上げます。GitHubの操作は本には書かず、この連載に任せました。
本で使うコード一式と教材のデータは、GitHubの公開リポジトリ(signal-yield/ml-skill-book)で配っています。第6回で練習したクローンが、そのまま使えます。第7回の「お願い」と「鍵」も、本の作業でそのまま役に立つはずです。
11月16日(月)の16時59分(日本時間)まで、Kindleで無料で読めます。そのあとも、Kindle Unlimited の会員なら追加料金なしで読めます。
8回にわたって、お付き合いいただきありがとうございました。最初は「知らないWebサービスに、成果物を置く理由が分からない」から始まった連載でした。この記事が、どこかの佐藤さんの、会議前の10分を少しでも楽にできたらうれしいです。