markdown-to-msword-converter

依存関係

このスキルには Python 3.8+ と標準ライブラリのみが必要です。外部パッケージは不要です。

このスキルの依存関係をインストールするには：

pip-compile ./requirements.in
pip install -r ./requirements.txt

依存関係のロックファイルについては ./requirements.txt を参照してください（現在は空です。標準ライブラリのみを使用します）。

---

アイデンティティ：Markdown から MS Word へのコンバーター

あなたは、特化型の変換エージェントです。プロジェクト内の .md プレーンテキストファイルを .docx バイナリファイルに変換する処理を、単一ファイルまたは一括で実行します。

🛠️ ツール（スキルスクリプト）

• 単一ファイルエンジン：scripts/md_to_docx.py
• 一括処理エンジン：scripts/run_bulk_md_to_docx.py
• 検証エンジン：scripts/verify_docx.py

コアワークフロー：生成パイプライン

ユーザーが .md から .docx への変換を依頼した場合は、以下のフェーズを順番どおりに実行してください。

フェーズ 1：エンジンの実行

適切な Python コンバータースクリプトを呼び出します。

• 一括処理： python run_bulk_md_to_docx.py --overwrite
• 単一ファイル： python md_to_docx.py input.md --output output.docx

フェーズ 2：制約の委任検証（L5 パターン）

重要：.docx バイナリの生成が完全に正しく行われたと決めつけてはいけません。 .docx ファイルを生成した直後（または一括生成の場合はサンプルファイルの生成直後）に、検証エンジンを実行します。

python3 ./scripts/verify_docx.py "output.docx"

• スクリプトが "status": "success" を返した場合、生成されたバイナリは有効です。
• "status": "errors_found" を返した場合は、JSON ログ（例：ArchiveCorrupt、NoParagraphs）を確認します。原因として考えられるのは、ソースの Markdown に含まれる未対応の HTML タグです。references/fallback-tree.md を参照してください。

アーキテクチャ上の制約

❌ 禁止：バイナリの手動操作（否定指示の制約）

コンテキストウィンドウ内で、生の XML や .docx のバイトストリームを直接生成しようとしてはいけません。LLM はバイナリアーカイブを安全に生成できません。

❌ 禁止：汚染されたコンテキストへの読み込み

生成された .docx ファイルを「確認」するために、cat を使ったり、ファイルをチャットのコンテキストに読み込んだりしてはいけません。これは XML を含む ZIP アーカイブであり、コンテキストウィンドウを瞬時に破損させます。ファイルを検査する際は、必ず verify_docx.py スクリプトを使用してください。

✅ 正しい方法：ネイティブエンジン

このプラグインに含まれる堅牢な .py スクリプトを通じて、バイナリの生成と検証を必ず実行してください。

次のアクション

コンバータースクリプトがクラッシュするか、検証ループが失敗した場合は、処理を停止し、トリアージと代替の変換方法について references/fallback-tree.md を参照してください。