# Structured Data Doc Delivery

> Use when 用户要求基于现有资料、附件、Excel/在线表格、文档章节或多源信息完成资料整理成文档、生成报告、表格汇总导出、重写章节内容、事实校验合规、更新在线表格、数据清洗汇总或交付前抽检。

- Skill: `ahang1598/structured-data-doc-delivery` (Agent Skill)
- Install (CLI): `npx get-skill add ahang1598/structured-data-doc-delivery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ahang1598/structured-data-doc-delivery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: ahang1598 (https://skillmd.com/u/ahang1598)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/ahang1598/structured-data-doc-delivery

---


# Structured Data Doc Delivery

把现有资料加工成可复核、可编辑、可交付的文档或表格。先锁定口径和版本，再提取、加工、核验、生成与回读；信息不足时交付草稿或待确认清单，不冒充终稿。

## 流程

### 1. 锁定目标、范围与计算口径

确认交付载体、文件名、目标章节或 sheet、字段、单位、统计期间、筛选条件、去重键、排序规则、精度和最终/草稿状态。口径或版本有歧义时先澄清，不直接出最终稿。

具体约定：面积平均等按 `Σ净面积×等别/Σ净面积` 计算，不得对“等别”做简单算术平均；面积结果保留 4 位。财务材料必须区分“2025 年实际”与“2026 年预算/预计”，不得把预算写成全年已实现。

### 2. 读取最新来源并定位数据区

优先读取用户提供的本地附件；再读取指定文档、链接或外部来源。记录文件名、版本/编制日、sheet、章节、表头行和数据范围。在线协作文档或表格每次编辑前都重新读取。

具体约定：处理《区域门店租金红线测算_精品咖啡.xlsx》时，应分别定位 `租金红线关键指标`、`模型对照与阻力评分`、`试点验证基线`，数据基准日使用附件编制日 `2026.08.11`，而非报告基准日 `2026.08.13`。合并住房/社区统计表时排除原表“合计”行，防止与明细再次求和。

### 3. 提取、映射与清洗

建立“来源位置 → 目标字段/章节”的映射，保留来源定位。统一名称、单位和类型；处理空值、异常值、重复项及未匹配项。映射不确定时保留原值并标记 `待确认`。

具体约定：销售金额按“产品组”汇总时，先把 SKU 口味归入产品系列，再合并同名金额；列出全部未匹配 SKU，补齐映射后才排名。用户要求剔除 `卵磷脂30g` 时，只从原始明细排除该 SKU，再按蓝盖/罐装分组重新汇总并重排前 20，不能从既有前 20 直接删一行递补。

### 4. 计算、汇总或定向改写

从明细记录按已锁定规则计算；汇总表仅用于交叉校验。写出公式、分母、筛选、精度和排序方式。改写只触及目标章节、段落、页面或单元格，多轮讨论先维护新增/升格修改清单，用户要求收口时再统一落稿。

具体约定：租金口径中，核心商圈 `28%` 只表示相对 `24%` 红线高 4 个百分点；`19个月` 只挂在“租金占比超过 24%”的触发后果，不得写成 28% 店型的实测回本周期，也不得写成“压回 19 个月”的改善目标。社区店 `13%` 与日均 `210杯` 是同一模型的附件锚点；竞品甲 `76%` 必须标为估算值、对外使用前待核验。

### 5. 交叉核验事实、映射与勾稽

逐项核对来源、事实状态、计算公式、合计与分项、映射覆盖、未匹配项、排名和文本中的数字。所有指标先从明细记录回算；已有汇总只作对照，若数值有差异，采用明细回算值并报告差额及来源位置。

具体约定：资产负债表按 `资产总额 = 负债总额 + 所有者权益总额` 勾稽，资产负债率按 `负债总额/资产总额` 计算；“下降 9.95 个百分点”必须用年初资产负债率减年末资产负债率，不能写成同比下降 `9.95%`。利润表中 `营业利润 + 营业外收支净额 = 利润总额`，再结合所得税费用核对净利润。

### 6. 生成或更新交付物

按用户指定格式生成可编辑文档、报告、Excel 或在线表格，统一标题层级、列名、单位、公式和数字格式。保留模板时仅修改目标范围，不破坏其他 sheet、章节、公式、样式或合并区域。

具体约定：更新在线表格前先确认目标 `sheet` 和实际表尾/`起始行`，再批量追加；不得沿用上一轮记忆中的起始位置。涉及租金红线的终稿，结构至少覆盖“关键结论与最大阻力、进入策略推荐、风险与验证计划、口径说明”四部分，并把附件可复算项、内部统计、估算值和推断分开标注。

### 7. 回读抽检并交付

重新打开成品，检查可打开性、文件名、页数/sheet 数、目标范围、关键字段、公式、合计、首尾记录和格式。抽检必须覆盖高风险口径及本轮修改项；交付时附路径或链接、来源版本、口径摘要、待确认项和未解决差异。

具体约定：在线表格写入后回读目标 sheet，至少核对追加区首行、末行、关键列和合计；排名文件复核剔除项确已从明细消失且前 20 已重排；租金报告逐处搜索 `19个月`，确认它只与“超过 24%”触发后果相连。无法核验的来源或数字标为 `待确认`，不得写成“已核实”。

## 工具选择

- 文档/PDF：先抽取章节、表格与页码，再做局部替换；生成后回读目标章节。财务预算文本将 `2026年预算` 保持为“预计”，不得改成“全年实现”。
- Excel/CSV：先检查 `sheet`、表头、公式、合并单元格和数据区；从明细计算并保留可复算公式或规则说明。处理 `净面积` 与 `等别` 时使用面积加权，不做简单平均。
- 在线文档/表格：写前重读，确认 `sheet`/章节与 `起始行`；批量写入后回读并重新交付最新链接。
- 多源检索：优先用户指定和权威来源，记录发布日期与访问位置；外部资料不得覆盖附件明确口径，冲突时并列说明。竞品甲 `76%` 只能标为估算值、须核验。
- 脚本：适合可重复的清洗、映射、计算和格式生成；运行后仍需打开产物抽检，不能只以脚本无报错作为验收。

## 边界与禁止事项

- 不编造事实、数据、来源、映射、公式或校验结果；缺失内容标 `待确认`。
- 不在口径、版本、目标范围或交付格式未确认时宣布终稿。
- 每项指标必须先读取并回算明细记录；已有汇总仅用于核对差额，不得跳过明细。
- 不把内部统计或估算值表述成公开确认事实；例如竞品甲 `76%` 必须保留“估算值·须核验”。
- 不扩大编辑面；用户要求“800 字以内”时按字符约束回读检查，要求只改目标章节时保持其他内容不变。
- 不因社区店主线验证失败而反向放开租金占比高于 `24%` 的核心点位；只能在书面默认框架内复盘社区店选址或模型参数。
- 多轮用户明确要求“先记录修改清单，文档先别重出”时，不提前生成整稿；最终收口逐项销账强制修改。

## 精简示例

用户要求把销售表按产品组汇总、剔除 `卵磷脂30g` 并导出前 20：先确认金额字段、产品组映射和排序方向；读取明细并列出未匹配 SKU；从明细排除该 SKU，按产品系列及蓝盖/罐装规则汇总后重新排序；核对汇总总额等于剔除后的明细总额；导出可编辑表格，回读前 20、确认剔除项不存在，并随文件说明映射规则与未匹配项。

