business-document-generator

商业文档生成器

概述

使用高质量 PDF 模板生成专业商业文档（项目提案、商业计划、年度预算）。使用捆绑的 Python 脚本，将用户提供的数据填入模板，并输出可直接分发的精美 PDF 文档。

何时使用此技能

用户提出以下需求时，启用此技能：

• 创建商业提案或项目提案
• 生成商业计划文档
• 制定年度预算计划
• 根据可用模板创建任何专业商业文档
• 使用特定数据填写商业模板

可用文档类型

此技能支持三种专业商业文档：

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"
}

**注意：**查看 assets/examples/ 中的完整 JSON 示例文件：

• 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

生成过程中不会将这些模板和示例加载到上下文中，而是直接引用。