用途:为工程与现场服务类业务构建估算、报价与投标。核心思路是避免两类高代价错误:漏掉未被定价的项目(许可证、清运、进场动员、人工附加成本),以及在脑内完成的算术(约30%加成实际只等于约23%利润率)。技能先做清单式范围排查,再用 scripts/build_quote.py 完成所有数字计算。
主要能力:不在此处做定价算术,而是写规格后运行脚本并引用其输出;脚本使用 Decimal 运算,与所写 Excel 公式采用相同舍入,使 PDF、客户 xlsx 与内部表分毫不差。支持按行业扫描缺失项,将未处理项标记为 [CHECK] 行;支持 base_items、tiers、add_ons 结构;输出含实时公式的客户报价单、内部成本表与 summary.json。
使用方式:收集工作范围与企业自身数字(各角色基本工资、人工附加比例、管理费回收、目标利润率或加成、供应商价格、司法辖区税则);若用户没有数字,可参考 references/unit-cost-starter.md 并标注为占位符。查看 references/scope-checklists.md 逐项确认易遗漏项。写 YAML 或 JSON 规格后运行:python scripts/build_quote.py spec.yaml --check(校验与合计,不写文件);python scripts/build_quote.py spec.yaml --out ./quotes(生成 xlsx、pdf、内部表和 summary.json);python scripts/build_quote.py spec.yaml --explain LINE(展示某一行每一步计算);python scripts/build_quote.py --margin-to-markup 0.30。依赖 openpyxl、pyyaml 与 reportlab(PDF 缺失时干净跳过)。发送前检查净利率与目标差距、有效小时费率、选项阶梯,并用 --explain 手算一行。
限制与注意:必须明确使用利润率还是加成,脚本拒绝同时设置两者;$margin = profit / price$,$markup = profit / cost$。目标应用于含直接成本、应急与管理费的加载成本。税模式因辖区与工种而异,需询问而非假设,并提示用户与会计确认。支付条款、定金、取消权与留置通知受州与国法规约束,应参考 references/terms-and-exclusions.md 并由用户自己的律师审阅,不提供法律建议。示例与共享模板不得出现客户名称,使用占位符。未提供具体价格、行业默认费率或平台收费信息。