document-polisher

ドキュメントのブラッシュアップ

一流ブランドの洗練されたデザインを活用して、あらゆるドキュメントをプロフェッショナルな傑作に仕上げます。

概要

このスキルでは、厳選された10ブランドのプレミアムなスタイルをDOCXドキュメントに適用します。各ブランドのタイポグラフィ、カラーパレット、デザイン原則を分析し、本物らしいドキュメントを作成します。

ブランド選択メニュー

ユーザーがドキュメントのブラッシュアップを希望した場合は、必ず次の選択メニューを提示してください。

╔══════════════════════════════════════════════════════════════════════════╗
║                        DOCUMENT POLISHER                                 ║
║                    Select Your Brand Style                               ║
╠══════════════════════════════════════════════════════════════════════════╣
║                                                                          ║
║  EDITORIAL                                                               ║
║  ─────────                                                               ║
║  1. The Economist    │ Deep navy + serif typography                      ║
║                      │ Best for: Reports, analysis, thought leadership   ║
║                                                                          ║
║  CONSULTING                                                              ║
║  ──────────                                                              ║
║  2. McKinsey         │ Sharp corners + bold blue accents                 ║
║                      │ Best for: Strategy decks, executive summaries     ║
║                                                                          ║
║  3. Deloitte         │ Teal-blue + pill-shaped elements                  ║
║                      │ Best for: Audits, assessments, formal reports     ║
║                                                                          ║
║  4. KPMG             │ Two-tone blue + condensed headings                ║
║                      │ Best for: Financial reports, compliance docs      ║
║                                                                          ║
║  TECH                                                                    ║
║  ────                                                                    ║
║  5. Stripe           │ Dark blue + purple gradients                      ║
║                      │ Best for: API docs, developer guides, specs       ║
║                                                                          ║
║  6. Apple            │ Minimalist + generous whitespace                  ║
║                      │ Best for: Product docs, user guides               ║
║                                                                          ║
║  7. IBM              │ Plex typography + Carbon design                   ║
║                      │ Best for: Technical docs, enterprise reports      ║
║                                                                          ║
║  8. Linear           │ Modern purple + precise typography                ║
║                      │ Best for: Product specs, changelogs, dev docs     ║
║                                                                          ║
║  PRODUCTIVITY                                                            ║
║  ────────────                                                            ║
║  9. Notion           │ Clean blue + subtle accents                       ║
║                      │ Best for: Wikis, project plans, documentation     ║
║                                                                          ║
║  DESIGN                                                                  ║
║  ──────────                                                              ║
║  10. Figma           │ Vibrant multi-color palette                       ║
║                      │ Best for: Creative briefs, design docs, brands    ║
║                                                                          ║
╚══════════════════════════════════════════════════════════════════════════╝

ワークフロー

ステップ 1：ユーザーに確認する

ユーザーがドキュメントのブラッシュアップを希望した場合：

1. 上記のブランド選択メニューを表示します
2. 次のように尋ねます：「どのブランドスタイルを適用しますか？ドキュメントの用途を教えていただければ、スタイルをおすすめすることもできます。」

ステップ 2：スタイルを適用する

重要：必ず python-docx を使った Python スクリプトを使用してください。ドキュメントが破損する可能性があるため、XML／OOXML を直接操作しないでください。

主な方法：Python スクリプト（必須）

このスクリプトは python-docx を使用して、ブランドスタイルを適用したドキュメントを安全に再作成します。スクリプトの処理内容は次のとおりです。

• 元のドキュメントを読み込みます
• ブランドスタイルを適用した新しいドキュメントを作成します
• 適切な書式でコンテンツをコピーします
• 太字、斜体、リスト、構成を保持します

# Ensure python-docx is installed in the environment
pip install python-docx

# Apply brand styling
python scripts/apply_brand.py <input.docx> <brand_name> <output.docx>

# Examples:
python scripts/apply_brand.py report.docx economist polished_report.docx
python scripts/apply_brand.py proposal.docx mckinsey styled_proposal.docx
python scripts/apply_brand.py guide.docx stripe tech_guide.docx

使用できるブランド名：

• economist - The Economist（エディトリアル、セリフ体）
• mckinsey - McKinsey & Company（コンサルティング、シャープなデザイン）
• deloitte - Deloitte（コンサルティング、ティール）
• kpmg - KPMG（コンサルティング、鮮やかなブルー）
• stripe - Stripe（テクノロジー、ダークブルー／パープル）
• apple - Apple（テクノロジー、ミニマリスト）
• ibm - IBM（テクノロジー、エンタープライズ）
• notion - Notion（生産性、すっきりとしたデザイン）
• linear - Linear（テクノロジー、モダンなパープル）
• figma - Figma（デザイン、カラフル）

スクリプトの処理内容

1. templates/brand-mapping.json からブランド設定を読み込みます
2. 新しいドキュメントを作成します（XML 編集による破損を回避します）
3. ドキュメント全体のスタイルを適用します：
   • 標準テキストのスタイル（フォント、サイズ、色）
   • 見出し 1、2、3 のスタイル（フォント、サイズ、色、間隔）
   • タイトルのスタイル
   • ページの余白
4. 書式を保ったままコンテンツをコピーします：
   • 見出しを適切なレベルで保持します
   • 箇条書きと番号付きリストを維持します
   • 太字、斜体、下線の書式を維持します
   • 段落の配置を保持します
   • スタイル付きで表をコピーします
5. 新しいファイルとして保存します（元のファイルを上書きすることはありません）

ブランドのリファレンスファイル

詳細なブランドガイドラインは brands/ ディレクトリに保存されています。

ブランド	リファレンスファイル	主な要素
The Economist	brands/economist.md	Georgia のセリフ体、#1F2E7A のネイビー、最小限の罫線
McKinsey	brands/mckinsey.md	Helvetica Neue、#051C2C のダークカラー、シャープな角
Deloitte	brands/deloitte.md	Open Sans、#007CB0 のティール、角丸の要素
KPMG	brands/kpmg.md	Open Sans、#1E49E2 のブルー
Stripe	brands/stripe.md	Helvetica Neue、#0A2540 と #9966FF のパープル
Apple	brands/apple.md	Helvetica Neue、#0071E3 のブルー、ミニマル
IBM	brands/ibm.md	Arial、#0F62FE のブルー、シャープな角
Notion	brands/notion.md	Arial、#0075DE のブルー、ブロックベース
Linear	brands/linear.md	Arial、#5E6AD2 のパープル、モダン
Figma	brands/figma.md	Arial、マルチカラーパレット

スタイルのマッピング

templates/brand-mapping.json ファイルには、プログラムでスタイルを適用するための構造化データが含まれています。

{
  "brands": {
    "economist": {
      "name": "The Economist",
      "colors": {
        "primary": "#1F2E7A",
        "accent": "#E3120B",
        "textPrimary": "#0D0D0D"
      },
      "typography": {
        "headingFont": "Georgia",
        "bodyFont": "Georgia"
      },
      "styles": {
        "h1": { "size": 28, "color": "#1F2E7A", "bold": true },
        "h2": { "size": 22, "color": "#1F2E7A", "bold": true },
        "body": { "size": 11, "color": "#0D0D0D" }
      }
    }
  }
}

例

例 1：McKinsey スタイルでレポートをブラッシュアップする

ユーザー：「四半期レポートをもっとプロフェッショナルに見せてください」

1. ブランドメニューを表示します
2. ユーザーが「McKinsey」を選択します
3. スタイルを適用します。

cd /path/to/project
source venv/bin/activate  # if using virtual environment
python .claude/skills/document-polisher/scripts/apply_brand.py quarterly_report.docx mckinsey polished_quarterly_report.docx

例 2：ガイドに Economist スタイルを適用する

ユーザー：「このガイドを The Economist のようなスタイルにしてください」

python .claude/skills/document-polisher/scripts/apply_brand.py guide.docx economist guide_economist.docx

例 3：Stripe スタイルの技術ドキュメント

ユーザー：「この API ドキュメントを Stripe のドキュメントのようにしてください」

python .claude/skills/document-polisher/scripts/apply_brand.py api_doc.docx stripe api_doc_stripe.docx

依存関係

• Python 3.x
• python-docx：pip install python-docx

スクリプトは python-docx の有無を確認し、インストールされていない場合はインストール手順を提示します。

最良の結果を得るためのヒント

1. ブランドとコンテンツを合わせる：ビジネス文書にはコンサルティングブランド、技術的なコンテンツにはテクノロジーブランドを使用します
2. 対象読者を考慮する：学術関係者にはEconomist、開発者にはStripe、一般消費者にはAppleを選びます
3. ブランドを過度に強調しない：目標はプロフェッショナルな仕上がりであり、ブランドを完全に模倣することではありません
4. PDFへのエクスポートでテストする：PDFとWordではスタイルの見え方が異なる場合があります
5. 仮想環境を使用する：依存関係を分離できます

トラブルシューティング

「Module not found: docx」

pip install python-docx

ドキュメントの表示がおかしい

• ソースドキュメントで標準のWordスタイル（Heading 1、2、3、Normal）が使用されていることを確認します
• リストで組み込みのList Bullet／List Numberスタイルが使用されていることを確認します

スクリプトのパスに関する問題

プロジェクトのルートから実行するか、絶対パスを使用してください：

python /full/path/to/.claude/skills/document-polisher/scripts/apply_brand.py input.docx brand output.docx

新しいブランドの追加

新しいブランドを追加するには：

1. FireCrawlを使用してブランディングを抽出します：mcp__firecrawl__firecrawl_extract_branding
2. brands/<brand_name>.md に新しいファイルを作成します
3. templates/brand-mapping.json に次の項目を追加します：
   • name、description、category
   • colors：primary、accent、background、textPrimary、textSecondary
   • typography：headingFont、bodyFont
   • styles：h1、h2、h3、body（size、color、boldを指定）
4. サンプルドキュメントでテストします