财会勾稽校验
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8e327b10/financial-validate。
技能介绍
要解决什么问题
从 PDF、OCR 或手工抄录得到的报表,往往会出现列错位、科目名拼错、小计与明细对不上等问题。这类错误若在后续建模或对外报送前才发现,回溯成本很高。本技能面向的是数据已经落成结构化 JSON 之后的自洽性检查,而不是再去做一次表格识别或 OCR。
技能如何工作
核心设计是数据与校验逻辑分离:业务数据放在 data.json(纯 JSON),每条检查对应 test_validate.py 里一个 test_ 函数。跑 pytest 时只做断言,通过即勾稽成立,失败则原样返回差异(例如「左边=xx,右边=xx」),不偷偷改数。
支持的检查类型包括:
- 勾稽恒等式:如现金流量表三流净额与「现金净增加」、资产负债表「资产=负债+权益」、利润表收入减成本等链式关系
- 非负与范围:如流入项非负、资产负债率落在合理区间
- 同比/跨年:指定科目在不同列之间的大小关系
模板里提供 cell(t, 科目名, 列名) 与 num(文本):num 会处理千分位、括号负数 (1,234.56) 等常见报表写法。科目名按 rows[].key 与原文完全一致;拿不准时可用 view_keys.py 对照清单再写测试。
适用边界与注意点
- 适用:三表勾稽核对、带「小计=Σ明细」结构的表格、OCR 重建后的兜底校验(与提取工具形成「提取 → 校验 → 修正」闭环)
- 不适用:数据提取本身;需 OCR 或表格重建时请用其他工具
- 金额比较建议用
pytest.approx(rel=1e-6),避免浮点误报;发现失败应由人判断是数据错还是检查写错
使用场景
- OCR 或手工录入现金流量表后,用恒等式核对三流净额与现金净增加是否一致
- 从 PDF 摘取资产负债表 JSON 后,校验资产合计是否等于负债加所有者权益
- 多期利润表填入 `data.json`,检查收入减成本链是否与营业利润行勾稽
- 批量导入明细账小计后,用参数化 pytest 逐科目验证小计等于明细之和
适合人员
- 负责年报/审计底稿整理的财务分析师,需要在报送前用确定性规则扫一遍三表勾稽
- 写数据管道把报表落成 JSON 的后端工程师,要在入库前加一层可版本控制的校验
- 从扫描件做表格重建的数字化同学,想用 pytest 失败信息定位列错位或误读科目
- 维护内控脚本的合规/内审人员,希望校验逻辑与原始数据分文件便于复核