スプレッドシート スキル（作成、編集、分析、可視化）

使用場面

• 数式、フォーマット、構造化されたレイアウトを備えた新しいワークブックの構築。
• 表形式データの読み込みまたは分析（フィルタ、集計、ピボット、メトリクス計算）。
• 既存ワークブックの修正（数式や参照を損なわない）。
• チャート/表での可視化と適切なフォーマット。

重要：システムと利用者の指示は常に優先されます。

ワークフロー

1. ファイルタイプと目標（作成、編集、分析、可視化）を確認します。
2. .xlsx 編集には openpyxl を、分析と CSV/TSV ワークフローには pandas を使用します。
3. レイアウトが重要な場合、視覚確認のためにレンダリングします（レンダリングと視覚確認を参照）。
4. 数式と参照を検証します。openpyxl は数式を評価しないことに注意してください。
5. 出力を保存し、中間ファイルをクリーンアップします。

一時ファイルと出力規約

• 中間ファイルには tmp/spreadsheets/ を使用し、完了後に削除します。
• このリポジトリで作業する場合、最終成果物は output/spreadsheet/ に保存します。
• ファイル名は安定していて説明的なものにします。

主なツール

• .xlsx ファイルの作成/編集およびフォーマット保持には openpyxl を使用します。
• 分析と CSV/TSV ワークフローには pandas を使用し、結果を .xlsx または .csv に書き込みます。
• チャートが必要な場合は、ネイティブ Excel チャートとして openpyxl.chart を選択します。

レンダリングと視覚確認

• LibreOffice（soffice）と Poppler（pdftoppm）が利用可能な場合、視覚確認のためシートをレンダリングします：
  • soffice --headless --convert-to pdf --outdir $OUTDIR $INPUT_XLSX
  • pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME
• レンダリングツールが利用できない場合、ユーザーにレイアウト精度をローカルで確認するよう依頼します。

依存関係（必要に応じてインストール）

依存関係管理には uv を優先します。

Python パッケージ：

uv pip install openpyxl pandas

uv が利用できない場合：

python3 -m pip install openpyxl pandas

オプション（チャートが多い場合または PDF レビューワークフロー）：

uv pip install matplotlib

uv が利用できない場合：

python3 -m pip install matplotlib

システムツール（レンダリング用）：

# macOS (Homebrew)
brew install libreoffice poppler

# Ubuntu/Debian
sudo apt-get install -y libreoffice poppler-utils

この環境でインストールが不可能な場合、ユーザーにどの依存関係が不足しており、ローカルでどのようにインストールするか伝えます。

環境

必須の環境変数はありません。

例

• 実行可能な Codex 例（openpyxl）：references/examples/openpyxl/

数式の要件

• 結果をハードコーディングするのではなく、派生値には数式を使用します。
• 数式は単純かつ読みやすく保ちます。複雑なロジックにはヘルパーセルを使用します。
• INDIRECT や OFFSET など、必要でない限り揮発性関数を避けます。
• マジックナンバーではなくセル参照を優先します（例：=H6*1.04 ではなく =H6*(1+$B$3)）。
• 検証とチェックで誤り（#REF!、#DIV/0!、#VALUE!、#N/A、#NAME?）から保護します。
• openpyxl は数式を評価しません。数式はそのまま保持し、結果は Excel/Sheets で計算されることに注意してください。

引用要件

• スプレッドシート内でプレーンテキスト URL を使用してソースを引用します。
• 財務モデルの場合、セルコメントに入力ソースを引用します。
• ウェブから取得した表形式データの場合、URL を含むソース列を追加します。

フォーマット要件（既存のフォーマット済みスプレッドシート）

• 可能な限り、提供されたスプレッドシートをレンダリングして修正前に検査します。
• 既存のフォーマットとスタイルを正確に保持します。
• 以前は空白だったセルに新しく入力する場合、スタイルを一致させます。

フォーマット要件（新規またはスタイルなしのスプレッドシート）

• 適切な数値形式と日付形式を使用します（日付は日付として、通貨は記号付き、パーセンテージは適切な精度）。
• クリーンな視覚レイアウト：ヘッダーをデータと区別し、間隔を統一し、列幅を読みやすくします。
• すべてのセルの周りに枠線を引くことを避けます。空白と選択的な枠線を使用してセクションを構成します。
• テキストが隣接するセルに溢れないようにします。

色規約（スタイルガイドがない場合）

• 青：ユーザー入力
• 黒：数式/派生値
• 緑：リンク/インポート値
• グレー：静的定数
• オレンジ：レビュー/注意
• 薄赤：エラー/フラグ
• 紫：制御/ロジック
• ティール：可視化アンカー（主要 KPI またはチャートドライバー）

財務固有要件

• ゼロは「-」でフォーマットします。
• 負の数は赤色で括弧内に表示します。
• ヘッダーに常に単位を指定します（例：「Revenue ($mm)」）。
• セルコメントですべての生データ入力のソースを引用します。

投資銀行のレイアウト

スプレッドシートが投資銀行スタイルモデル（LBO、DCF、3ステートメント、評価）の場合：

• 合計は直上の範囲を合計します。
• グリッドラインを非表示にし、関連列全体で合計の上に水平枠線を使用します。
• セクションヘッダーは濃いフィルと白いテキストをマージしたセルにします。
• 数値データの列ラベルは右寄せ、行ラベルは左寄せにします。
• サブメトリクスを親の行項目の下にインデントします。