内控-集团客户部FY审计

集团客户部FY审计工具。当用户要求"审计返佣"、"核查KA返佣"、"核对返佣数据"、"检查返佣表"、"返佣对账"或类似场景时使用。本技能自动识别各月KA返佣工作表结构，从原始数据独立重算返佣金额并与汇总表比对，发现数据差异和规则执行问题，输出结构化审计报告。支持增量追加新月份数据到SQLite数据库，不修改历史数据。

Audits

Warn

ClawScanWarn

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install nk-ka-fy-audit

内控-集团客户部FY审计

核心原则："表格公式对了，不等于算出来的结果对了。必须用原始数据独立重算，才能发现数据入口错误。"

触发条件

用户提到以下关键词时使用此 skill：

"审计返佣" / "核查KA返佣" / "核对返佣数据"
"检查返佣表" / "返佣对账" / "出审计报告"
"审计2026XX" 或 "审计YYYYMM"（新月份入库）
"重新审计" / "增量审计"

标准工作流（两阶段法）

阶段A：新月份数据入库

打开 xlsx 文件，探测所有 Sheet 结构
与已知 4 种结构变体（A/B/C/D，见 references/01-structure-variants.md）匹配
若有从未见过的 Sheet 名，先打印前5行询问分类和公式
按匹配的变体解析全部 Sheet → INSERT 到 raw_records 表
⚠️ 仅在此时读取 Excel 计算表，其他情况不读

阶段B：快速全量重算（默认模式）

从 raw_records 表读取所有月份的原始字段
从 Excel 汇总表读取汇总金额（只需 "汇总" Sheet）
按 calc_method 分类型使用对应公式独立重算（见 references/02-recalculation-methodology.md）
与汇总表逐月比对 → 输出审计报告

报告交付物

每次审计完成后同时交付以下两个报告：

Word版报告（面向管理层）

命名：集团客户部FY审计报告（YYYYMM~YYYYMM）.docx
6章框架：审计结论 → 数据分析（趋势图+TOP10图表）→ 重点核实事项 → 审计结果明细说明 → 方法论
结论开头标准表述："经审计集团客户部{年}年{月}月至{年}年{月}月返佣计算表，发现疑似多支付返佣{金额}元"
差异标准：|差额|≤1元→通过，|差额|>1元→差异

Excel版报告（面向被审计方）

命名：集团客户部FY审计结果明细（YYYYMM~YYYYMM）.xlsx
Sheet：审计摘要 → 月度趋势 → 审计结果-多发&历史调差明细 → 品牌增长预警
基于模版填充，数据从SQLite计算

存储规则

所有文件只保存到用户个人云文档（飞书云盘），不写入知识库
仅保存最新版，旧版先删除再上传新文件

关键约束

规则	说明
不改历史	除非用户明确要求，不修改任何历史月份的记录
增量追加	新月份数据只INSERT，不UPDATE/DELETE
结构探测	未知Sheet先问用户
中快Like匹配	`LIKE '中快%'` 而非精确匹配
志华不重复	只通过calc_method计入
SQL表排除	202602的sql表不计入汇总
异常表排除	默认排除，仅 `audit_note=历史差额调整` 的补充
重算粒度	逐行 ROUND(txn×rate,2) 再按品牌SUM

重算公式速查

calc_method	公式
regular	ROUND(txn×rate,2) 每通道，∑
zhongkuai	直接用 total_rebate
expansion_307	ROUND(txn×(fee-mer_rate-cost)×ch_ratio,2)，必须读Excel
expansion_308	ROUND(txn×yield×ch_ratio,2)，读Excel或用total_rebate
sql_recalc	total_rebate（202602跳过）
abnormal	不计入重算（见 `references/03-abnormal-rules.md`）

Skill目录脚本

scripts/ 目录下包含12个脚本，按用途分类：

核心流程：parse_one_month.py（Excel→DB入库）、generate_comprehensive_report.py（生成Word+Excel报告）
批量处理：batch_process.py / batch_reparse.py / batch_reparse_all.py / batch_summaries.py
数据库：rebuild_db.py / restore_db.py / restore_raw_records.py
返佣信息表：parse_fanyong_table.py / analyze_fanyong.py

所有脚本位置：/workspace/skills/内控-集团客户部FY审计/scripts/

参考文档

文件	内容
`references/01-structure-variants.md`	4种结构变体（A/B/C/D）+ 特殊表格 + 英文列名映射
`references/02-recalculation-methodology.md`	完整重算公式 + 比对逻辑
`references/03-abnormal-rules.md`	异常表备注规则 + 区块标题继承机制
`references/04-database-schema.md`	数据库表结构 + 增量入库流程
`references/05-historical-errors.md`	14个历史错误复盘
`references/06-operating-norms.md`	操作规范 + 检查清单