所得税の記載例を Excel ブックで申告書の様式に描く:帳票61枚の全数確認と決算書の部品化

開発eurekapu-nuxt4

所得税の記載例を Excel ブックで申告書の様式に描く:帳票61枚の全数確認と決算書の部品化

Excel-Books の中に、所得税の記載例を組んだブックが14冊ある。 書籍の記載例12件と、収支内訳書の2件である。 この日は、その帳票を申告書風(国税庁の様式に似せた紙面)でも開けるようにする作業に、セッションを5本使った。

朝のセッションの終わりには、61枚の帳票がどれも A4 に収まり、はみ出しもコンソールのエラーも0になった。 その画面を見て返したフィードバックの1件目は、所得控除の計算のシートに残っていた、第一表へ値を渡すためだけの表のことだった。

61枚を5組に分けて作らせる

最初に、14冊の帳票を洗い出し、既存の様式と突き合わせてもらった。 記載例のページも画像にして、様式の形を確かめてもらった。 計画書にした帳票は61枚である。

Codex のレビューに出すと、指摘が2件返ってきた。 比較表のセルを拾ってしまう危険と、配偶者の行の取り違えである。 どちらも妥当な指摘で、計画を直してもらった。 再レビューでは「実装に進めてよい」と返ってきた。 判断の2件は、推奨つきのフォームで答えた。

土台は、書籍の欄と紙面の欄をつなぐ対応表の道具である。 第一表と第二表の紙面には、年分の版(令和5年分と令和7年分)を切り替える引数を足させた。 27冊の描画は変えない形にし、これまでの申告書風のテスト63件も通った。

この段階では、Claude Code の作業に小さなつまずきが2つあった。 置換のテキストが書き込まれず、Write ツールに切り替えた。 ループの引数を分けたら余計なファイルが3つでき、中身を見てからその3つだけを消した。

既存の様式で描ける28枚は、書籍の欄の取りこぼし0で対応表ができた。 残りは新しい様式が要る。 サブエージェントに渡す前に、検査の道具を用意させた。 書籍の欄が対応表に載るか、対応表の欄が紙面に描かれるかを機械で見る道具である。 国税庁の様式の PDF も、本物が取れた。

組帳票枚数
A第三表と第四表8
B明細書類7
C譲渡関係8
D株式関係6
E収支内訳書4

2組ずつ走らせ、1組が終わるたびに空いた枠で次の組を立ち上げさせた。 終わった組は、テストと Chrome の画面で親のセッションにレビューさせた。

レビューでは、細かい直しがいくつか出た。 組 A の分では、第四表(二)の定義に spanRows を足させた。 組 B の分では、⑥のブックの契約区分が空になっていた。 組 D の報告にあった失敗は、テストが本体のセルを集めるときに、新しく足した literal の指定を渡していなかったためだった。 直したのはテストのほうである。 計画書で組 C を「7枚」と書いていたのも数え違いで、正しくは8枚だった。

途中、Chrome のスクリーンショットが返ってこない時間があった。 待つ間は、組 B のサブエージェントが撮ったスクリーンショットを先に見させた。

61枚を全部撮って確かめる

5組がそろい、関係する4ファイル273件のテストが通ってから、61枚を全部撮らせた。 1回目は上限の数え方を誤っていた。 紙面だけでなく、ブックごとのコンソールの記録まで数えていた。 紙面だけを数えるように直して流し直すと、はみ出しも空の欄もコンソールのエラーも、61枚とも0だった。

撮った画像は6枚ずつまとめて、目でも見させた。 自分の Chrome でもエミュレーションをかけて測らせた。 終わったら解除し、元の幅(3072px)に戻ったことまで確かめさせた。

全体のテストは別のセッションが流している

型チェックのエラーは0だった。 続けて全体のテスト(約13分)を裏で流させていたところで、止めてもらった。 全体のテストは、別のセッションが流している。 このセッションでは必要なところだけ流したほうがいい、と伝えた。

ほかのセッションの vitest を巻き込まないよう、自分のセッションが起動したプロセスを特定してから止めさせた。 変更が効くのは、所得税の申告書風、記載例、棚(テーマ)を読むテストの11ファイルである。 流すと、7,810件が全部通った。

コミットも、ステージに自分の20ファイルだけが入ったのを確かめてからにした。 Codex のコミットレビューでは、critical と high の指摘は出なかった。

コミットのあと、無限キャンバスでも見た。 帳票は申告書風のカードで並び、ほかのシートからの線も引かれていた。

テストが本当にずれを捕まえるかも試させた。 最初のずらし方では、番号と金額の欄が一緒に動き、ずれにならなかった。 番号の書き方だけを1つずらす形に変えた。 (85) と (86) の値が入れ替わった状態をテストが捕まえるのを見てから、元に戻した。 このテストを2つ目のコミットに入れ、フィードバックを返すための引き継ぎのセッションを立てた。

「行ったり来たりして邪魔」

引っかかったのは、所得控除の計算のシートの下にある「第一表の欄」の表だった。 この表は、各控除の表で出した控除額をもう一度写して集計し直しており、第一表はこの表から値を受けていた。 画面を見ながら、「行ったり来たりして邪魔なんですけど、省略できないですかね」と伝えた。

①から⑪の11ブックで、写すだけの行を130行消させた。 第一表は、各控除の表の控除額を直接写す形になった。 ⑫は対象の表が無く、収支内訳書の2冊は計算のシートが無いので変えていない。 直す前と後で全9,368セルを突き合わせ、値が変わったセルは0件だった。

同じことを繰り返さないように、Excel でやってはいけないことをまとめた excel-donts スキルに、この決まりを足させた。

税額の計算にも、㊶ = ㉛ のように同じ額を写すだけの行があった。 これも続けて消すことにし、11ブックで27行を消させた。 値の変わったセルは、ここも0件だった。

同じセッションで、本番の容量も確かめてもらった。 専用の worktree で本番と同じ手順のビルドだけを流すと(デプロイはしていない)、Worker 全体は 1.843 MiB(上限 3.0 MiB)だった。 所得税の紙面のコードは本番の Worker に載っておらず、分ける必要はなかった。

14件の記載例を論点マップにまとめる

13時台のセッションでは、記載例の書き起こしを読んで、計画書の §8(記載例の論点マップと人物像)を書かせた。 まず①の分だけを書かせた。 ブラウザで該当の箇所を開いてもらい、形を見てから残りを進めた。 このセッションの Chrome DevTools は、3回目でつながった。

残りの下書きは、2体のサブエージェントに分けて書かせた。 ②から⑦と、⑧から⑫および収支内訳書である。 その間に、照合用の小さなスクリプトを書かせた。 各事例の家族の年齢(2023年12月31日時点)と、第一表の値を並べて出すものである。 1回目は文字化けした。 -I を付けて走らせると文字コードの設定が無視されるためで、-I を外して走らせた。

下書きは書き起こしと突き合わせてもらった。 最後に、13の節にあるカンマ付きの金額を、すべてその事例の書き起こしで引き直させた。 14件中14件(記載例12件、収支内訳書2件)を §8 にまとめて、コミットした。

決算書を事業所得用と不動産所得用に分ける

15時台のセッションでは、①の決算書を事業所得用(一般用)と不動産所得用に分ける計画を立てた。 既存の令和3年分の紙面(決算書と不動産所得用、各4ページ)が使い回せるかも確かめてもらった。

実際の帳簿データは、形だけを確かめた。 会計ソフトAの残高試算表は読むだけで開き、列と科目の並びを見させた。 税務申告ソフトが出力した決算書の PDF でも、ページの並びだけを見させた。 計画書とブックに入れたのは、仮の値と書籍の記載例だけである。 実データの値は入れていないので、計画書はそのまま Codex のレビューに出した。

判断は4件あった。 値の流れの図と、判断ごとの Before/After を計画書に描かせ、フォームで答えた。 4件とも推奨のとおりにした。

実装では、償却率を書籍の別表第八で確かめさせた。 科目計の表は、SUMIFS と足し算が混ざらないように分けさせた。 新しいテスト184件と描画まわりのテスト84件が通ったあと、xlsx に書き出して Excel で全再計算させた。 座標192件と検算91件がすべて一致し、エラー、####、外部リンクはどれも0だった。

判断の4件目は、⑤と⑪は①を見てから決める、というものだった。 コミットのあと、⑤と⑪もおそらく同じ形にすると返し、あわせて push を頼んだ。 出ていった80コミットのうち79は、ほかのセッションがすでにコミットしていた分だった。 ⑤と⑪の作業は、引き継ぎのセッションを立てて渡した。

⑤と⑪で決算書を部品に切り出す

夕方のセッションで、⑤と⑪の計画書を書かせた。 Codex のレビューでは、致命的な指摘が1件(⑪の参照の直し漏れ)出て、計画に反映させた。

決裁フォームを Chrome で確かめようとしたら、DevTools の接続がタイムアウトした。 3回つながらず、既定のブラウザで開いて配信された HTML の中身を機械で確かめる方法に切り替えた。 最後は、リポジトリの Playwright でフォームの描画を確かめた。 同じ症状の issue は、その日すでに立っていた。

判断の3件は、これも一旦推奨のパターンで構わない、と伝えた。 決算書の部分は、部品のファイル(kessan.ts)に切り出させた。 先に①をこの部品を使う形に直させ、切り出す前と後で設計図を突き合わせると、完全に同じだった。 そのうえで⑤と⑪を書き換えさせた。

撮影では2つ引っかかった。 ⑪だけ、左の一覧にシートが出なかった。 開いた直後の画面を撮って、原因を調べさせた。 そのあとの撮影では、⑪の紙面も撮れている。 もう1つは、紙面がスクロールの枠で切れて写ることだった。 画面を大きくして、紙面の下端と右端まで撮り直させた。

関係するテスト1,024件、Excel の再計算(3ブック)、型チェックのエラー0件までそろえて、コミットした(push はしていない)。 書籍の正解との照合は全部一致し、検算はすべて0だった。 依頼文の指定は Opus 5.5 だったが、このセッションの実行モデルは Fable 5.2 で、計画書の状態の欄にもそう書かせた。

学び

  • 写すだけの行を消すときは、直す前と後で全セルを突き合わせると、値が変わっていないことを件数で言える。9,368セルで0件だった。
  • 全体のテストを別のセッションが流しているときは、自分のセッションでは変更が効く範囲だけを流す。この日は11ファイル7,810件で済んだ。
  • 実データは形(列と科目の並び)だけを読んで確かめ、計画書とブックには仮の値と記載例だけを入れる。そうしておけば、計画書をそのまま外部のレビューに出せる。
#確定申告#所得税#Excel#Claude Code#サブエージェント#テスト