MiniMax は、Office ドキュメント生成で踏んできたすべての落とし穴を、まるごとオープンソースにしました。

これはデモレベルのおもちゃプロジェクトではなく、本番環境で複数ラウンドの自動テストを通過した完全なソリューションです。ユーザーが「Q3 戦略レポートを書いて」とひとこと言えば、内容の構成、レイアウト制御から最終出力まで、そのまま納品できるドキュメントを生成します。

核心の問題：生成できる ≠ 納品できる

Agent でドキュメントを処理するとき、最も難しいのは書けないことではなく、書けたのに使えないことです：

• 数式が保存されたら死んだ数値になってしまう
• テンプレートを1ラウンド編集しただけで書式が崩れる
• ピボットテーブルが保存後に知らぬ間に消える

ファイルは開けるのに、最終成果物としては使えません。

MiniMax が構築したこの Office Skills は、まさにこの問題を解決するためのものです。生成されたドキュメントを、本当に納品に耐えるものにします。

オープンソースの内容

完全なオープンソース化には以下が含まれます：

• 4つの Office Skills のコード（Word/Excel/PPT/PDF）
• デザインと技術選定の思考ドキュメント
• Skills が自己進化する仕組み
• MIT ライセンスの採用

GitHub アドレス：https://github.com/MiniMax-AI/skills

技術選定：各決断の裏にあるトレードオフ

Word：.NET OpenXML SDK を選択

なぜ python-docx を使わないのか？

python-docx はコミュニティで最も一般的なソリューションで、軽量で使いやすいものです。しかし、要件が複雑なテーブルのネスト、多階層の目次、ヘッダー・フッターの制御、変更履歴の追跡にまで進むと、対応していない機能もあれば、対応していても生成されるドキュメント構造が壊れやすいものもあります。

.NET OpenXML SDK は Microsoft が公式にメンテナンスする低レベルライブラリで、ECMA-376（Word ファイル形式の公式標準）の実装が最も完全です。デプロイコストはより高くなりますが（.NET ランタイムが必要）、その代わりに Word ドキュメント構造に対する、より完全で信頼性の高い制御力が得られます。

カバーするシーン：

• ゼロから完全なドキュメントを生成
• 既存ドキュメントの内容を、元の書式を壊さずに編集
• デザインテンプレートをドキュメントに適用し、構造を自動検証

付属として、OpenXML 形式のリファレンスマニュアル、中国語・日本語・韓国語の組版ガイド、10以上のそのまま実行できるサンプルコードが提供されています。

Excel：XML を直接操作

なぜ openpyxl を使わないのか？

Openpyxl はコミュニティで最も一般的なソリューションですが、エンジニアリング上受け入れがたい問題が1つあります。ファイルを読み込んで書き戻した後、一部の高度な内容が通知なく破棄されてしまうのです。

たとえば、ピボットテーブル、スパークライン、VBA マクロを含む Excel ファイルを openpyxl で開いて保存すると、これらが消えてしまっている可能性があり、エラーの警告すら出ません。

解決策：すべての Python Excel ライブラリを回避し、XML のレイヤーで直接操作します。

.xlsx ファイルは本質的には圧縮アーカイブで、中身は一連の XML ファイルです。手順は次の通り：

1. 解凍する
2. 対象セルに対応する XML ノードだけを修正する
3. 再びパッケージする

こうすれば毎回の編集で必要な箇所だけが変更され、スタイル、グラフ、マクロはすべて元のまま保持されます。

重要なポイント：数式の扱い

多くのソリューションは数式を事前に計算して、静的な数値として保存します。MiniMax は、すべての派生値が本当の Excel 数式（たとえば SUM(B2:B9)）であることを要求します。これにより、ユーザーがファイルを開いた後も正常に編集や連動ができます。

そのために13個の独立した Python ツールスクリプトが開発され、解凍・パッケージ化、列の挿入、行オフセット、数式検証、動的再計算、書式監査などの工程をカバーしています。

PDF：表紙と本文を2つのエンジンに分離

PDF の核心的な課題は、再利用可能で拡張可能なデザインシステムを作る必要があることです。MiniMax は15種類のドキュメントタイプに独立したビジュアル言語を設計し、それぞれに対応する表紙のパターン、フォント、配色を用意しています。

技術的な実装：

• 表紙：HTML + CSS で記述し、Playwright で PDF にレンダリング（グラデーション、グリッド、ブレンドモード、カスタムフォントに対応）
• 本文：ReportLab に組版を任せる（段落フローの制御、改ページ戦略、ヘッダー・フッターがより安定）
• 結合：merge スクリプトで両方を結合して完全な PDF に

2つのエンジンに分けたことでシステムは複雑になりましたが、表紙は大胆にデザインでき、本文はエンジニアリングとしての安定性を保てます。

PPT：難所はビジュアルスタイルの一貫性

PPT 生成の難しさは、スライドに内容を置くことではなく、ビジュアルスタイルの統一にあります。フォントサイズ、間隔、配色、角丸のカーブ、どこか1つでも不整合があると、プレゼンテーション全体が粗雑に見えてしまいます。

解決策：まず制約の体系を定義してから、生成を行います。

ページタイプ：5つの標準タイプ

• 表紙
• 目次
• 章の区切り
• 内容
• まとめ

スタイルレシピ：4つのレシピ

• Sharp
• Soft
• Rounded
• Pill

各レシピは、角丸半径、シャドウのパラメータ、枠線の太さ、間隔の比率など、一連の数値を定義しています。レシピを切り替えるだけで、PPT 全体のビジュアルのトーンを丸ごと変えられます。

技術的な実装は PptxGenJS（JavaScript エコシステムで最も機能が完全な PPT 生成ライブラリ）に基づいています。

自己循環する進化：Skill はどうやって良くなるのか

skill を1つ作るのは難しくありません。本当の課題はこうです：次のラウンドで本当に良くなったかを、どうやって知るのでしょうか？

MiniMax は固定された3段階のサイクルを構築しました：Execute → Evaluate → Fix

動作の流れ：

1. まず実際のユースケースのセットを実行
2. ルールに基づいて出力が基準を満たすかを確認
3. 失敗サンプルを修正可能な問題として蓄積し、次の反復に入る

この仕組みにより、Skills の反復は失敗サンプルを中心に継続的に収束していきます。1ラウンド実行するごとに、問題が構造、数式、スタイル、テンプレート制約のどれにあるのかがよりはっきりわかるようになります。

合格基準：

• 構造が完全か
• 数式が数式のままであるか
• レイアウトが読み書きの後に変形していないか
• テンプレート制約が破られていないか

xlsx ファイルが正常に保存されたとしても、ピボットテーブルが消えていたり、数式が静的な数値に書き換えられていたりすれば、実際の納品では失敗とみなされます。

本番での検証

この4つの Skill はすでに MiniMax Agent と MaxClaw でリリースされており、直接体験できます：https://agent.minimaxi.com

企業分野では、MiniMax は超大規模（本番システムで10兆級を超えるレコード、億単位のドキュメント）のドキュメントオフィスや、大手企業のモバイルオフィスアプリケーションなどにサービスを提供してきました。

ある厳格なオフィスシーンのエンドツーエンド評価では、汎用ソリューションの精度はわずか 60-70% でしたが、MiniMax は99.8% のリコール率を達成しました。

Toolin の見解

今回のオープンソース化の最大の価値は、「オープンソースプロジェクトがまた1つ増えた」ことではなく、MiniMax が本番環境で踏んだ落とし穴をすべて晒け出し、検証済みの解決策を提示したことにあります。

なぜ python-docx ではなく .NET なのか？ なぜ openpyxl を使わずに XML を直接操作するのか？ なぜ PDF を2つのエンジンに分けるのか？

1つ1つの技術選定の背後には、実際のシーンに迫られた決断があります。これらの経験は、コードそのものよりも価値があります。

誰に向いているか：

• 現在 AI ドキュメント生成に取り組んでいるチーム
• プロダクション品質のドキュメントが必要な企業アプリケーション
• Office ドキュメントの低レベルの仕組みを理解したい開発者

誰に向いていないか：

• 単純なドキュメント生成だけでよい個人プロジェクト
• デプロイの複雑さに厳しい制約があるシーン
• 高精細なドキュメント再現を必要としないアプリケーション

あなたも AI ドキュメント生成をしている、あるいは生成されたドキュメントがいつもそのままでは使えず頭を抱えているなら、このリポジトリはじっくり研究する価値があります。

---

GitHub：https://github.com/MiniMax-AI/skills ライセンス：MIT 体験アドレス：https://agent.minimaxi.com モデル呼び出し：https://platform.minimaxi.com/subscribe/token-plan