XLSX Generator

このスキルを使う場合

以下の場合に このスキルを使用します：

• データや仕様からプログラム的にExcelスプレッドシートを作成する
• ブランド化されたテンプレートを動的コンテンツで埋める（フォーマットは保持）
• 既存のXLSXファイルからセルデータ、数式、構造を抽出する
• {{TITLE}} や ${date} などのプレースホルダーテキストをセル内で検索・置換する
• スプレッドシート生成ワークフロー（レポート、データエクスポート、財務諸表）を自動化する

このスキルを使わないでください：

• ユーザーがスプレッドシートを開く/表示したい場合（ネイティブExcelまたはビューアを使用）
• 複雑なピボットテーブルやグラフが必要な場合（サポートが限定的）
• 旧式の.xls形式で作業する場合（XLSXのみ対応）
• リアルタイムの共同編集が必要な場合

必要な環境

• Deno がインストール済み (https://deno.land/)
• テンプレート操作用の入力 XLSX ファイル
• ゼロから生成する場合の JSON 仕様

クイックスタート

2つの動作モード

1. テンプレートモード: 既存のブランド化されたテンプレートを変更

   • テンプレートを分析してプレースホルダーと構造を検出
   • {{PLACEHOLDERS}} を実際の値で置換

2. ゼロから作成モード: JSON 仕様を使用してスプレッドシートを最初から作成

使用方法

モード 1: テンプレートベースの生成

ステップ 1a: テンプレートを分析

セルインベントリを抽出して、何を置換できるかを把握します：

deno run --allow-read scripts/analyze-template.ts financial-template.xlsx > inventory.json

出力 (inventory.json):

{
  "filename": "financial-template.xlsx",
  "sheetCount": 3,
  "sheets": [
    {
      "name": "Summary",
      "rowCount": 25,
      "colCount": 8,
      "usedRange": "A1:H25",
      "cells": [
        { "address": "A1", "row": 1, "col": 1, "value": "{{REPORT_TITLE}}", "type": "string" },
        { "address": "B3", "row": 3, "col": 2, "value": "{{DATE}}", "type": "string" },
        { "address": "C5", "row": 5, "col": 3, "value": null, "type": "number", "formula": "SUM(C6:C20)" }
      ]
    }
  ],
  "placeholders": [
    { "tag": "{{REPORT_TITLE}}", "location": "Summary!A1", "sheet": "Summary", "address": "A1" },
    { "tag": "{{DATE}}", "location": "Summary!B3", "sheet": "Summary", "address": "B3" }
  ],
  "hasFormulas": true
}

ステップ 1b: 置換仕様を作成

replacements.json を作成します：

{
  "textReplacements": [
    { "tag": "{{REPORT_TITLE}}", "value": "Q4 2024 Financial Report" },
    { "tag": "{{DATE}}", "value": "December 15, 2024" },
    { "tag": "{{COMPANY}}", "value": "Acme Corporation", "sheets": ["Summary", "Cover"] }
  ],
  "cellUpdates": [
    { "sheet": "Data", "address": "B5", "value": 1250000 },
    { "sheet": "Data", "address": "B6", "value": 750000 }
  ]
}

ステップ 1c: 出力を生成

deno run --allow-read --allow-write scripts/generate-from-template.ts \
  financial-template.xlsx replacements.json output.xlsx

モード 2: ゼロから生成

ステップ 2a: 仕様を作成

spec.json を作成します：

{
  "title": "Sales Report",
  "author": "Finance Team",
  "sheets": [
    {
      "name": "Sales Data",
      "data": [
        ["Product", "Q1", "Q2", "Q3", "Q4", "Total"],
        ["Widget A", 10000, 12000, 15000, 18000, null],
        ["Widget B", 8000, 9000, 11000, 13000, null],
        ["Widget C", 5000, 6000, 7000, 8000, null]
      ],
      "cells": [
        { "address": "F2", "formula": "SUM(B2:E2)" },
        { "address": "F3", "formula": "SUM(B3:E3)" },
        { "address": "F4", "formula": "SUM(B4:E4)" }
      ],
      "columns": [
        { "col": "A", "width": 15 },
        { "col": "B", "width": 10 },
        { "col": "C", "width": 10 },
        { "col": "D", "width": 10 },
        { "col": "E", "width": 10 },
        { "col": "F", "width": 12 }
      ],
      "freezePane": "A2",
      "autoFilter": "A1:F4"
    }
  ]
}

ステップ 2b: スプレッドシートを生成

deno run --allow-read --allow-write scripts/generate-scratch.ts spec.json output.xlsx

例

例 1: 月間売上レポート

シナリオ: テンプレートから月間売上レポートを生成します。

ステップ:

# 1. テンプレートを分析して置換可能なコンテンツを検出
deno run --allow-read scripts/analyze-template.ts sales-template.xlsx --pretty

# 2. replacements.json を月次データで作成
# 3. レポートを生成
deno run --allow-read --allow-write scripts/generate-from-template.ts \
  sales-template.xlsx replacements.json November-Sales.xlsx

例 2: 計算値を含むデータエクスポート

シナリオ: 計算合計を含むスプレッドシートを作成します。

spec.json:

{
  "sheets": [{
    "name": "Expenses",
    "data": [
      ["Category", "January", "February", "March", "Total"],
      ["Office", 1500, 1600, 1400, null],
      ["Travel", 3000, 2500, 4000, null],
      ["Software", 500, 500, 500, null],
      ["Total", null, null, null, null]
    ],
    "cells": [
      { "address": "E2", "formula": "SUM(B2:D2)" },
      { "address": "E3", "formula": "SUM(B3:D3)" },
      { "address": "E4", "formula": "SUM(B4:D4)" },
      { "address": "B5", "formula": "SUM(B2:B4)" },
      { "address": "C5", "formula": "SUM(C2:C4)" },
      { "address": "D5", "formula": "SUM(D2:D4)" },
      { "address": "E5", "formula": "SUM(E2:E4)" }
    ]
  }]
}

例 3: 複数シートのワークブック

シナリオ: サマリーシートと詳細シートを含むワークブックを作成します。

spec.json:

{
  "title": "Q4 Report",
  "sheets": [
    {
      "name": "Summary",
      "data": [
        ["Department", "Budget", "Actual", "Variance"],
        ["Sales", 500000, 520000, null],
        ["Marketing", 200000, 195000, null]
      ],
      "cells": [
        { "address": "D2", "formula": "C2-B2" },
        { "address": "D3", "formula": "C3-B3" }
      ]
    },
    {
      "name": "Sales Detail",
      "data": [
        ["Month", "Revenue", "Cost", "Profit"],
        ["October", 180000, 120000, null],
        ["November", 170000, 115000, null],
        ["December", 170000, 110000, null]
      ],
      "cells": [
        { "address": "D2", "formula": "B2-C2" },
        { "address": "D3", "formula": "B3-C3" },
        { "address": "D4", "formula": "B4-C4" }
      ]
    }
  ]
}

スクリプトリファレンス

スクリプト	目的	パーミッション
analyze-template.ts	XLSX からセル、数式、プレースホルダーを抽出	--allow-read
generate-from-template.ts	テンプレートのプレースホルダーを置換	--allow-read --allow-write
generate-scratch.ts	JSON 仕様から XLSX を作成	--allow-read --allow-write

仕様リファレンス

シートオプション

プロパティ	型	説明
name	string	シート名
data	array	A1 から始まる 2D 配列のセル値
cells	array	個別セルの仕様
rows	array	行ベースのデータ仕様
columns	array	列幅と表示設定
merges	array	結合セルの範囲
freezePane	string	このセルでペインを固定 (例: "A2")
autoFilter	string	オートフィルター範囲 (例: "A1:F10")

セルオプション

プロパティ	型	説明
address	string	セルアドレス (例: "A1", "B2")
value	mixed	セル値 (文字列、数値、ブール値、null)
formula	string	= 記号なしの数式
format	string	数値形式 (例: "#,##0.00")
type	string	型を強制: "string", "number", "boolean", "date"

列オプション

プロパティ	型	説明
col	string	列文字 (例: "A", "B", "AA")
width	number	列幅（文字単位）
hidden	boolean	列を非表示

テンプレート置換オプション

プロパティ	型	説明
tag	string	検索するプレースホルダー (例: "{{TITLE}}")
value	mixed	置換値
sheets	array	特定のシートに限定
range	string	セル範囲に限定 (例: "A1:D10")

よくある問題と解決方法

問題: プレースホルダーが置換されない

症状: 出力 XLSX に {{PLACEHOLDER}} タグが残っている。

解決方法:

1. analyze-template.ts を実行して正確なタグテキストと場所を確認
2. プレースホルダーが文字列セル内にあることを確認（数式内ではない）
3. 置換仕様でシートフィルターを確認

問題: 数式がテキストとして表示される

症状: 数式が計算されずテキストとして表示される。

解決方法:

• 仕様の数式が "=" で始まらないことを確認（自動的に追加されます）
• セルの型が "string" に強制されていないことを確認

問題: 数値がテキストとしてフォーマットされている

症状: 数値にテキスト保存を示す緑色の三角形がある。

解決方法:

• 仕様で数字を引用符で囲まずに数値として使用
• テンプレート置換の場合、セル全体がプレースホルダーで置換値が数値なら自動変換

問題: 列幅が適用されない

症状: 仕様にもかかわらず列がデフォルト幅のままである。

解決方法:

• 列文字が大文字であることを確認
• 列仕様が配列形式であることを確認

制限事項

• XLSX のみ: 旧式の .xls または .xlsb 形式をサポートしていません
• マクロ不可: VBA マクロを作成または保存できません
• グラフ機能が限定的: ネイティブグラフ作成はサポートしていません
• ピボットテーブル不可: プログラム的にピボットテーブルを作成できません
• 基本的なスタイリング: セルフォーマットオプションが限定的です
• 条件付き書式不可: 条件付き書式ルールを設定できません
• 数式再計算: 数式は保存されますが再計算されません（Excel を開くと再計算）

関連スキル

• pptx-generator: PowerPoint プレゼンテーション作成用
• docx-generator: Word ドキュメント作成用
• csv-processor: より単純な CSV データ処理用