所得税の記載例を Excel ブックで申告書の様式に描く:帳票61枚の全数確認と決算書の部品化
所得税の記載例を 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件で済んだ。
- 実データは形(列と科目の並び)だけを読んで確かめ、計画書とブックには仮の値と記載例だけを入れる。そうしておけば、計画書をそのまま外部のレビューに出せる。