openai-doc

DOCX スキル

使用する場面

• レイアウト（表、図、ページ割り）が重要な DOCX の内容を読んだり確認したりする場合。
• プロフェッショナルな書式で DOCX ファイルを作成または編集する場合。
• 納品前に視覚的なレイアウトを検証する場合。

ワークフロー

1. 視覚的な確認（レイアウト、表、図）を優先します。
   • soffice と pdftoppm が利用できる場合は、DOCX を PDF に変換し、さらに PNG に変換します。
   • または、scripts/render_docx.py を使用します（pdf2image と Poppler が必要です）。
   • これらのツールがない場合は、インストールするか、レンダリングしたページをユーザーがローカルで確認するよう依頼します。
2. 編集や構造化された文書の作成（見出し、スタイル、表、リスト）には python-docx を使用します。
3. 重要な変更を加えるたびに、再レンダリングしてページを確認します。
4. 視覚的な確認ができない場合は、代替手段として python-docx でテキストを抽出し、レイアウト上のリスクを伝えます。
5. 中間ファイルを整理し、最終承認後にクリーンアップします。

一時ファイルと出力の規則

• 中間ファイルには tmp/docs/ を使用し、作業完了後に削除します。
• このリポジトリで作業する場合は、最終成果物を output/doc/ に保存します。
• ファイル名は分かりやすいものにし、変更しないでください。

依存関係（未インストールの場合はインストール）

依存関係の管理には uv を優先してください。

Python パッケージ：

uv pip install python-docx pdf2image

uv を利用できない場合：

python3 -m pip install python-docx pdf2image

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

# macOS (Homebrew)
brew install libreoffice poppler

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

この環境でインストールできない場合は、不足している依存関係と、ローカルでのインストール方法をユーザーに伝えてください。

環境

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

レンダリングコマンド

DOCX -> PDF：

soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX

PDF -> PNG：

pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME

同梱のヘルパー：

python3 scripts/render_docx.py /path/to/file.docx --output_dir /tmp/docx_pages

品質への期待

• タイポグラフィ、間隔、余白、階層構造が一貫した、クライアントにそのまま納品できる文書を作成します。
• テキストの切れや重なり、表の崩れ、読めない文字、デフォルトのテンプレートスタイルなどの書式上の問題を避けます。
• グラフ、表、図は、レンダリングしたページ上で正しく配置され、読みやすいものにします。
• ASCII のハイフンのみを使用します。U+2011（ノーブレークハイフン）やその他の Unicode ダッシュは使用しないでください。
• 引用と参照は人が読める形式にし、ツールのトークンやプレースホルダー文字列を残さないでください。

最終確認

• 最終納品前に、すべてのページを 100% のズームで再レンダリングして確認します。
• 間隔、配置、ページ割りの問題を修正し、レンダリングの手順を繰り返します。
• ユーザーから保持の指示がない限り、一時ファイルや重複したレンダリング結果などが残っていないことを確認します。

使用しない場面