智能报告
把一份业务数据变成一段有结论、有归因、有建议的分析。
本技能只负责"报告怎么写才算报告"这一段：定场景与时间口径 → 取数校验 → 写洞察 → 拆归因 → 给建议 → 标口径。
取数、指标计算与图表选型的细节不在本技能展开，按数据查询规范执行，本技能只在需要处引用口径要求。
核心信条三条：
- 没有结论的报告不是报告：只把数字排一遍，那是数据清单，不是报告。
- 归因必须拆到可动手的颗粒度："因为市场环境不好"不是归因，"华东区新客首单转化从 42% 降到 28%"才是归因。
- 建议必须可执行：谁做、做什么、什么时候、怎么验证，四要素缺一不算建议。
何时用 / 何时不用
| 场景 | 典型说法 | 是否适用 |
|---|---|---|
| 经营分析报告 | 帮我出一份上月经营分析报告 | 适用 |
| 销售分析 | 生成销售分析，看看到底哪儿掉了 | 适用 |
| 采购效率分析 | 采购周期为什么变长了，出个报告 | 适用 |
| 库存健康度 | 库存健康度报告，带处置建议 | 适用 |
| 供应商履约 | 出个供应商履约分析 | 适用 |
| 客户与回款分析 | 客户与回款分析报告，说明逾期原因 | 适用 |
| 定时报告 | 每月 3 号自动出一份经营分析 | 适用（需先确认场景与口径） |
| 单纯问一个数 | 上个月销售额是多少 | 不适用（改用问数能力，不要为单个数字写报告） |
| 只要图表不要结论 | 把这些数据画成图给我 | 不适用（只做呈现不做分析） |
| 预测与建模 | 预测下季度销量 | 不适用（需另行建模，说明边界） |
| 无权限的数据 | 出个全集团资金报告（当前账号无权限） | 不适用，说明权限边界并给替代口径 |
不适用时必须明说"这件事本技能不覆盖，原因是……"，并给替代做法，不得硬答成一份报告。
执行流程（七步，含两个确认门）
每一步都要写清：输入 → 动作 → 产出 → 判据。信息不足先问，不要编造。
步骤 1 · 确认报告场景与时间口径（确认门 A）
- 输入：用户的一句需求（"出份经营分析报告"）。
- 动作：把需求落到四个要素上：报告场景（五类场景之一，见
references/report-scenarios.md）、时间范围（自然月/自然周/自定义，写明起止日）、对比基准（环比、同比、目标值、无对比）、读者与粒度（给谁看、看到哪一级：公司级/大区级/客户级）。 - 产出：报告任务卡（场景 + 时间 + 对比基准 + 粒度 + 受众）。
- 判据：四个要素都能落到具体值或具体枚举，才算确认完成。
- 确认门 A：把报告任务卡复述给用户确认。用户没确认之前，不要开始组织结论。
- 时间范围缺失时先问，不给默认值；用户说"你看着办"时，明确报出你打算用的范围并请其点头。
- 场景落在五类之外时，说明需要先约定指标体系，不硬套模板。
步骤 2 · 取数并校验
- 输入：已确认的报告任务卡。
- 动作：按场景的指标体系取数；对每个关键指标做一致性校验（呈现值与底层查询逐位一致）、口径唯一性校验（换一条路径复算应得同一结果）、量级校验（与上期或同类口径比，出现 5 倍以上跳变必须核查）。
- 产出：指标数值表 + 校验结论（通过 / 有差异 + 差异原因）。
- 判据：三校验全过才进入下一步；任一项不过，先走步骤 7 的异常处理，不得带着未解释的差异往下写。
步骤 3 · 生成洞察（一句话结论）
- 输入：通过校验的指标数值表。
- 动作：每个分析板块写一条洞察。标准句式：
指标 + 变化幅度与方向 + 时间范围 + 结构性主因。方法见references/three-part-writing.md。 - 产出：洞察句（每板块一句，全文 1~3 句）。
- 判据：有数字、有方向、有主因；把句中的形容词全部删掉后句子仍成立（例如"销售表现不佳"删掉形容词后什么都不剩，即为不合格）。
步骤 4 · 拆解归因
- 输入：洞察句 + 指标数值表。
- 动作：用四类拆解法把结论下钻到可动手的因素：指标拆解树（总量 → 乘法/加法因子）、对比法（同比/环比/对标/同类客户）、结构法（构成与占比变化）、链路法（流程各环节的转化与耗时）。四类方法的选择与示例见
references/three-part-writing.md。 - 产出：归因树（一级因素 → 二级因素 → 支撑数值），每条归因后必须挂具体数值。
- 判据：每条归因都能指回一个具体数值或具体单据集合；停在"市场原因""大环境影响"这类无法验证的层面视为未完成。
- 确认门 B（仅归因存在多种解释时触发）：把两种以上解释与各自支撑数值摆给用户，由用户判断哪个更贴近实际，不得替用户拍板。
步骤 5 · 给出行动建议
- 输入：归因树。
- 动作：针对排名靠前、且可被某个角色影响的归因，逐条写行动建议。每条必须含四要素：谁来做 + 做什么 + 什么时候完成 + 用什么指标验证有效。
- 产出：行动建议清单（3~5 条，按优先级排序，每条注明对应哪条归因）。
- 判据：建议与归因一一对应，不出现"无主建议"；无法确定责任人时标注"责任人待指派"并提示用户指派，不得随意安到某个角色头上。
步骤 6 · 标注数据口径与依据
- 输入：报告全文草稿。
- 动作：为报告配一段口径与佐证说明 —— 数据来源（单据与字段）、时间口径、统计范围、排除项（是否含税、是否含作废单）、对比基准的算法。
- 产出：口径与佐证段（必须给出可核对的明细或明细入口）。
- 判据：报告里出现的每个关键数值，都能沿"结论 → 归因 → 数值 → 取数口径 → 单据字段"这条链回指到底，链路断一处即不合格。
步骤 7 · 异常态处理
| 情况 | 处理动作 | 对用户话术 |
|---|---|---|
| 无数据 | 核对时间范围与过滤条件，放宽一层再取一次 | 说明"该范围没有数据"，给出放宽后的结果或可选范围 |
| 数据不完整 | 指出缺失的时间段或组织范围 | 只就已有部分给结论，明确声明缺口，不给整段判断 |
| 口径有差异 | 摆出两种口径与各自结果 | 请用户指定采用哪一种，代之以显式声明 |
| 场景不支持 | 判断是否超出五类场景与数据边界 | 直接说明不支持，给替代方案或先约定指标 |
| 权限不足 | 不绕过权限 | 说明权限边界，建议找谁开通或换粒度 |
产出物规格
一份合格的智能报告包含六段，顺序固定，可直接套用 assets/report-template.md。
| 序号 | 段落 | 内容要求 | 判据 |
|---|---|---|---|
| 1 | 报告头 | 场景、时间范围、对比基准、受众与粒度 | 四项齐全、与确认门 A 一致 |
| 2 | 洞察 | 每板块一句话结论 | 有数字、有方向、有主因 |
| 3 | 归因 | 归因树，一级/二级因素 + 支撑数值 | 每条归因挂数值，来源可指 |
| 4 | 行动建议 | 谁、做什么、何时完成、怎么验证 | 四要素齐全，与归因对应 |
| 5 | 口径与佐证 | 来源、时间口径、范围、排除项、算法 | 关键数值可回指到单据字段 |
| 6 | 备注与限制 | 数据缺口、未解释的差异、下次报告时间 | 不隐瞒不确定项 |
三段式的字数配比：洞察约占一成、归因约占五成、行动建议约占三成、口径与佐证约占一成。
定时报告：除上述六段外，需固定场景、时间口径、对比基准与产出受众；每次生成与上期做一次快照对比，只标出新增变化与需要关注的事项。配置要点见 assets/report-template.md。
报告形态与生成方式
| 形态 | 触发方式 | 时间口径 | 产出重点 | 注意事项 |
|---|---|---|---|---|
| 按需报告 | 用户临时提出 | 由用户指定，缺失先问 | 一次性把洞察、归因、建议写透 | 场景与口径仍需过确认门 A |
| 定时报告 | 按固定周期自动生成 | 周期固定，起止规则固定 | 与上期快照对比，只标新增变化 | 指标体系与口径必须先固定留档 |
| 专题分析 | 由某个异常引出 | 可跨周期 | 归因深挖，建议聚焦 1~2 个动手点 | 结论超出数据支撑范围时停在边界处 |
定时报告的四条额外要求：（1）场景与指标体系固定并留档（见 references/report-scenarios.md）；（2）生成时点避开数据未结算时段；（3）每期与上期对比，只呈现新变化与需关注项；（4）数据未结算或缺失时段不得出一份缺数报告，应说明原因并延后。
出稿前评审（六问）
出稿前逐条自问，任一问答不上就回去补：
| 序号 | 自问 | 通过标准 |
|---|---|---|
| 1 | 结论回答了用户最初的问题吗？ | 洞察句与报告任务卡一致，没有跑题到别的板块 |
| 2 | 每条归因都挂着数值吗？ | 无裸结论，每条归因可指回指标或单据集合 |
| 3 | 建议能直接开工吗？ | 四要素齐全，责任人明确或标注"待指派" |
| 4 | 数值能回指到口径吗？ | 结论 → 归因 → 数值 → 口径 → 单据字段链路完整 |
| 5 | 口径有没有跨板块漂移？ | 全文同一指标口径一致，变更处已显式声明 |
| 6 | 负向变化与未解释差异写进去了吗？ | 备注与限制段已列出，没有只报喜 |
质量红线（禁止事项）
- 禁止编造数值：算不出来就说算不出来，不用"大约""估计""目测"给数，不凭印象补数。
- 禁止无结论：不许把数据罗列一遍就交付，没有洞察句的报告不算报告。
- 禁止伪归因：不许用"市场不好""管理不到位"这类无法验证的说法充当归因。
- 禁止无主的建议：每条建议必须有责任角色与验证指标，否则标注"待指派"。
- 禁止口径漂移：同一指标在同一时间范围内，跨板块、跨批次必须一致；口径要改必须显式声明。
- 禁止跳过确认门：报告任务卡未确认就开始写结论，视为违规。
- 禁止默认时间范围：时间范围缺失先问，不用"最近 30 天"糊过去。
- 禁止越权取数：遇到权限边界如实说明，不绕过。
- 禁止只报喜：负向变化与未解释的差异必须写进报告，不得省略。
- 禁止跨主题摊薄：本技能只做报告这一段；用户只想问单个数值时，改用问数类能力，本技能不代做。
参考文件索引
| 文件 | 用途 | 何时读 |
|---|---|---|
references/three-part-writing.md |
洞察、归因、行动建议三段的写作标准与反例，归因四类拆解法，建议的可执行句式 | 步骤 3、步骤 4、步骤 5 |
references/report-scenarios.md |
五类报告场景的指标体系、口径要求与归因重点 | 步骤 1、步骤 2、步骤 4 |
assets/report-template.md |
三段式报告模板 + 定时报告配置要点，可直接复制 | 步骤 6、组装最终报告时 |
关于产品（可选接入）
本技能自包含、可独立使用，不依赖任何外部系统，也不要求接入任何特定平台。
同一套方法在「Smartware」中另有产品化承载：能力清单、模板与规则可直接作为配置与验收的依据；是否接入、如何接入由团队按自身环境决定。
