会計入門講座のストーリー版づくり:サブエージェント並列と既存版の流用で進めた一日

開発eurekapu-nuxt4

会計入門講座のストーリー版づくり

自作の会計入門講座には、まだストーリー版が無かった。 ほかの講座にはもうある。 朝9時過ぎに「他のストーリー版と同じようにしてほしい」と頼み、既存のストーリー版の計画書を参考にして、Claude Code にまず計画書を書かせた。 制作はワークフローで回す前提にした。

この日は、新しく作るつもりで始めた。 途中から、既存のストーリー版から流用する作業のほうが増えていった。

計画書と判断4点

調査はサブエージェント2体に任せた。 報告(hand-back)が2体とも戻ってから、計画書に取りかからせた。 途中で、会計入門の電子書籍版の素材ファイルがクラウドストレージに残っていることも分かった。

計画書には、svg-diagram スキルで描いた図を入れた。 書き上がったら Codex でレビューさせ、判断が要る4点は計画書の HTML に3択ボタンで置かせた。 4点とも推奨案を選んだ。 音声については、図と文を自分で見て OK を出してから作る、という順番をコメントで足した(10時40分の回答)。

制作4体、検証5体

「y」と返すと、ワークフローの1段目が動き出した。 制作役のサブエージェント4体が並列に走った。 2段目では、5つの束に1体ずつ、計5体が検証に回った。

パンくずと SEO 用タイトルの修正は小さいので、並列には出さず、本体のセッションで済ませてもらった。 新しいルートを読み込ませるために dev サーバーを再起動させ、その間にユニットテストと eslint も流してもらった。 既存のストーリー版の表示が前と変わらないことも確かめてもらった。

コミットでは、別のセッションとぶつかった。 向こうのコミットが同じ瞬間に通って HEAD が動き、こちらはやり直しになった。 Codex のコミットゲートは指摘なしで通り、会計入門のストーリー版は表示できるところまで仕上がった。

「次は何ですか?」

「OK、次進んでほしいんですけど、次は何ですか?」と聞いた。 返ってきた答えは、次は自分のチェックだ、というものだった。 チェック表を手がかりに図と文が合っているかを見て、直す場所を決める段階である。

自分のチェックを待たずに進められる2つは、サブエージェント2体に並行して進めさせた。

  • 図と文のずれの直し案(確度「高」の11件と、まとまってずれている2か所から順に)
  • 読み上げの直し

push は6コミットになった。 自分のコミットは1件で、残り5件は別のセッションが同じ main に積んでいた検定対策講座のストーリー版と税効果のコミットだった。

読み上げの直しは、60件のうち36件を直した。 23件は原文の誤記や文の組み立ての問題で、読み方を変えても直らないので、本文を直すときに一緒に扱うことにした。 残りの1件は合成スクリプトのほうで直した。

「終わったら直し案を開いて見せて」と頼んでおいた。 直し案は HTML にまとめて Chrome で開いてもらい、図119枚がすべて表示されることを確かめさせた。

52件の表を前にして

開かれた直し案を見ても、どこで何を判断すればいいのか分からなかった。 「どこで私が見ればいいかわかんないんですけど」と、そのまま聞いた。

52件を表で1つずつ判断するのは重い、という返事だった。 そこで頼み方を変えた。 会計入門の内容は、一部なら検定対策講座のストーリー版をそのまま使えるはずだ。 判断に迷ったら、まずそちらに流用できる節がないかを確認するよう頼んだ。

113節中29節はそのまま使えた

流用の調査は、さきほどと同じ5つの束に分けて、5体のワークフローで回した。

最初に見つかったのは、仕訳が左右に分かれる理由を羊の移動で説明する箇所だった。 検定対策講座のほうに、ストーリー版用に作り直した6節がすでにあった。

5体の結果は次のとおり。

判定節数
検定対策講座版をそのまま使える29
一部使える74
対応する節がない10
合計113

各節の「いまの図」と「流用候補の図」を横に並べた比較ページも作らせ、図656枚がすべて表示されることを確かめさせた。

差し替えは、ストーリー版だけに効く仕組みにした。 差し替えたい節を指定ファイルに書いておくと、ストーリー版用の JSON を書き出すときに、その節だけが検定対策講座の節に入れ替わる。 通常版は元のままで、検定対策講座ですでに作ってある音声もそのまま鳴る。 まず羊の3節に当てさせ、画面で図と文が合っていて、「音声なし」の表示も出ないことを確かめてもらった。

ここで方針を一つ足した。 会計入門は、検定を受けない人向けに作っている。 あの検定は紙の帳簿を前提にしていて、そこに合わせたくないから、わざわざ別の入門講座を作った。 この方針を計画書に書き足させ、ずれのある節と、検定の話が出てくる節をまとめて差し替えた。

差し替えは全部で38件になり、テストは146件すべて通った。 ただ、画面で見ると、図は正しいのに文が前の節から付いてきている箇所があった。 そこは図だけを動かしたかったので、指定ファイルに各節の本来の文を戻させた。 コミットは一度 Codex のゲートで止まり、指摘を読ませたうえで通した。

短いトピックを1節にまとめる

13時50分、画面のスクリーンショットを貼って相談した。 あるチャプターでは、売上高、営業外収益、特別利益がそれぞれ別の節に分かれている。 ストーリー版で矢印キーを押して進むと、どの節も「1分の1」で終わってしまう。

これをつなぎたかった。 トピック名は、右側の字幕の列に見出しとして出す。 財務諸表講座のスマホ版で、○と縦線で見出しをつなぐ表示を採用していたので、それに合わせることにした。

まとめる作業はサブエージェントに任せた。 戻ってきた時点で、別のセッションのコミットがこの変更の一部だけを持っていってしまっていた。 残りのファイルをコミットして HEAD を整えさせてから、画面で確かめてもらった。 収益は1つの節になり、3つのトピック名が右の列に見出しとして並んだ。

報告が英語で返ってきたので、日本語で出し直してもらった。

抜け落ちていた例題の問題文

14時51分、貸付金の節のスクリーンショットを貼った。 「4分の6」という数字が出てくる。 取引を先に仕訳ではない形で見せ、そのあと例題で仕訳に進む流れの中の数字だと思った。 そこには問題文があったのではないか、と聞いた。

旧サイト、コースのデータ、電子書籍版のページ名を突き合わせてもらうと、問題文はあった。 旧サイトの Part 5 には、科目ごとに例題があり、5択の問題として問題文が入っていた。 いまのサイトへ移したときに、16ページ分の16問が落ちていた。

旧サイトにある16問は一字一句そのまま入れる、という進め方に「y」と返し、サブエージェントに戻させた。 最終的に、Part 5 の全26科目に例題の問題文が戻った。

簿記一巡の全体像と、巻き込んだ3ファイル

まとめの節にある「簿記一巡の全体像」は、横長のスライド版のままで見づらかった。 検定対策講座のほうの縦長の版に変えられるはずなので、差し替えを頼んだ。 STEP ごとに枠が光る図になり、テストは123件通った。 途中で Chrome DevTools の接続が切れたので、画面の確認は Playwright に切り替えさせた。

問題はコミットで起きた。 ステージしたのは5ファイルなのに、コミットには8ファイル入っていた。 いったんは「このままで困らない」という見立てのまま、push まで進めた。

あとで中身を確かめてもらうと、巻き込んだ3ファイルは、検定対策講座のストーリー版の「チャプター列の番号の丸」を消す内容だった。 この機能は、別のセッションが直前に入れたばかりのものだった。 origin でも、いったんこの機能が消えていた。 3ファイルを元に戻してもらい、origin/main に番号の丸が入っていることを確かめてもらった。 「結局問題は解消したってことでいいんですか?」と聞いて、解消を確認した。

残ったのは自分の確認と音声

夕方、「このセッションでもう積み残し事項ってないんでしたっけ?」と聞いた。 作業としての積み残しは無く、残りは自分の確認と判断待ちだけ、という返事だった。

続けて「計画書は全部完了してるんでしたっけ」と聞くと、まだだった。 作る作業は終わっていて、残っているのは自分の確認と、そのあとの音声である。 終わっていたのに印が付いていなかった16件にチェックを入れ、計画書を実際の状態に合わせさせた。

そのあと、パソコンのメモリが足りなくなり、dev サーバーが止められた。 メモリがまだ足りない可能性があるので、起動し直すタイミングはこちらで決めることにした。 16時50分の時点のまとめを計画書の進捗に書き足させ、引き継ぎのプロンプトはダウンロードフォルダにテキストファイルで書き出させた。

学び

  • 図と文のずれを52件の表で1件ずつ判断しようとすると、どこを見ればいいのかすら分からなかった。既存のストーリー版から流用できる節を先に洗い出させると、113節中29節はそのまま、74節は一部を使えると分かった
  • 同じ main を別のセッションと共有していると、コミットに他人の変更が混ざる。ステージした5ファイルとコミットされた8ファイルの差が合図だったのに、確かめないまま push して、他の講座の機能を一時的に消した
#Claude Code#サブエージェント#ワークフロー#教材制作#SVG図解