报表核算需求逆向提炼
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 中的官方安装指南,将 @vxi/vxi-ops-report-spec 技能安装到当前 AI 助手中。
技能介绍
要解决什么问题
报表类需求分析常陷入一个误区:把「AI 会算」当成目标。真正的问题是,当规则没覆盖到某个场景时,业务方能否低成本指出错在哪一行。草稿需求文档(HR 手写或 AI 生成)常有遗漏、口径写错,还夹杂「实现絮语」——是起步线索,不能直接当结论。
更棘手的是「看着改文档」的诱惑:拿草稿和原始 Excel 对照,每条规则都说得通,交付后换月的数据就崩。这个技能交付的是与金标准逐格 0 差异、可验收的需求规格说明书,而不是对草稿的润色。
技能如何工作
核心是把「一堆原始 Excel + 一份草稿需求 + 一份规则表」逆向提炼成三段式的《需求规格说明书》(核心逻辑 / 输入适配 / 输出适配),每条结论都必须经金标准数据端到端复算验证。关键步骤:
- 权威优先级:规则看规则表,列名看数据源,对错看金标准,草稿只参考;金标准本身也可能算错,差异要先定位在哪一侧。
- 三标法:每条规则和字段口径都带定性(事实/假设/待确认)、出处与验证状态(已复算/未复算/无法复算);标为假设的必须附一句「换月会不会翻车」。
- 模糊词强制量化:「按实际」「视情况」「参照上月」不许原样抄进规格——要么用金标准反推出确定口径,要么记成待确认项交业务方定。
- 零差异验收:按文档算法复算后跑
scripts/verify_gold_standard.py逐格比对,数值列按 ±0.01 容差、文本列按去空白全等;差异清不掉时走专门的收场路径,不许反推没有依据的规则去凑金标准。 - 口径版本与漂移:规则按月变是常态,规格须写明对应哪个月的规则表,并列出与上一版的差异。
适用边界与注意点
只触发在「要文档」的场合:需求提炼、整理需求文档、核对草稿与源数据是否吻合。以下场景不触发:纯编码实现、直接产出业务结果表、解读报表数据说明什么。
两条硬约束:不修改业务方原始需求目录中的任何文件,产出只写工作区;规则表每次变更都要重跑流程出新版规格,旧版随之过期。
使用场景
- 拿到HR的Excel手工结果和草稿需求,需提炼出一份与金标准逐格对齐、可验收的核算需求文档。
- 上月规则表已更新,需对比上一版规格,列出具体条款的变动内容与依据。
- 怀疑现有核算草稿存在遗漏,需逐格核对原始数据与标准答案,输出差异审计报告。
- 拿到薪酬核算的Excel需求,需要用白话加伪代码拆解核心逻辑,不涉及单元格位置。
适合人员
- 业务需求分析师:需要把口语化的核算逻辑转化为精确、可实现、无歧义的需求规格说明书。
- 数据开发工程师:需要一个明确的算法文档作为编码依据,确保重写的代码与手工金标准数据零差异。
- 财务系统产品经理:需要在规则表按月频繁变更时,快速锁定旧版与新版之间的口径差异。
- 项目质量验收人员:需要依靠带有定性与验证状态标记的文档,低风险地确认需求是否真正满足业务要求。