mcpField
D
document-format-skills

document-format-skills

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

document-format-skills について

中国語の Word 文書をコマンドラインで整形、診断、書式設定するスキルです。テキストや Markdown からの DOCX 作成や、Windows での DOC/WPS 変換にも対応します。

主な機能

  1. 01文書の一括処理
  2. 02句読点と空白の調整
  3. 03書式プリセットとカスタム設定
  4. 04文書の診断
  5. 05テキストや Markdown から DOCX 作成

活用シーン

  1. 01公文書や論文の書式適用
  2. 02書式を保った句読点の修正
  3. 03編集前の文書問題の確認
  4. 04Markdown から書式付き DOCX を作成

インストール

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

$npx skills add https://github.com/kagurananaga/document-format-skills --skill document-format-skills

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

同梱ファイル

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

LICENSE
README.md
requirements-dev.txt
.gitignore
requirements.txt
README_CN.md
pytest.ini
scripts/
__init__.py
analyzer.py
converter.py
fix_spacing.py
from_text.py
process.py
fix_spacing_simple.py
punctuation.py
formatter.py
tests/
test_punctuation_and_text.py
test_formatter_regression.py

詳細

ドキュメント形式スキル

これらのスクリプトを使うと、コマンドラインから中国語の Word 文書を整理して書式設定できます。通常の作業では、GUI を使わずにデスクトップアプリの中核的な処理パイプラインを再現する scripts/process.py を優先してください。

クイックワークフロー

ユーザーが文書を最初から最後まで整理することを希望している場合は、スマート処理を1回実行します。

uv run --with python-docx python scripts/process.py smart input.docx output.docx --preset official

診断のみを実行します。

uv run --with python-docx python scripts/process.py analyze input.docx
uv run --with python-docx python scripts/process.py analyze input.docx --json

句読点とスペースの整理のみを実行します。

uv run --with python-docx python scripts/process.py punctuation input.docx output.docx --space-mode keep_en_boundary

書式設定のみを実行します。

uv run --with python-docx python scripts/process.py format input.docx output.docx --preset official

Windows では、WPS または Microsoft Word の COM オートメーションを通じて、.doc と .wps の入出力に対応しています。

uv run --with python-docx --with pywin32 python scripts/process.py smart input.wps output.wps

スクリプト

スクリプト用途
scripts/process.pysmart、analyze、punctuation、format を実行するワンショット CLI です。Windows での .doc/.wps 変換にも対応します。
scripts/formatter.py書式プリセット、カスタム JSON 設定、ページ番号、表の整理、変更履歴マーク、macOS のフォントフォールバックを適用します。
scripts/punctuation.py書式設定されたランを保持しながら句読点を修正します。スペース処理方法にも対応しています。
scripts/from_text.py.txt または Markdown から DOCX を作成し、必要に応じてスマート書式設定を実行します。
scripts/analyzer.pyより低レベルの診断スクリプトです。
scripts/converter.pyWindows 専用の .doc/.wps 変換ヘルパーです。

書式設定オプション

組み込みプリセット：

  • official：GB/T 9704-2012 に準拠した公文書の書式設定です。
  • academic：学術論文の書式設定です。
  • legal：法律文書の書式設定です。
  • custom：利用可能な場合、現在有効なデスクトップのカスタムプリセットを読み込みます。

便利なフラグ：

--custom-settings path.json
--revision
--deep-clean
--smart-table-align
--no-page-number
--page-number-style dash|plain|page_text|page_total
--page-number-position outside|left|center|right
--page-number-offset-mm 7
--no-bold-serial

--custom-settings は、デスクトップスキーマ v2 の設定ファイル、{"preset": {...}} の形式でエクスポートされたプリセットファイル、またはプレーンなプリセット／オーバーライド JSON を受け付けます。custom 以外のプリセットでは、選択したプリセットに JSON がマージされます。

句読点とスペース

句読点の整理では、URL、メールアドレス、Windows のパス、9:30 のような時刻、ISO 9001:2015 のような規格を保護します。括弧、コロン、セミコロン、疑問符／感嘆符、中国語の読点／句点が使われる箇所、省略記号、ダッシュ、対になった引用符を修正します。

スペースの処理モード：

  • remove_all：半角スペースと全角スペースを削除します。
  • keep_en_boundary：中国語同士の間のスペースを削除し、中国語と英字／数字の間にはスペースを1つだけ残します。
  • keep_all：スペースを変更せずに残します。

テキストまたは Markdown から DOCX への変換

テキストから文書を生成して書式設定します。

uv run --with python-docx python scripts/from_text.py input.md output.docx --title "工作方案"

Markdown モードでは、見出し、太字の範囲、番号付き／番号なしリスト、引用、フェンス付きコードブロックを検出します。# はメインタイトルに、## は 一、 に、### は （一） に変換され、それより深い階層の見出しは番号付きの下位見出しになります。

未処理の DOCX を作成するだけの場合は、--no-process を使用します。

実装に関する注意事項

  • .docx の処理には python-docx のみが必要です。
  • .doc/.wps の変換には、Windows、WPS Office または Microsoft Word、および pywin32 が必要です。
  • ページ番号の処理では、ページ番号以外のフッター内容を上書きしないようにし、要求に応じて既存のページ番号フッターを置き換えます。
  • デフォルトの表書式設定では元の配置を保持します。数値は右揃え、短いテキストは中央揃えにする場合は、--smart-table-align を使用してください。
  • macOS のフォント処理では、インストール済みの公式フォントがあればそれを使用し、元のフォントが存在しないことを検出した場合にのみ、互換性のあるシステムフォントにフォールバックします。

コメント

Markdown 対応