mcpField
W
word-document

word-document

github.com/practicalswanドキュメント22790 回インストール1 週間前に更新
リポジトリ

word-document について

構造やレイアウトが重要な `.docx` の作成、編集、レビュー向けのワークフロースキルです。Word MCP の利用可否を確認し、`python-docx` と OOXML によるローカル代替手順や検証方法も示します。

主な機能

  1. 01DOCX の構造とレイアウト手順
  2. 02見出し・表・スタイルの統一
  3. 03Word MCP の利用可否確認
  4. 04python-docx と OOXML による代替
  5. 05ローカルでの再オープンまたは描画検証

活用シーン

  1. 01書式付きレポートやメモの作成
  2. 02文書の構造と書式のレビュー
  3. 03PDF 変換前の Word ファイル準備
  4. 04コメント、参照、ページ割りの検証

MCP 対応

クライアントが Word MCP 機能を公開しているか確認することを推奨します。利用できない場合は、`python-docx` によるローカル自動化、OOXML の調査、文書の描画または解析による検証を案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/practicalswan/agent-skills --skill word-document

インストール後、Claude Code で/word-documentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
LICENSE.txt
examples/
report-generation-example.md
references/
docx-formatting-reference.md
scripts/
doc-template-generator.py

詳細

Word 文書ワークフロー

技術スタックの対象／バージョン：Word デスクトップ版、または現在の OOXML 互換ワークフローでの python-docx による自動化。

生のテキストだけでなく、.docx のレイアウトや文書構造が重要な場合に、このスキルを使用します。

  • 利用可能な場合は、ネイティブの並列サブエージェント呼び出しと 200k 以上のコンテキストウィンドウを活用します。

現在の MCP の状況

Microsoft は Microsoft 365 Agents Toolkit のプレビューで Word MCP サーバーを公開していますが、ツールを利用できるかどうかは引き続きホストに依存します。GitHub Copilot では Word 専用ツールが表示されることがありますが、ほかのクライアントでは利用できない場合があります。Word MCP に直接アクセスできない場合は、付属のローカルスクリプトのワークフローを使用してください。

有効化条件

症状からアクションを判断するトリガーを使用します。以下のいずれかに該当したら、このスキルを適用し、後述のプロトコルで検証してください。

  • .docx のレポート、メモ、または構造化された成果物を作成または編集する
  • 見出し、表、画像、またはスタイルを適用する
  • 文書構造を確認または抽出する
  • 後で PDF に変換する Word 文書を準備する

実践的なワークフロー

  1. クライアントが Word MCP の機能を提供しているか確認します。
  2. まずタイトル、見出し、セクション、表などの構造を整えます。
  3. 構造が適切になってから、一貫したスタイルを適用します。
  4. エクスポート前にコメント、脚注、参照を検証します。
  5. MCP にアクセスできない場合は、ローカルの生成スクリプトを使用します。

MCP の代替手段 – ネイティブ自動化

MCP が利用できない場合は、ネイティブの自動化を使用します。.docx には python-docx を、サポートされていない構造の確認には OOXML の直接検査を、レイアウトが重要な場合には PDF エクスポートの確認を使用します。スタイル、表、ヘッダー、フッター、コメント、変更履歴に関する要件、メタデータを保持し、成功を報告する前に文書を開き直すか解析してください。

クライアント間のポータビリティ

このスキルは、GitHub Copilot、Claude Code、Codex で利用できるように作成されています。

  • GitHub Copilot：フォルダーを Copilot から見えるスキルパスに配置するか、フォルダーを検出できない場合は、ワークフローをプロジェクトの指示に組み込みます。
  • Claude Code：フォルダーをローカルのスキルディレクトリまたは互換性のあるプラグインソースに配置します。
  • Codex：フォルダーを $CODEX_HOME/skills/word-document にインストールまたは同期し、大きな変更を加えた後は Codex を再起動します。

MCP の利用可否と代替手段

推奨 MCP サーバー：Word Document MCP

  • 代替プロンプト：「MCP を使わずに、Word Document Workflows スキルを使用してください。文書化されたローカルまたは手動の代替手段に従い、選択したツールの構成を示し、検証の根拠を報告してください。」
  • MCP の機能を利用できない場合は、python-docx、Word デスクトップ版、または文書エクスポートスクリプトを使用します。
  • 納品前に、文書をローカルで開き直すかレンダリングし、書式、コメント、ページ割りを検証します。
  • アクティブなホストで利用できない MCP 操作を使用したと主張しないでください。

アンチパターン

  • 読者ではなく作成者に向けて書く：明示されていない背景情報を盛り込み、実際の読者が次に何をすべきか分からなくなります。
  • 具体例やコマンドを省く：抽象的なガイダンスは承認されやすい一方で、正しく適用するのは困難です。
  • リンク、スクリーンショット、バージョンを放置する：書式が整っていても、手順が正しくなくなっていれば役に立ちません。

検証プロトコル

「スキルを正常に適用しました」と報告する前に、以下を確認してください。

  1. 合否：編集前に、Word 文書の成果物の種類、対象形式、必要な出力の忠実度を明示している。
  2. 合否：MCP の利用可否を確認し、MCP がない場合はネイティブ自動化の代替手段を明示している。
  3. 合否：作成したファイルまたは数式をローカルで開く、解析する、レンダリングする、または別の方法で検証している。
  4. 負荷テストのシナリオ：書式、メタデータ、または変換に関するエッジケースのあるファイルにワークフローを適用し、重要な情報が失われていないことを検証する。
  5. 成功指標：未検証の文書に関する主張がゼロであること。成果物そのものが根拠です。

ドキュメントのチェックリスト

  • 見出しの階層が明確である
  • 表が読みやすく、一貫したスタイルで整えられている
  • コメントやレビュー用メモが意図したものである
  • プレースホルダーテキストが削除されている
  • 生成後に最終ドキュメントを再度開くか、別の方法で確認した

参考資料とリソース

ドキュメント
スクリプト
例

関連スキル

  • ドキュメント作成：ワークフローで構造化された技術文書や製品ドキュメントの作成も必要な場合に使用します。
  • ドキュメントのパターン：ワークフローで再利用可能なドキュメント構成やテンプレートも必要な場合に使用します。
  • ドキュメントの品質：ワークフローでドキュメントのレビュー基準や品質ゲートも必要な場合に使用します。
  • ドキュメントの検証：ワークフローで公開前の最終的なドキュメント検証も必要な場合に使用します。

コメント

Markdown 対応