official-document-generation（正式申报文档生成）

触发条件

当用户出现以下意图时使用本 skill：

"生成/编写/起草申报材料/政府材料/正式文档"
"写零碳工厂/绿色工厂/节能报告/碳足迹报告建设方案"
"编制申报书/评价报告/可行性研究报告"
"整理正式申报文档/政府材料"

适用范围

✅ 正式申报材料（零碳工厂、绿色工厂、节能报告、碳足迹报告等）
✅ 政府材料（含官方模板、填写说明、证明材料目录）
✅ 需要数据可追溯、应对评审的文档
❌ 不适用：纯创意文档、营销文案、内部备忘录

强制 4 阶段流程（每阶段有 checkpoint，禁止跳步）

[阶段 1: 数据字典]  汇总关键指标 + 权威值 + 来源 doc
   │  ⛔ 拦截：未建字典不得进入框架
   ▼
[阶段 2: 框架]  输出章节骨架，与官方模板对齐
   │  ⛔ 拦截：用户未确认框架不得写正文
   ▼
[阶段 3: 正文]  分章节生成，每三级标题首段标来源
   │  ⛔ 拦截：引用数字必须命中字典
   ▼
[阶段 4: 一致性检查]  全文扫描数字唯一性/单位统一/时间口径
   │  ⛔ 拦截：发现冲突必须修复
   ▼
[输出]

阶段 1：建数据字典（强制）

目的：在写正文前，先把所有关键数字汇总成一张表，每个指标只有一个权威值。

数据字典模板

指标	权威值	单位	来源 doc	来源类型
2025 整车销量	150169	辆	doc3 ESG报告	第二方
2025 营业收入	348.65	亿元	doc3 ESG报告	第二方
2025 总排放量	53747	tCO2e	doc6 核查报告	第三方
自发光伏电量	2022.194	万kWh	doc5 通知	第一方
...	...	...	...	...

权威值优先级（高→低）

第三方核查报告（如温室气体核查报告、第三方评价报告）— 最高权威
ESG/年度报告（上市公司公开披露）— 第二权威
内部测算/能源统计表（企业自有台账）— 第三权威
向量检索多 chunk（索引文档中多处出现，取多数一致值）— 兜底

规则：同一指标若多源冲突，按优先级取值；不得在全文并存两个值。

与 document-indexing skill 协作

若已用 document-indexing skill 建好索引，可调用查询：

cd ~/.voyah/skills/document-indexing/scripts
node query.mjs "2025年整车销量" 5
node query.mjs "温室气体总排放量" 5

查询结果含 sourceDoc/pageNo，直接填入数据字典"来源 doc"列。

阶段 2：输出框架（强制）

目的：先出章节骨架，用户确认后再写正文，避免返工。

框架要求

严格对应官方模板（如"附件2"对应的章节顺序）
基本信息表、填写说明、证明材料目录等附属部分必须完整
层次保持扁平（最多 3 级标题），避免 1.1/1.1.1 过深
每个章节列出：核心论点 + 关键数据（引用字典）+ 数据来源

典型官方模板结构（零碳工厂/绿色工厂类）

基本信息表
一、概况
  （一）申报单位基本情况
  （二）主要生产工艺或算力设施运行情况
  （三）能源利用状况
  （四）碳排放情况
二、建设基础
  （一）科学算碳
  （二）源头减碳
  （三）过程脱碳
  （四）协同降碳
  （五）智能控碳
  （六）碳抵销和信息披露
三、建设目标分析
  （一）能源消费、碳排放趋势及目标可达性分析
  （二）建设目标
四、建设路径
  （一）主要任务
  （二）重点项目
五、预期成效
  （一）经济效益
  （二）社会效益
  （三）生态效益
证明材料目录

⛔ 拦截：框架必须经用户确认后才能进入阶段 3。

阶段 3：写正文（强制）

数据来源标注规则（以三级标题为单位）

每个三级标题（如"1. 2025年度能源消费总体情况"）下的首段应说明数据来源
引用索引数据时标注 doc1-doc7 对应来源
关键证明材料在正文中提及对应文件名（如"取自《2025年度温室气体核查报告》"）
不要每个数字逐条标注，以三级标题为单位整体说明即可

示例：

1. 2025年度能源消费总体情况

本章节全部能源消费数据均取自2025年度能源消耗统计表、年度电力、天然气、汽油原始发票台账，统计周期2025年1月1日至12月31日。

全年外购国网电力6227.753万千瓦时...

单位规范表（强制）

指标类型	规范写法	禁止写法
功率	kW（小写k大写W）	KW、kw、Kw
电量	kWh、万kWh	KWH、kwh
标准煤	tce	吨标煤、TCE
二氧化碳排放（纯CO2）	tCO₂	tCO2、tco2
二氧化碳当量（含冷媒）	tCO₂e	tCO2e、tco2e
质量	t、kg	T、KG
体积	m³、Nm³	M3、m3
货币	亿元、万元	亿、万

关键区分：

tCO₂ = 纯二氧化碳（不含冷媒逃逸）
tCO₂e = 二氧化碳当量（含冷媒 HFC 等温室气体折算）
两者不能混用，全文必须统一口径

篇幅约束

目标篇幅：2-3 万字（精炼优于冗长）
结构层次：最多 3 级标题（一/（一）/1.），禁止 1.1/1.1.1
重点项目：用简洁条目列出（名称/投资/周期/内容/成效），不要用"项目要素/内容"表格展开
删除重复性描述：同一项目不要在不同章节重复 3-4 次

待补充标黄规则

所有"待补充"部分必须标黄处理（含 [待补充] 占位符 + 含"补充"关键词的整句）
最后"证明材料"部分不用管，用户会手动添加

阶段 4：一致性检查（强制）

生成完成后，必须逐项扫描以下检查点并报告结果：

检查清单

数字唯一性：关键指标全文唯一，无两个冲突值（如 0.0046 与 0.005044 不能并存）
单位统一性：全文符合单位规范表（kW 不写 KW、tCO₂ 与 tCO₂e 不混用）
时间口径一致：如"2027年通过认证" vs "2030年通过认证"不能并存
数据来源标注：每个三级标题首段是否说明来源
权威值优先级：关键数据是否取自第三方核查报告（而非内部测算）
结构扁平：层次不超过 3 级
篇幅控制：2-3 万字，无重复性描述
证明材料目录：系统完整（参考下方模板）

证明材料目录模板

1. 企业营业执照、统一社会信用代码复印件
2. 光伏二期合作协议
3. 绿色电力交易凭证、绿电消费凭证
4. [年度]温室气体第三方核查完整报告
5. 《碳排放管理办法》《能源管理办法》内部制度文件
6. [年度]节能报告
7. 核心再生材料、整车碳足迹第三方认证证书
8. 动力电池回收合作协议、全国回收网点台账
9. IOT能碳管理平台功能界面截图
10. [年度]ESG环境社会治理完整年度报告
11. ISO9001/14001/45001/50001体系认证证书
12. 企业近三年无安全、环保、失信处罚信用证明
13. 其他支撑建设方案真实性的配套佐证材料

与其他 skill 协作

document-indexing：阶段 1 建数据字典时，调用 query.mjs 从已索引文档检索关键数据
查询结果含 sourceDoc/pageNo，直接用于数据字典和正文来源标注

常见踩坑（从零碳工厂建设方案复盘提炼）

1. 数据自相矛盾

坑：同一指标全文出现两个值（如光伏发电量 630 vs 733 万kWh）
解：阶段 1 建数据字典时锁定唯一权威值，阶段 4 全文扫描冲突

2. 来源标注缺失

坑：大量数据未标注来源，违反硬性要求
解：阶段 3 每个三级标题首段强制说明来源

3. 篇幅失控

坑：项目用表格展开导致 4 万字，评审阅读负担重
解：阶段 3 篇幅约束 2-3 万字，项目用简洁条目

4. 时间口径漂移

坑：不同章节时间目标不一致（如 2027 vs 2030 通过认证）
解：阶段 4 检查时间口径一致性

5. 单位混用

坑：kW/KW、tCO₂/tCO₂e 混用
解：阶段 3 强制单位规范表，阶段 4 扫描

official-document-generation

SKILL.mdskills/official-document-generation/SKILL.md