docx

DOCX スキル

目的

Word 文書のプログラムによる作成と操作に関する専門知識を提供します。python-docx および JavaScript ライブラリを使用した文書の生成、テンプレートへのデータ入力、スタイル管理、文書の一括処理に対応します。

使用する場面

• Word 文書をプログラムで生成する
• 文書テンプレートにデータを入力する
• 既存の .docx ファイルを変更する
• Word 文書からコンテンツを抽出する
• スタイルと書式を適用する
• 差し込み印刷のワークフローを作成する
• データを整形済み文書に変換する

クイックスタート

このスキルを呼び出す場面：

• Word 文書をプログラムで生成する
• 文書テンプレートにデータを入力する
• 既存の .docx ファイルを変更する
• Word 文書からコンテンツを抽出する
• 文書のワークフローを自動化する

次の場合は呼び出さないでください：

• 文書のコンテンツを作成する場合（document-writer を使用）
• PDF を作成する場合（pdf-skill を使用）
• スプレッドシートを作成する場合（xlsx-skill を使用）
• プレゼンテーションを作成する場合（pptx-skill を使用）

判断フレームワーク

Library Selection:
├── Python backend → python-docx
├── Node.js backend → docx (npm)
├── Browser-based → docx.js
├── Complex templates → docxtemplater
└── Simple text extraction → mammoth

Task Type:
├── Generate from scratch → Build document programmatically
├── Fill template → Use placeholder replacement
├── Modify existing → Load, edit, save
└── Batch processing → Loop with template

主なワークフロー

1. 文書の生成（python-docx）

1. Document オブジェクトを作成する
2. レベルを指定して見出しを追加する
3. テキストを含む段落を追加する
4. スタイル（組み込みまたはカスタム）を適用する
5. 必要に応じて表を追加する
6. 画像を挿入する
7. 文書を保存する

2. テンプレートの処理

1. テンプレート文書を読み込む
2. プレースホルダー（{{variable}}）を検索する
3. 実際の値に置き換える
4. 条件付きセクションを処理する
5. 繰り返しセクションを処理する
6. 新しい文書として保存する

3. 文書の一括生成

1. テンプレートを一度読み込む
2. データレコードを順に処理する
3. レコードごとにテンプレートを複製する
4. プレースホルダーに値を入力する
5. 一意のファイル名を生成する
6. 各文書を保存する

ベストプラクティス

• 直接書式設定ではなく、段落スタイルを使用する
• 再利用できるよう、プレースホルダー付きのテンプレートを作成する
• プレースホルダーの値がない場合も適切に処理する
• 元のテンプレートを保持し、新しいファイルに保存する
• 複雑なコンテンツ（表、画像）でテストする
• 出力ファイルが正しく開けることを確認する

アンチパターン

アンチパターン	問題	正しい方法
直接書式設定	保守が難しい	スタイルを使用する
テンプレートの変更	元のファイルが破損する	新しいファイルに保存する
エラー処理なし	不正な入力で失敗する	先にデータを検証する
パスのハードコード	移植できない	相対パスを使用する
エンコーディングの無視	文字化けが発生する	UTF-8 文字列を使用する