名称: 商业文档生成器 描述: 当用户请求根据模板创建专业商业文档(提案、商业计划或预算)时,应使用此技能。它提供PDF模板和Python脚本,用于根据用户数据生成填充好的文档。
商业文档生成器
概述
从高质量的PDF模板生成专业的商业文档(项目提案、商业计划、年度预算)。使用捆绑的Python脚本,用用户提供的数据填充模板,并输出可供分发的精美PDF文档。
何时使用此技能
当用户要求以下操作时,请激活此技能:
- 创建商业提案或项目提案
- 生成商业计划文档
- 制定年度预算计划
- 基于可用模板创建任何专业商业文档
- 用特定数据填充商业模板
支持的文档类型
此技能支持三种类型的专业商业文档:
-
项目提案 - 面向客户项目的专业提案
- 模板:
assets/templates/Professional Proposal Template.pdf - 使用场景:向客户、利益相关者推介项目
- 模板:
-
商业计划 - 全面的商业规划文档
- 模板:
assets/templates/Comprehensive Business Plan Template.pdf - 使用场景:初创企业规划、投资者演示、战略规划
- 模板:
-
年度预算 - 详细的预算规划文档
- 模板:
assets/templates/Annual Budget Plan Template.pdf - 使用场景:财务规划、预算提案、财年规划
- 模板:
快速入门工作流程
步骤1:理解用户需求
从用户处收集以下信息:
- 所需文档类型(提案、商业计划或预算)
- 要包含的关键数据(公司名称、客户信息、日期等)
- 任何特定的定制需求
步骤2:准备数据
创建一个包含文档数据的JSON文件。有关字段要求,请参考 references/document_schemas.md 中的数据模式。
提案示例:
{
"title": "数字化转型计划",
"subtitle": "Acme公司的全面规划",
"client_org": "Acme公司",
"client_contact": "Jane Smith,首席技术官",
"company_name": "TechSolutions公司",
"contact_info": "contact@techsolutions.com",
"date": "2025年11月3日"
}
注意: 查看 assets/examples/ 目录获取完整的示例JSON文件:
proposal_example.jsonbusiness_plan_example.jsonbudget_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文件。验证文档是否成功生成,并告知用户文件位置。
详细使用说明
创建项目提案
-
收集提案信息:
- 项目标题和副标题
- 客户组织和联系人
- 您的公司名称和联系信息
- 项目详情(问题、解决方案、时间表、预算)
-
创建包含提案字段的JSON数据文件(参见
references/document_schemas.md) -
运行脚本:
python3 scripts/generate_document.py proposal proposal_data.json \ --templates-dir assets/templates -
输出:包含封面页和内容部分的专业PDF提案
创建商业计划
-
收集商业计划信息:
- 公司名称和法律结构
- 使命和愿景声明
- 目标市场详情
- 财务预测
-
创建包含商业计划字段的JSON数据文件
-
运行脚本:
python3 scripts/generate_document.py business_plan plan_data.json \ --templates-dir assets/templates -
输出:全面的商业计划PDF模板
创建年度预算
-
收集预算信息:
- 财年
- 公司名称
- 预算假设(通货膨胀、增长目标)
- 收入和支出预测
-
创建包含预算字段的JSON数据文件
-
运行脚本:
python3 scripts/generate_document.py budget budget_data.json \ --templates-dir assets/templates -
输出:包含表格和预测的年度预算计划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 - 检查模板目录中是否存在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.pdfComprehensive Business Plan Template.pdfAnnual Budget Plan Template.pdf
examples/- 展示正确结构的示例JSON数据文件proposal_example.jsonbusiness_plan_example.jsonbudget_example.json
这些模板和示例在生成过程中被引用,但未加载到上下文中。