报价单工作流

自动化生成报价单（Excel/Word/HTML/PDF），集成数据验证防止示例数据，支持 OKKI CRM

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "报价单工作流" with this command: npx skills add cjboy007/quotation-workflow

📋 报价单工作流

自动化生成专业报价单，支持 Excel/Word/PDF 三种格式。

🔴 v3.0.0 新增：数据验证系统

  • ✅ 生成前强制验证客户/产品/条款数据
  • ✅ 检测示例数据/占位符数据（公司名/邮箱/地址/电话）
  • ✅ 验证失败立即终止，防止误发示例报价单
  • ✅ Excel/Word/HTML 三格式统一验证

🔴 数据验证系统（v3.0.0 新增）

验证范围

生成前强制验证（所有格式）：

  • ✅ 客户信息：公司名/邮箱/地址/电话（非示例数据）
  • ✅ 报价单号：格式（QT-YYYYMMDD-XXX）+ 非示例
  • ✅ 产品列表：非空 + 名称/价格/数量有效
  • ✅ 贸易条款：Incoterms/货币/交期
  • ✅ 日期：格式 + 逻辑（有效期 > 报价日期）

示例数据检测：

  • ❌ 公司名包含 example/test/sample/quadnet 等关键词
  • ❌ 邮箱域名 example.com/test.com/gmail.com 等
  • ❌ 地址占位符 123 Business St/Your City/xxx District
  • ❌ 电话占位符 123456789/000000000
  • ❌ 报价单号 QT-TEST-001/QT-000 等

验证失败处理：

🔍 验证报价单数据...
❌ 数据验证失败，报价单生成已终止:
  1. 公司名称包含示例关键词：Example Corp
  2. 使用测试邮箱域名：test@example.com
  3. 地址包含占位符：123 Business St

请检查数据文件，确保使用真实客户信息。

绕过限制（仅限开发环境）：

# HTML 脚本支持 --skip-validation（需环境变量）
export QUOTATION_DEV_ENV=true
python3 generate_quotation_html.py --data test.json --output test.html --skip-validation

# Excel/Word 脚本无跳过选项，强制验证

⚠️ 重要教训（必读！）

教训 1：邮件附件必须使用 HTML 转换的 PDF

✅ 邮件附件 = HTML 转换的 PDF（现代设计，专业美观）
⚠️ Excel PDF  = 内部存档（传统风格，不发送客户）

教训 2：禁止使用示例报价单发送给客户 ⭐⭐⭐

事件： 2026-03-15 给美国客户发开发信时，直接使用了 examples/QT-TEST-001-Final.pdf 示例文件。

问题：

  • ❌ 报价单上没有客户公司名称和地址
  • ❌ 产品列表不是针对客户需求定制的
  • ❌ 显得不专业，像群发垃圾邮件

正确流程（必须遵守）：

1. 收集客户信息（公司名、地址、行业、联系人）
2. 创建报价单数据文件（JSON 格式）
   位置：data/<客户简称>.json
3. 调用报价单生成 skill
   bash scripts/generate-all.sh data/<客户数据>.json QT-<日期>-<客户简称>
4. 确认生成的 PDF 文件（*-Final.pdf 或 *-HTML.pdf）
5. 发送邮件时附上这份专属报价单

原则：

每次开发信必须生成新的专属报价单，禁止使用示例文件。
示例文件仅用于测试和演示，绝对不能发送给真实客户。

记忆口诀：

开发信三件套：个性化正文 + 产品目录 + 专属报价单 ⭐
示例文件 = 测试用，禁止发给客户 ❌

错误案例（不要这样做）：

# ❌ 错误：发送 Excel 转换的 PDF
soffice --headless --convert-to pdf QT-001.xlsx
# 问题：设计简单，不够专业

正确流程（必须这样做）：

# ✅ 正确：发送 HTML 转换的 PDF
python3 generate_quotation_html.py --data data.json -o QT-001.html
chrome --headless --no-pdf-header-footer \
  --print-to-pdf=QT-001.pdf file://QT-001.html
python3 add-pagenumbers.py QT-001.pdf QT-001-Final.pdf
# 邮件附件：QT-001-Final.pdf ⭐

记忆口诀：

邮件附件 = HTML 的 PDF ⭐
Excel PDF = 内部存档

📧 邮件发送规则

重要：邮件附件使用 HTML 转换的 PDF

✅ 邮件附件 = HTML 转换的 PDF（现代设计，专业美观）
⚠️ 不是 Excel 转换的 PDF（传统风格，仅内部存档）

🚀 快速开始（标准工作流）

方式 1：一键生成（最简单 ⭐）

# 一键生成所有格式（Excel + Word + HTML + PDF）
# 🔴 v3.0: 自动生成前强制验证数据
skills/quotation-workflow/scripts/generate-all.sh \
  my_quotation.json \
  QT-20260314-001

# 验证失败示例:
# ❌ 数据验证失败，报价单生成已终止:
#   1. 公司名称包含示例关键词：Example Corp
#   2. 使用测试邮箱域名：test@example.com

# 邮件附件：QT-20260314-001-HTML.pdf ⭐

方式 2：标准流程（带页码）

# 1. 准备数据
cp skills/quotation-workflow/examples/farreach_sample.json \
   my_quotation.json

# 2. 生成 HTML
python3 skills/quotation-workflow/scripts/generate_quotation_html.py \
  --data my_quotation.json \
  --output QT-20260314-001.html

# 3. Chrome 导出 PDF（无页眉页脚）
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless --disable-gpu --no-pdf-header-footer \
  --print-to-pdf=QT-20260314-001.pdf \
  "file://$(pwd)/QT-20260314-001.html"

# 4. 添加页码（底部右侧）
python3 skills/quotation-workflow/scripts/add-pagenumbers.py \
  QT-20260314-001.pdf \
  QT-20260314-001-Final.pdf

# 邮件附件：QT-20260314-001-Final.pdf ⭐

方式 3：单独生成

# Excel 版本
python3 skills/excel-xlsx/scripts/generate_quotation_traditional.py \
  --data my_quotation.json --output QT-001.xlsx

# Word 版本
python3 skills/word-docx/scripts/generate_quotation_docx.py \
  --data my_quotation.json --output QT-001.docx

# HTML 版本（现代设计，推荐 ⭐）
python3 skills/quotation-workflow/scripts/generate_quotation_html.py \
  --data my_quotation.json --output QT-001.html

数据格式

完整示例

{
  "customer": {
    "company_name": "客户公司名称",
    "contact": "联系人姓名",
    "email": "customer@example.com",
    "phone": "+1-234-567-8900",
    "address": "客户地址"
  },
  "quotation": {
    "quotation_no": "QT-20260314-001",
    "date": "2026-03-14",
    "valid_until": "2026-04-13"
  },
  "products": [
    {
      "description": "HDMI 2.1 Ultra High Speed Cable",
      "specification": "8K@60Hz, 48Gbps, 2m",
      "quantity": 500,
      "unit_price": 8.50
    }
  ],
  "currency": "USD",
  "payment_terms": "T/T 30% deposit, 70% before shipment",
  "lead_time": "15-20 days after deposit",
  "freight": 150.00,
  "tax": 0,
  "notes": "1. 以上价格基于当前原材料成本\n2. 最终价格以确认为准"
}

字段说明

字段类型必填说明
customer.company_namestring✅客户公司名称
customer.contactstring✅联系人姓名
customer.emailstring✅联系邮箱
customer.phonestring❌联系电话
customer.addressstring❌客户地址
quotation.quotation_nostring✅报价单号
quotation.datestring✅报价日期 (YYYY-MM-DD)
quotation.valid_untilstring✅有效期至
productsarray✅产品列表
products[].descriptionstring✅产品描述
products[].specificationstring✅规格型号
products[].quantitynumber✅数量
products[].unit_pricenumber✅单价 (USD)
currencystring❌币别 (默认：USD)
payment_termsstring❌付款条款
lead_timestring❌交货期
freightnumber❌运费
taxnumber❌税费
notesstring❌备注

脚本位置

功能脚本路径验证集成
Excel 生成skills/excel-xlsx/scripts/generate_quotation.py✅ v3.0
Excel 读取skills/excel-xlsx/scripts/read_excel.py❌
Word 生成skills/word-docx/scripts/generate_quotation_docx.py✅ v3.0
Word 读取skills/read-docx/read-docx.py❌
HTML 生成 ⭐skills/quotation-workflow/scripts/generate_quotation_html.py✅ v3.0
数据验证skills/quotation-workflow/scripts/quotation_schema.py✅ 核心模块
发送前检查skills/quotation-workflow/scripts/pre_send_checklist.py✅ v3.0
PDF 转换skills/quotation-workflow/scripts/convert-to-pdf.sh❌
一键生成skills/quotation-workflow/scripts/generate-all.sh✅ v3.0

📎 产品目录（Catalogue）

统一位置： obsidian-vault/Farreach 知识库/02-产品目录/

可用目录：

  • SKW 2026 catalogue-15M.pdf - 2026 版完整产品目录

邮件发送示例：

node scripts/smtp.js send \
  --to "customer@example.com" \
  --subject "🔌 Product Catalog & Quotation" \
  --html --body-file "email.html" \
  --attach "obsidian-vault/Farreach 知识库/02-产品目录/SKW 2026 catalogue-15M.pdf" \
  --attach "QT-20260314-001-Final.pdf"

示例文件

skills/quotation-workflow/examples/
├── farreach_sample.json                    # Farreach 产品示例
├── QT-20260314-001-Farreach.xlsx          # Excel 示例
├── QT-20260314-001-Farreach.docx          # Word 示例
├── QT-20260314-001-Farreach.html          # HTML 示例（现代设计 ⭐）
└── QT-20260314-001-Farreach.pdf           # PDF 示例

常用命令

读取 Excel 内容

python3 skills/excel-xlsx/scripts/read_excel.py \
  "QT-*.xlsx" --format table -v

批量转换 PDF

skills/quotation-workflow/scripts/convert-to-pdf.sh \
  *.xlsx *.docx

指定输出目录

OUTPUT_DIR=/path/to/output \
  ./convert-to-pdf.sh QT-20260314-001.xlsx

依赖

  • Python 3 (已安装)
  • openpyxl (Excel 处理，已安装)
  • python-docx (Word 处理，已安装)
  • LibreOffice (PDF 导出，已安装 🍺)

集成 OKKI CRM（Phase 2）

待实现：

  • 从 OKKI 自动读取客户信息
  • 从 OKKI 产品库获取价格
  • 报价单关联客户 ID
  • 自动创建跟进记录

邮件发送（Phase 3）

待优化

  • Excel 列宽优化 — 序号列太宽，需要调窄（2026-03-26 反馈）
  • 自动附加 PDF 报价单
  • 邮件模板
  • 发送记录归档

常见问题

Q: 中文文件名乱码？

A: 使用 glob 通配符：

python3 read_excel.py "报价单*.xlsx"  # ✅
python3 read_excel.py "报价单 123.xlsx"  # ❌ 可能失败

Q: PDF 转换失败？

A: 检查 LibreOffice 是否安装：

which soffice  # 应该输出 /opt/homebrew/bin/soffice

Q: 如何批量生成？

for file in quotations/*.json; do
  python3 generate_quotation.py --data "$file" \
    --output "output/$(basename $file .json).xlsx"
done

相关文档

  • 快速开始： QUICK_START.md
  • 完整文档： README.md
  • 工具集成： workspace/TOOLS.md

版本历史

  • 3.0.0 (2026-03-27) - 🔴 数据验证系统

    • ✅ quotation_schema.py - 完整数据验证模块（12.9KB）
    • ✅ pre_send_checklist.py - 发送前强制检查清单（11.8KB）
    • ✅ Excel 脚本集成验证（防止绕过）
    • ✅ Word 脚本集成验证（防止绕过）
    • ✅ HTML 脚本集成验证 + --skip-validation 环境限制
    • ✅ generate-all.sh 生成前强制验证
    • ✅ 示例数据检测（公司名/邮箱/地址/电话/报价单号）
    • ✅ 验证失败立即终止，无法绕过
    • ✅ P0-REVISE 修复（5 个严重问题全部解决）
    • ✅ 生产审核通过（置信度 92%）

  • 2.1.0 (2026-03-14) - HTML 版本新增

    • ✅ HTML 报价单生成（现代设计，Tailwind CSS）
    • ✅ 一键生成脚本更新（支持 HTML）
    • ✅ 浏览器直接导出 PDF（高质量）

  • 1.0.0 (2026-03-14) - 初始版本

    • ✅ Excel 生成/读取
    • ✅ Word 生成/读取
    • ✅ PDF 导出
    • ✅ 示例数据和模板

    <description>待补充描述</description> <location>skills/quotation-workflow</location>

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

Video Maker Linkedin

Turn a 60-second screen recording or three headshot photos into 1080p LinkedIn-ready videos just by typing what you need. Whether it's creating professional...

Registry SourceRecently Updated
00vynbosserman65
General

Skill

龙虾船长 - 零玩家游戏，AI 扮演大航海时代商船船长，自主观察行情、低买高卖、扬帆远航

Registry SourceRecently Updated
1450ryanbihai
General

Generator From Photo

Skip the learning curve of professional editing software. Describe what you want — turn my photos into a smooth video slideshow with transitions and music —...

Registry SourceRecently Updated
00mhogan2013-9
General

Generator Canva

Turn five product images and a logo file into 1080p designed video content just by typing what you need. Whether it's generating branded videos from images u...

Registry SourceRecently Updated
00peand-rover