/ ディレクトリ / プレイグラウンド / document-format-skills
● コミュニティ KaguraNanaga ⚡ 即起動

document-format-skills

作者 KaguraNanaga · KaguraNanaga/document-format-skills

中国語の.docxファイルを中国の公文書・学術・法務の書式基準に整形します。python-docxを使用して、インデント、句読点、フォント、番号付けを修正します。

中国語Word文書の書式整形に特化したClaude Codeスキルです。中国語・英語の句読点混在、フォントの不統一、スペーシングの問題を検出し、3つのスタイルプリセット(GB/T 9704-2012公文書、学術論文、法律文書)のいずれかを適用します。Pythonベースで、python-docxに依存します。

なぜ使うのか

主な機能

ライブデモ

実際の動作

document-format-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "document-format-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KaguraNanaga/document-format-skills",
        "~/.claude/skills/document-format-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "document-format-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KaguraNanaga/document-format-skills",
        "~/.claude/skills/document-format-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "document-format-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KaguraNanaga/document-format-skills",
        "~/.claude/skills/document-format-skills"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "document-format-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KaguraNanaga/document-format-skills",
        "~/.claude/skills/document-format-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "document-format-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/KaguraNanaga/document-format-skills",
        "~/.claude/skills/document-format-skills"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "document-format-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/KaguraNanaga/document-format-skills",
          "~/.claude/skills/document-format-skills"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add document-format-skill -- git clone https://github.com/KaguraNanaga/document-format-skills ~/.claude/skills/document-format-skills

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: document-format-skills

政府報告書をGB/T 9704-2012基準に整形する

👤 中国政府・国有企業の職員、秘書 ⏱ ~15 min beginner

使うタイミング: 公文の草案を受け取り、公文処理の審査を通過させる必要がある場合。

前提条件
  • Python 3 + python-docxがインストール済みであること — pip install python-docx
  • スキルがクローン済みであること — git clone https://github.com/KaguraNanaga/document-format-skills ~/.claude/skills/document-format-skills
フロー
  1. まず分析する
    分析 report.docx 的格式问题,按 GB/T 9704-2012 标准列出所有偏差。✓ コピーしました
    → カテゴリ別にグループ化された逸脱項目のリスト
  2. プリセットを適用する
    按公文标准自动修复,保留原内容。输出到 report-fixed.docx。✓ コピーしました
    → 新しいファイルが生成され、差分サマリーが表示される

結果: 手動での再整形なしに、内部の書式審査を通過できる報告書。

注意点
  • 複雑な表が正しくレンダリングされない場合がある — 表は手動で確認してください。スキルは表に対して保守的に処理します
組み合わせ: filesystem

中国語学術論文の句読点と書式を整える

👤 中国語で執筆する大学院生・研究者 ⏱ ~20 min beginner

使うタイミング: 厳格な句読点基準を求める中国語ジャーナルへの投稿前。

フロー
  1. 句読点の修正パス
    修正 paper.docx 中所有中英文标点混用问题,统一为中文全角标点。✓ コピーしました
    → すべての(および,が統一される
  2. 学術プリセットを適用する
    按学术论文标准应用格式预设。✓ コピーしました
    → 見出し、インデント、行間が統一される

結果: 投稿可能な状態の論文。

注意点
  • コードブロックや英語の引用が過剰に変換される — 英語のみの段落を保持するようスキルに指示し、除外するセクション範囲を指定してください

組み合わせ

他のMCPと組み合わせて10倍の力を

document-format-skill + filesystem

フォルダ内のすべての.docxを一括整形する

遍历 reports/ 下所有 .docx,全部按公文标准格式化,输出到 reports-fixed/。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
analyze_format path to .docx 変更を適用する前に実行する 0 — local
fix_punctuation path, target (cn|mixed) 中国語・英語の句読点を統一する際に使用 0
apply_preset path, preset (gov|academic|legal) 分析後のメイン変換処理として使用 0

コストと制限

運用コスト

APIクォータ
なし
呼び出しあたりのトークン
最小限 — スキルは主にPythonスクリプトを駆動します
金額
無料
ヒント
analyze_formatを一度実行してからapply_presetを適用してください。Claudeにトークンを使って手動整形させないでください

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: なし
データ送信先: なし — python-docxによる完全ローカル処理

トラブルシューティング

よくあるエラーと対処法

ModuleNotFoundError: python-docx — python-docxモジュールが見つかりません

pip install python-docx を実行してください

確認: python -c 'import docx'
Tables misrender after formatting — 整形後に表の表示が崩れる

元に戻してから、表を除外してプリセットを再実行してください

Fonts missing on the final machine — 最終環境でフォントが見つからない

プリセットは宋体/仿宋/黑体を使用します。ファイルを開く環境に中国語フォントをインストールしてください

確認: fc-list :lang=zh

代替案

document-format-skills 他との比較

代替案代わりに使う場面トレードオフ
Manual Word styles単発の文書で、Wordに精通している場合一括処理不可、書式の不統一が起こりやすい

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る