风电EPC工程管理（wind-epc-manager）

Overview

为陆上/海上风电EPC项目提供全流程专业能力，覆盖工程总监最关心的三件事：
1. 成本预算 —— 成本测算表 + 成本看板 + 成本预算PPT；末页明确"成本价 vs 项目给出价"对比，判定"可以施工 / 不可施工"。
2. 施工合同与各类文件 —— 施工承包合同、施工组织设计等，一切按电力系统新能源风电规范执行，要求真实、严谨、无AI味。
3. 施工结算（对甲方 + 对乙方） —— 竣工结算书、结算表、结算PPT报告；末页明确"本项目是否盈利"。

以风电三级成本科目体系、风电规范/条款红线、双向结算铁律为核心知识，配套 Excel/DOCX/PPTX 生成脚本与可视化看板，输出达到造价咨询/商务经理/技术负责人专业水准。计价核心单位为 元/kW（区别于光伏的元/W）。

统一项目档案（关键：保证成套交付物一致）

所有生成器共用一份项目档案 JSON（范本见 assets/sample_wind_project.json）：
- 顶层 meta：名称/装机 capacity_mw/机组 wtg_count+wtg_mw/场型 site_type(陆上/海上)/地点/电压/甲乙方/日期/tax_note/energy_kind("wind")；
- benchmark_price_per_kw：项目给出价/业主限价/中标价/目标成本（元/kW） —— 填了才出"可以施工/不可施工"判定；
- categories：五大成本科目（设备安装/建筑/措施/其他/基本预备费）；
- contract：合同段；org：施工组织段；
- settlement：结算段（to_owner 对甲方 + to_sub 对乙方 + other_cost_cny 其他成本，用于盈亏判定）。

务必：编制成套产物时先据实填好一份档案，再逐个生成，避免项目主体、金额、日期串台。

使用总则（先读）

0. 【联动铁律 · 用户硬性要求】所有成本/报价/结算类 Excel 交付物（成本测算表、报价明细表、结算明细表等）一律做成全联动模型：数量、单价为可改输入（参数页蓝色），合价=数量×单价、小计=SUM、合计、占比、单位造价(元/kW)、预备费、利润判定全部用公式引用，改任意一个输入数字，全表自动重算，禁止输出"改一处其余不变"的静态数字表。用户不会每次单独强调，须默认执行（范本：全联动模型 = 参数输入页 + 全公式成本表 + 全公式判定页，参考 references/cost.md 联动要点）。
   0.1. 【结论联动铁律 · 用户硬性要求】所有成本/报价/测算/结算的「结论行」必须由 IF 公式按成本价 vs 控制价/目标价自动生成，包括但不限于："可以施工 / 不可施工"、"成本价 X 元/kW ≤ 业主控制价 Y 元/kW"、"建议议价至 ≥X 元/kW 或缩减 PC 范围"、"本项目盈利 / 亏损"等。结论文本随输入参数（数量/单价/控制价/利润率）变化自动更新，禁止硬编码写死结论（如预设"不可施工"或"亏损 X 万元"后改一个数字结论不动）。用户不会每次单独强调，须默认执行。
1. 先判定场景：成本预算 → 读 references/cost.md；合同/文档 → 读 references/contracts.md；结算 → 读 references/settlement.md。跨场景任务按需组合加载。
2. 严谨性红线：单价须标注来源（合同价/询价/指标估算），禁止把区间中值伪装成精确报价；机组价必须注明"含塔筒/不含塔筒"口径且锁定价格基准期与交货期，报价前先读 references/market_bids.md 取同口径最近批次锚点；全套统一含税/不含税口径；措施费（大件运输/吊装措施/安全文明）逐项单列不打包；合同与结算文本附"须经法务/造价审核"提示。
   - 源文件"单瓦造价"列与"合价"列可能内部不一致（常态）。一律以合价(万元)为权威：元/W = 合价万 ÷(MW×100)，元/kW = 合价万 ÷(MW×0.1)；禁止直接采信源文件单瓦列。
   - 校验钩子**：安全文明施工费 = 建安费(不含安全文明)×2.5%；"设备=全部设备"时 施工费用 = 建安+其他（科目三+四）。两处任一不等即拆分有误，须先修正再出结论。
3. 结算立场先确认：对甲方（报审，报得全守得住）还是对乙方（审核，审得严扣得有据），策略不同，见 references/settlement.md。

能力一：成本预算（含"能不能施工"判定）

工作流：
1. 收集参数：装机容量(MW)、机组机型/台数、场型(陆上/山地/海上)、电压等级、有无送出。缺失时按典型假设并明示。
2. 先读 references/market_bids.md 取最近批次机组中标锚点，明确"含塔筒/不含塔筒"口径后，按机型容量/区域/塔型做校准（见 market_bids.md 第三节）；再加载 references/cost.md，按五大科目三级列项（风机含塔筒/基础/吊装/集电线路/升压站/送出/其他），逐项给数量、单位、单价(元/kW或元/台/元/km)、合价、元/kW、占比；建安/基础/管线/接地等施工综合单价，优先取 references/construction_unit_prices.md（living log，按区域/地质锚定，禁止拍脑袋）；基础劳务分包（清包工）单价取 references/labor_subcontract_prices.md，务必与综合单价口径区分、禁止混用（见该库「口径红线」三层价表）。
3. 生成成本测算 Excel：
bash python scripts/gen_cost_excel.py <project.json> <成本预算书.xlsx>
自动样式、小计、占比、单位造价校核（按 site_type 切陆上4500~8000 / 海上10000~18000 元/kW，超区间预警）。
档案填 benchmark_price_per_kw 后，Excel 末尾自动生成"成本价与项目报价对比判定总结"区（成本价/项目给出价/差额三行 + 红色加粗结论行"结论：可以施工/不可施工"）。
4. 生成成本预算 PPT（末页判定页）：
bash python scripts/gen_report_pptx.py <project.json> budget <成本预算汇报.pptx>
含 benchmark_price_per_kw 时，末尾自动插入判定章节页 + 红色横幅大字"结论：可以施工 ✔ / 不可施工 ✘"。
5. 成本看板（可选）：复制 assets/cost-dashboard.html，将 /*__PROJECT_DATA__*/null 替换为档案 JSON 内容 → 深色风电成本看板（KPI+判定横幅+构成饼图+TOP12条形+科目表）。
6. 判定规则：成本价（测算单位造价）≤ 项目给出价 → 可以施工；＞ → 不可施工，附盈余/超支金额与占比。

能力一·之二：施工合同费用分析（扣设备价 + 管理费计提 → 能不能干）

适用：甲方按 元/W（或元/kW）总包价，合同约定"减去设备价格、剩余为施工费用、施工费用×N% 为管理费"的施工合同结构（如穆棱项目 3.51元/W 合同）。目标输出"能不能干"的严谨结论。

工作流：
1. 锁定总包单价与设备口径：总包价通常取自项目估价表"合计单瓦造价"（如 3.51元/W）；设备 = 文件中归类为"设备"的全部科目（风机+塔筒+箱变+升压站），须明示口径，禁止漏扣/多扣。
2. 逐设备扣减（设备单价须取自文件/中标锚点，禁止编造）：
- 施工费用 = 总包价 − Σ设备价；元/W 一律由 合价(万元)÷容量 重算，不以源文件单瓦列为准（该列常与合价不一致，见总则红线）。
3. 管理费计提：管理费 = 施工费用 × N%（如 3%）；施工净价 = 施工费用 ×(1−N%)。
4. 严谨性校验（恒等式）：设备=全部设备时，施工费用 应 = 建安+其他（科目三+四）；另验 安全文明 = 建安(不含)×2.5%。任一不等说明拆分有误。
5. 能不能干 · 双情景：
- A（管理费含于施工费内）：施工费 = 施工成本 → 持平、零利润零余量，任何波动即亏。
- B（管理费从施工费计提 N%）：实体工程预算 = 施工费×(1−N%)；实体工程成本 = 建安+其他 − 已含总包管理费；若 预算 < 成本 → 缺口 = N%×施工费，必亏。
6. 敏感性：设备价下行（如升压站设备按市场≈3800万 而非文件5952万扣减）→ 施工费上升 → 可能转盈。须注明设备实际扣减价假设。
7. 除外提示：总包价常不含 土地征租/青苗/耕地占用税/水保补偿/储能，若落入施工方将加大缺口。
8. 输出：分析表（说明与假设 / 施工费用分析 / 能不能干结论 三表），结论须明确"能/不能干"及前提条件。案例见 references/muling_300mw_case.md。

能力二：施工合同与工程文档（按风电规范）

工作流：
1. 加载 references/contracts.md（法规+风电标准 GB 51096/NB/T 10101/GB/T 31996/DL/T 5383/DL 5009 等）。
2. 一键生成施工承包合同 DOCX（标题层级+付款节点表+里程碑表+签署栏，条款含风电特有内容：大风窗口期顺延、大件运输/吊装界面、性能考核偏差、甲供设备交接）：
bash python scripts/gen_construction_contract.py <project.json> <施工承包合同.docx>
3. 一键生成施工组织设计 DOCX（编制依据/工程概况/施工部署/进度表/主要方案：道路吊装平台·风机基础·风机吊装·集电线路·升压站/质量安全文明）：
bash python scripts/gen_construction_org.py <project.json> <施工组织设计.docx>
4. 审查合同：逐条对照风险红线（无上限赔偿、电量保证、以审计为准无时限、超长账期背靠背等），输出❌/⚠️/✔分级表。
5. 文档管理：按四阶段矩阵（开工前/施工过程/并网验收/竣工结算）生成核对表（责任方/时限/状态）。
6. 去AI味要求：条款可执行、有主体、有时限、有依据，引用现行风电规范，避免空话套话。

能力三：施工结算（对甲方 + 对乙方，末页判定盈亏）

工作流：
1. 加载 references/settlement.md，先确认立场。
2. 一键生成竣工结算书 XLSX（四表：①工程结算明细表·按成本科目（参照成本预算表结构，含预算/结算数量、单价、合价(万元)、单位指标(元/kW)、占比、增减额、增减率对比，结算量价缺省取预算、可在档案 categories 各项填 settled_qty/settled_price 表达结算增减）/②双向汇总/③对甲方明细/④对乙方明细；A合同内+B调整+C扣减+D待批分区，合计用公式勾稽；双向汇总页含"全成本利润测算"块 + 红色盈亏结论）：
bash python scripts/gen_settlement_excel.py <project.json> <竣工结算书.xlsx>
3. 一键生成竣工结算报告 DOCX（封面/依据/对甲方结算/对乙方结算/双向对比/第六章 全成本利润测算与盈亏结论（红色明确本项目盈利/亏损）/风险跟办/签署栏，附人民币大写）：
bash python scripts/gen_settlement_report.py <project.json> <竣工结算报告.docx>
4. 一键生成竣工结算 PPT 报告（结算概述/对甲方收入/对乙方支出/利润测算/末页红色大字"结论：本项目盈利 ✔ / 亏损 ✘"）：
bash python scripts/gen_report_pptx.py <project.json> settlement <竣工结算汇报.pptx>
5. 盈亏铁律：项目利润 = 对甲方结算总额(收入) − [对乙方施工分包结算 + other_cost_cny(设备采购/设计/监理等)]。风电机组/电气设备采购金额巨大，必须计入 other_cost_cny，否则"毛差"会把利润严重虚高。
6. 报审/审核：对甲方对照"审计核减点"自查；对乙方"量价双审"套标准扣款清单；待批签证单列D区、不计入结算总额。

成套交付一键流程（推荐）

先备好一份统一档案 project.json，按序执行：

python scripts/gen_cost_excel.py            project.json 1_成本预算书.xlsx
python scripts/gen_report_pptx.py           project.json budget     1_成本预算汇报.pptx
python scripts/gen_construction_contract.py project.json 2_施工承包合同.docx
python scripts/gen_construction_org.py      project.json 2_施工组织设计.docx
python scripts/gen_report_pptx.py           project.json scheme     2_施工方案汇报.pptx
python scripts/gen_settlement_excel.py      project.json 3_竣工结算书.xlsx
python scripts/gen_settlement_report.py     project.json 3_竣工结算报告.docx
python scripts/gen_report_pptx.py           project.json settlement 3_竣工结算汇报.pptx

成本看板：复制 assets/cost-dashboard.html，将 /*__PROJECT_DATA__*/null 替换为档案 JSON 内容。

> 依赖安装：pip install openpyxl python-docx python-pptx。
> Windows 建议在虚拟环境中运行，例如 python -m venv .venv && .venv\Scripts\activate。

每日价格盯盘（每日 17:00 自动运行）

本 skill 配套一条每日 17:00 的自动化：全网采集风电采购成本 → 三重校验 → 入库 → 出日报 → 上传 IMA 知识库。

• 作业指导书：references/daily_price_watch.md（SOP / 当前有效锚点总表 / 采集日志 / 信源清单 / 日报模板 / 质量红线）。做任何报价前，先查该文件 §二 锚点总表取当前有效价。
• 核心规则：当日无新公示的品类，一律沿用最新一次有效报价并标注"沿用自 YYYY-MM-DD"，禁止留空、禁止插值、禁止造数。
• 采集六大品类：机组（含塔筒 / 不含塔筒）、塔筒单采、箱变·升压站·集电线路、建安吊装、EPC/PC 总承包。
• 写库前三重校验：口径（含塔筒？含机组？含税？）→ 算术（单价一律 报价÷容量 自算，不采信原文折算值）→ 区间（偏离既有锚点 >25% 须说明原因）。
• 日报落盘：<价格日报目录>/风电采购价格日报_YYYY-MM-DD.md（首次使用时自行指定本地目录）。
• 知识库归档（可选）：若已连接 ima 知识库连接器，可三步归档 create_media → scripts/ima_cos_upload.py（PUT 到 COS）→ add_knowledge；knowledge_base_id 需替换为你自己的知识库 ID。未连接连接器时跳过此步，不影响其余功能。
• 反哺：新数据若推翻/收窄 market_bids.md §三 校准规则，须同步改写规则并在采集日志注明"已回填"。这是 skill 越用越准的关键。

> 典型陷阱（已写入 market_bids.md §5.7）：陆上风电 EPC 报价 < 2000 元/kW 基本可断定为甲供机组口径，当全口径 EPC 锚点用会让整套成本测算作废。

数据入库与知识更新协议（持续完善 skill 用）

用户提供新中标公示 / 招标清单单价 / 项目估价表时，按下列分流追加到对应 living log（保留历史、不覆盖），使本 skill 越用越准：

红线（入库必守）：
- 每条数据标注来源 + 公示/中标日期 + 口径（含税/含主材/PC或EPC）；禁止把区间中值伪装成精确报价。
- 单价入库前做合理性校验（与既有锚点区间比对，异常值须说明），确认无误再写。
- 新增参考文件时，同步更新本 SKILL.md 的「Resources」表；新锚点同步回填对应「速查/摘要」小节。
- 机组价严格区分含/不含塔筒；PC 与 EPC 总价口径不同，禁止混用。

> 例：吉林白城 100MW（2026-08-03 公示）已入库 —— 机组/PC 总价见 market_bids.md §5.5，19 项建安单价见 construction_unit_prices.md §四。

Resources

> 依赖：openpyxl（Excel）、python-docx（Word）、python-pptx（PPT）。生成器均从统一档案取数，确保成套产物项目主体、金额、日期一致。