ExcelにIB（投資銀行）モデル書式を自動適用する

朝、Googleタスクを開いたら昨日の積み残しが1件だけ残っていた。eurekapu-nuxt4のExcelファイルにIBフォーマットを適用する作業。ib-formatコマンドを叩いて、全シートの色が塗り変わるのを眺めていたら15分で終わった。

IBフォーマットの色分けルール

投資銀行の財務モデルでは、セルの中身が何者かをフォント色で即座に伝える。モデルを渡されたアナリストが数式バーを覗かなくても、色を見た瞬間にセルの性質を掴める。

フォント色	意味	具体例
青	ハードコード値（直接入力された数値）	売上高の前提値、成長率
黒	同一シート内で完結する計算式	`=B5*C5`
緑	他シートから参照している数式	`=IS!B10`
赤	外部ファイルへの参照	`=[外部.xlsx]Sheet1!A1`

この4色ルールは、IBモデルが「セルをクリックすれば参照先が追える」という透明性を最優先する設計思想から来ている。INDIRECT関数や名前付き範囲を避けるため、数式文字列中の ! の有無だけで他シート参照を機械的に判定できる。

作業の流れ

1. 積み残しタスクの確認

Googleタスクに「IBフォーマット適用」が1件残っていた。前日のCFWS差分レビュー作業の延長で、手修正済みの_KKサフィックス付きExcelにIBスタイルを当てる作業。

2. ib-formatコマンドの実行

Claude Codeの/ib-formatコマンドにExcelファイルを渡す。コマンドは以下の手順で動く:

ファイルの存在確認とシート構成の把握
各シートの全セルを走査し、値の種類を判定
判定結果に応じてフォント色を差し替え
ファイル名の_KKを_ibに変更して保存

判定ロジックの要所:

if cell.value and isinstance(cell.value, str) and cell.value.startswith('='):
    if '[' in cell.value:
        color = 'FF0000'   # 赤: 外部参照
    elif '!' in cell.value:
        color = '008000'   # 緑: 他シート参照
    else:
        color = '000000'   # 黒: シート内計算
else:
    color = '0000FF'       # 青: ハードコード値

cell.font.copy(color=...) を使うことで、フォントサイズや太字設定を壊さずに色だけ書き換える。

3. 適用結果の確認

コマンド実行後、シートごとの色分け統計が返ってきた:

シート	青（HC）	黒（式）	緑（他シート参照）
IS	多数	中程度	少数
BS	多数	中程度	中程度
CF	少数	多数	多数

CFシートで緑（他シート参照）が多いのは想定通り。キャッシュフロー計算書はIS・BSの数値を引っ張ってくるため、シート間参照が集中する。

4. ファイル名の変更

_KK（手修正版を示すサフィックス）を_ibに変更して保存。これで「IBフォーマット適用済み」であることがファイル名から一目でわかる。

なぜ自動化が破綻しないのか

IBモデルの設計規約が自動判定を支えている。投資銀行では以下の機能を意図的に避ける:

INDIRECT関数: 参照先が文字列に隠れて追跡できない
名前付き範囲: 定義を開かないと参照先がわからない
マクロ（VBA）: コードを開かないと処理が見えない
外部データ接続: セル上に数式が残らない

これらを使わないから、!の有無で他シート参照を判定するロジックが崩れない。「制約が自動化を可能にする」という構図がここにもある。

openpyxlの注意点

フォント色の変更自体は安全だが、openpyxlでファイルを開いて保存する行為自体に落とし穴がある:

ピボットテーブルが消える
スパークラインが消える
一部の条件付き書式が壊れる
配列数式（CSE）の扱いが不完全

自分たちのパイプラインで生成したExcelにはこれらが含まれないので問題ない。他人が作った複雑なExcelに当てるなら、バックアップを取ってから走らせる。

学びメモ

IBフォーマットの色分けは、4色の判定ロジックが30行に収まるほど単純。それでも誤判定が起きないのは、IBモデル自体が「数式の透明性」を設計原則として参照先を隠す機能を排除しているから
_KK → _ib のサフィックス変更は地味だが、ファイル名にステータスを埋め込む運用は複数人で触るExcelで効く。「このファイルは誰がどこまで手を入れたか」がエクスプローラー上で見える
15分で終わる作業を1日積み残していた。Googleタスクに残っていなかったら忘れていたかもしれない。タスク管理ツールが「忘却の穴」を塞いでくれた

振り返り

朝イチでGoogleタスクを開いて積み残しを拾い、ib-formatコマンドを走らせて、色が塗り変わったExcelをざっと眺めて閉じた。手を動かしていた時間は15分ほど。4月11日にopenpyxlで検証した「フォント色だけ安全に差し替えられるか」が、そのままコマンドとして形になっていた。検証から実用までの距離が短かったのは、IBモデルの設計規約が判定ロジックを単純に保ってくれたおかげだと思う。