> 执行细节(0 个章节 / 1 个代码块)已外置,执行前照读:references/implementation-details.md(grep: 实现细节)
zfl-tabular-report(台账→汇报三件套通用渲染骨架)
定位
纯展示层:不关心业务语义,只接收结构化 report model,输出三件套。
业务数据派生(台账加载、归一化、交叉校验、缺口检测)由调用方技能负责,
本技能只做"数据 → 三色汇报材料"这一件事。这正是把 zfl-contract-risk-profile
从硬编码三件套重构为"薄适配层"时抽出来的通用能力。
何时用
- 新建任何"台账/清单 → 汇报"类技能(合同风险画像、付款审核汇总、竣工资料体检、隐患整改台账…)
- 需要统一管理汇报视觉风格(深蓝
#0D1B2A+ 金#C9A66B+ 浅灰#F7F7F8,无圆角渐变无 emoji) - 需要强制 PF-712 护栏(缺维不编 + 多口径合计交叉校验 + 演示数据声明)
用法(调用方)
解析 sibling 技能路径(见下方 resolver),导入本模块
block 类型
| type | 必带字段 | 说明 |
|---|---|---|
kpi |
—(取 model.kpis/conclusion/validation) | 总体画像卡片 + 结论 + 校验声明 |
table |
headers,rows |
表格;total_row:True 给末行加合计样式 |
text |
lines:[str] |
段落流 |
gaps |
—(取 model.gaps) | 数据缺口卡(红框) |
bullets |
groups:[{title,items:[str]}] |
分组编号列表 |
PPTX 布局自动按章节内 block 组合选择:双表格→左右分栏;text+gaps→上文字下缺口框;
bullets+gaps→左列表右缺口框;单表格/单文字/单缺口→整页;其余→纵向堆叠兜底。
PF-712 护栏(强制)
- 演示数据声明:
meta.demo=True时,HTML/DOCX/PPTX 均置顶红色声明,不可直接对外决策。 - 交叉校验声明:
model.validation由调用方基于多口径合计一致产出;OK 显示绿条,偏差显示红卡。 - 数据缺口卡:
model.gaps缺维不编,显式列出"影响+补齐方式",随数据动态增减。
文件
scripts/render.py:纯渲染引擎(ensure_deps + HTML/DOCX/PPTX builder + render_report)references/schema.md:model 完整字段定义与示例
版本
当前 1.0.0。五源一致:SKILL.md / VERSION / CHANGELOG / _skillhub_meta.json / references。