功能描述

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

使用说明 (SKILL.md)

内控-集团客户部FY审计

Name: 内控-集团客户部FY审计
Author: runkecheng

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

触发条件

用户提到以下关键词时使用此 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`	操作规范 + 检查清单

安全使用建议

Before using this skill on real audit data, make a database backup, verify that scripts run only from the packaged skill directory, require explicit approval for any reparse/delete operation, and confirm where Feishu cloud uploads and old-file deletions will occur.

功能分析

Type: OpenClaw Skill Name: nk-ka-fy-audit Version: 1.0.1 The skill bundle is a comprehensive financial auditing tool designed to recalculate sales commissions and detect fraud. It is classified as suspicious because it possesses high-risk capabilities, including broad file system access (reading, writing, and bulk deletion of SQLite and Excel files) and the execution of local Python scripts via the subprocess module (found in batch_process.py and batch_reparse_all.py). While these functions are aligned with the stated purpose of processing 30+ months of financial data, the ability to delete entire databases and execute shell commands represents a significant attack surface. No evidence of intentional malice, data exfiltration, or unauthorized remote access was detected; the logic is focused on internal controls and bank account anomaly detection (analyze_fanyong.py).

能力评估

ℹ Purpose & Capability

The stated purpose is coherent: read KA rebate spreadsheets, recalculate amounts, compare summaries, and generate Word/Excel audit reports. The artifacts also show handling of sensitive rebate recipient and bank-account data, which is relevant to internal audit but should be noticed.

⚠ Instruction Scope

The documentation repeatedly says new months should be append-only and historical data should not be modified, but the provided parser and batch reparse scripts delete existing SQLite rows before reprocessing.

⚠ Install Mechanism

There is no install spec, and a batch script invokes an absolute helper path under /workspace/scripts rather than the packaged scripts/ path, creating a provenance gap for executed code.

ℹ Credentials

Fixed /workspace data, database, output, and Feishu cloud delivery paths are broadly consistent with an internal audit workflow, but users should confirm the exact folders and cloud destination before running.

⚠ Persistence & Privilege

The skill persists raw audit data in SQLite and includes scripts that can delete monthly or all audit rows; this is high-impact for financial audit records unless guarded by backup and explicit approval.

版本历史

v1.0.1

内控-集团客户部FY审计 1.0.1 更新日志 - 新增详细说明文档SKILL.md，介绍本技能的原理、适用场景、关键流程、报告模板及脚本目录等信息。 - 明确支持多种返佣表结构自动识别与规则管理，并以独立重算方式保障审计准确性。 - 支持增量追加新月份数据入SQLite数据库，不修改历史数据。 - 项目交付包含Word及Excel两类标准化报告，所有文件仅保存至用户个人云盘。 - 增强用户交互规范，例如遇未知Sheet时会主动询问。 - 补充技能约束、公式速查及相关参考文档清单，方便用户理解与查阅。

v1.0.0

内控-集团客户部FY审计工具发布首个版本，提供集团KA返佣独立复核及审计报告自动化。 - 支持多类返佣审计场景关键词自动触发 - 自动识别各月返佣Excel表结构，独立重算并数据比对 - 增量入库新月份数据，历史数据不修改 - 自动生成Word（管理层）与Excel（操作方）两种结构化审计报告 - 完整存储规范：仅保存最新版至飞书云盘，历史版自动清除 - 严格遵循表格结构探测与异常排除规则

元数据

Slug nk-ka-fy-audit

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题