DOCX エディタスキル

エントリ: python scripts/docx_agent.py <file> <command> [options]

グローバルフラグ

• --json: プログラマティック使用時は必須。最小化された出力です。
• --backup: 変更前に自動的に .bak ファイルを作成します。
• --cleanup: 一時ファイルを自動削除します。
• --verify: 書き込み後に即座に検証を実行します。

ナレッジベース

• Commands: CLI コマンド一覧の完全版。
• Workflows: 大規模ドキュメント/テーブルの最適化パターン。

クイックリファレンス

コマンド	機能
info	ファイルサイズ、段落数/テーブル数/単語数、メタデータ
outline	見出し構造と段落インデックス
full_text	スタイルラベル付きすべての段落
read_section --heading X	特定の見出し下の段落
read_range --start N --end M	N から M までの段落
search --query X	正規表現にマッチする段落を検索
summary_map	推定ページ数付きコンパクトなドキュメント概要
replace_text --find X --replace Y	フォーマット保持テキスト置換
insert_paragraph --text X --index N	段落 N の後に挿入
delete_paragraphs --indices 1,2,3	インデックスで段落を削除
create_table --headers A,B,C	新しいテーブルを作成
read_table --table-index 0	テーブルをマークダウンとして読み込み
modify_cell --table-index 0 --row 1 --col 2 --text X	セルを編集
batch --commands file.json	アトミックな複数操作バッチ（create、info、set_metadata などに対応）
diff --doc2 other.docx	LCS 段落レベルの差分
undo	最後のバックアップを復元

精密な使用ルール

1. 最初に full_text を読み込まない。info → outline → summary_map の順で使用します。
2. 対象を絞った読み込み: search --compact、read_range、または read_section を使用します。
3. すべての編集を検証: --verify またはその後の read_range で確認します。
4. バッチ操作: I/O を最小化するため複数の編集には batch_execute を使用します。
5. 破壊的操作の前には必ず --backup を実行します。