business-document-generator

ビジネス文書ジェネレーター

概要

高品質なPDFテンプレートから、プロフェッショナルなビジネス文書（プロジェクト提案書、事業計画書、年間予算書）を生成します。同梱のPythonスクリプトを使用して、ユーザーが提供したデータをテンプレートに入力し、配布できる形式に仕上げたPDF文書を出力します。

このスキルを使用する場面

ユーザーから次の依頼があった場合に、このスキルを有効にします。

• ビジネス提案書またはプロジェクト提案書の作成
• 事業計画書の生成
• 年間予算計画の作成
• 利用可能なテンプレートに基づく、あらゆるプロフェッショナルなビジネス文書の作成
• 特定のデータを使ったビジネステンプレートへの入力

利用可能な文書の種類

このスキルでは、次の3種類のプロフェッショナルなビジネス文書を作成できます。

1. プロジェクト提案書 - クライアントのプロジェクト向けのプロフェッショナルな提案書

   • テンプレート：assets/templates/Professional Proposal Template.pdf
   • 使用例：クライアントやステークホルダーへのプロジェクト提案

2. 事業計画書 - 包括的な事業計画文書

   • テンプレート：assets/templates/Comprehensive Business Plan Template.pdf
   • 使用例：スタートアップの計画、投資家向けプレゼンテーション、戦略策定

3. 年間予算書 - 詳細な予算計画文書

   • テンプレート：assets/templates/Annual Budget Plan Template.pdf
   • 使用例：財務計画、予算案、会計年度の計画

クイックスタートワークフロー

ステップ1：ユーザーの要件を把握する

ユーザーから次の情報を収集します。

• 必要な文書の種類（提案書、事業計画書、予算書）
• 含める主要データ（会社名、クライアント情報、日付など）
• 特別なカスタマイズの要望

ステップ2：データを準備する

文書データを含むJSONファイルを作成します。フィールド要件については、references/document_schemas.mdのデータスキーマを参照してください。

提案書の例：

{
  "title": "Digital Transformation Initiative",
  "subtitle": "A Comprehensive Plan for Acme Corporation",
  "client_org": "Acme Corporation",
  "client_contact": "Jane Smith, CTO",
  "company_name": "TechSolutions Inc.",
  "contact_info": "[email protected]",
  "date": "November 3, 2025"
}

注： 完全なJSONファイルの例はassets/examples/で確認してください。

• proposal_example.json
• business_plan_example.json
• budget_example.json

ステップ3：依存関係をインストールする（初回のみ）

生成スクリプトにはPythonパッケージが必要です。次のコマンドでインストールします。

pip install pypdf reportlab

ステップ4：文書を生成する

生成スクリプトを実行します。

python3 scripts/generate_document.py <document_type> <data_file> \
  --templates-dir assets/templates \
  --output-dir <output_directory>

パラメーター：

• <document_type>：proposal、business_plan、budgetのいずれか
• <data_file>：文書データを含むJSONファイルのパス
• --templates-dir：PDFテンプレートを含むディレクトリ（既定値：assets/templates）
• --output-dir：生成したPDFの保存先（既定値：output）
• --output-filename：任意のカスタムファイル名

例：

python3 scripts/generate_document.py proposal my_proposal_data.json \
  --templates-dir assets/templates \
  --output-dir ./generated_docs

ステップ5：文書を渡す

スクリプトは、指定した出力ディレクトリにPDFファイルを出力します。文書が正常に生成されたことを確認し、ファイルの保存場所をユーザーに伝えます。

詳細な使用手順

プロジェクト提案書を作成する

1. 提案書に必要な情報を収集します。

   • プロジェクトのタイトルとサブタイトル
   • クライアントの組織と連絡先
   • 自社名と連絡先情報
   • プロジェクトの詳細（課題、解決策、スケジュール、予算）

2. 提案書のフィールドを含むJSONデータファイルを作成します（references/document_schemas.mdを参照）。

3. スクリプトを実行します。

   python3 scripts/generate_document.py proposal proposal_data.json \
     --templates-dir assets/templates
   

4. 出力：表紙と本文セクションを備えた、プロフェッショナルな提案書PDF

事業計画書を作成する

1. 事業計画に必要な情報を収集します。

   • 会社名と法的形態
   • ミッションとビジョンのステートメント
   • ターゲット市場の詳細
   • 財務予測

2. 事業計画書のフィールドを含むJSONデータファイルを作成します。

3. スクリプトを実行します。

   python3 scripts/generate_document.py business_plan plan_data.json \
     --templates-dir assets/templates
   

4. 出力：包括的な事業計画書PDFテンプレート

年間予算書を作成する

1. 予算に必要な情報を収集します。

   • 会計年度
   • 会社名
   • 予算の前提条件（インフレ率、成長目標）
   • 売上と費用の予測

2. 予算書のフィールドを含むJSONデータファイルを作成します。

3. スクリプトを実行します。

   python3 scripts/generate_document.py budget budget_data.json \
     --templates-dir assets/templates
   

4. 出力：表と予測を含む年間予算計画PDF

重要な注意事項

スクリプトの機能

scripts/generate_document.py スクリプトは、次の処理を行います。

• assets ディレクトリから PDF テンプレートを読み込みます
• テンプレートのページ（主に表紙）にユーザーデータを重ねます
• 情報を入力した新しい PDF を生成します
• 元のテンプレートの構造と書式を保持します

現在の制限事項

このスクリプトは現在、表紙の情報（タイトル、氏名、日付）のみを入力します。テンプレートの本文は、ユーザーが手作業または他の PDF 編集ツールを使って文書を作成する際に参考にできる、専門的な枠組みとして機能します。

スクリプトの拡張

表紙以外のフィールドも入力するには、次のようにスクリプトを拡張できます。

• PDF のフォームフィールドを解析する
• 各ページの特定の座標にテキストを重ねる
• プレースホルダーテキストをプログラムで置換する

必要に応じて、scripts/generate_document.py を変更し、より高度な PDF 操作を追加してください。

データスキーマのリファレンス

各文書タイプで必須および任意のフィールドに関する詳しい情報は、次を参照してください。

• references/document_schemas.md - データ構造の完全なドキュメント

サンプルファイル

assets/examples/ に、完全に動作するサンプルがあります。

• proposal_example.json - プロジェクト提案書のサンプルデータ
• business_plan_example.json - 事業計画書のサンプルデータ
• budget_example.json - 予算計画書のサンプルデータ

新しい文書を作成する際は、これらをテンプレートとしてご利用ください。

トラブルシューティング

スクリプトの実行時にインポートエラーが発生する場合：

• 必要なパッケージをインストールします：pip install pypdf reportlab

テンプレートが見つからない場合：

• --templates-dir が assets/templates を指していることを確認します
• templates ディレクトリに PDF テンプレートファイルが存在することを確認します

生成された PDF が空白、またはデータが欠けている場合：

• JSON データファイルが適切な形式になっていることを確認します
• 必須フィールドが入力されていることを確認します（references/document_schemas.md を参照）

テンプレートをカスタマイズする場合：

• 元のテンプレートは assets/templates/ にあります
• PDF 編集ソフトウェアを使ってテンプレートを変更します
• 元のファイル名を維持するか、スクリプト内の TEMPLATE_MAP を更新します

リソース

scripts/

文書生成用の Python スクリプトが含まれています。

• generate_document.py - CLI インターフェースを備えたメインの文書生成スクリプト

このスクリプトは、トークンを効率よく使うため、コンテキストに読み込まずに直接実行できます。変更やデバッグが必要な場合は、内容を確認してください。

references/

作業中に参照するドキュメント：

• document_schemas.md - すべての文書タイプの完全な JSON データ構造

assets/

文書生成の出力に使用するファイル：

• templates/ - 各文書タイプ用の専門的な PDF テンプレート
  • Professional Proposal Template.pdf
  • Comprehensive Business Plan Template.pdf
  • Annual Budget Plan Template.pdf
• examples/ - 適切な構造を示す JSON データファイルのサンプル
  • proposal_example.json
  • business_plan_example.json
  • budget_example.json

これらのテンプレートとサンプルはコンテキストに読み込まれませんが、生成時に参照されます。