税务合规自查工具
下载地址
https://api.skillhub.cn/api/v1/download?slug=%40user_a16b2e76%2Fsuiwuhegui将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a16b2e76/suiwuhegui。企业税务合规自查工具。基于《中华人民共和国税法》与《税收征收管理法》,针对增值税、企业所得税、个人所得税、印花税、发票管理及申报缴纳等核心涉税场景,依据可扩展的规则基线对企业输入的税务事实做自动化风险扫描,输出按严重度(高/中/低)排序的合规风险清单、法规依据与整改建议,并给出合规评分。当用户需要对企业做税务健康检查、申报前自查、审计/尽调底稿,或识别虚开发票、纳税调整、代扣代缴等合规风险时使用。
阅读全文 (展开查看完整说明)
概述
把企业的经营与税务事实整理成结构化 JSON,由规则引擎逐条扫描主要税种的高频合规风险点,输出风险清单(按严重度排序)+ 法规依据 + 整改建议 + 合规评分,并生成可交付的 Excel 报告。
付费说明(Pay Skill · 支付宝 AI 付)
本技能为 SkillHub 按次付费 Skill,由平台通过「支付宝 AI 付」在对话流内代收,用户确认支付后继续执行,无需跳出页面。
- 计费方式:按调用量计费(每次成功交付一份企业税务合规自查报告 计 1 次)。
- 单次价格:¥0.10(示例占位,发布时以 SkillHub 上架表单填写的单价为准;请保持「技能内声明 / 平台登记 / 上架表单」三处单价一致)。
- 收款通道:支付宝 AI 付(平台代收,个人开发者无需自行申请网站付或支付宝商户号,实时结算至你的收款账户)。
- 退款:按支付宝渠道规则处理。
- 适用前提:个人实名 + 已开通 SkillHub 收款能力。
- 服务端契约:平台代收模式下 SkillHub 代执行下方四步协议;自收款(402)模式须自备后端按「付费调用编排」实现。
付费调用编排(x402 / 支付宝 AI 付 四步协议)
本技能作为按次付费 Skill 对外提供服务时,其服务端须遵循以下 x402 / 支付宝 AI 付 四步协议。Agent 只负责编排,不代付、不接触密钥。
1. 402 账单下发(probe → bill)
- 服务端在收到调用且未检测到有效付款时,返回 HTTP 402 与
Payment-Needed账单(含orderId、金额、qrCode/payForm)。 - 收到 402 即暂停交付,保存账单与订单号,等待用户完成支付。
2. 携带凭证重试(pay → retry)
- 将
Payment-Needed交给支付宝官方「AI 付」能力拉起收银台,由用户本人扫码 / 免密完成付款(Agent 只编排,不代付)。 - 付款成功后,携带
Payment-Proof(支付凭证 + 订单号) 重试原请求。
3. 验付调用(verify)
- 服务端收到带
Payment-Proof的请求后,必须调用alipay.aipay.agent.payment.verify验付。 - 凭证无效 / 过期则拒绝服务;结果不明时不得要求用户重复付款。
4. 履约确认(fulfill / ack)
- 交付本技能产物(一份企业税务合规自查报告)后,服务端调用
alipay.aipay.agent.fulfillment.confirm确认履约。 - 失败可重试且保持幂等:不重复扣费、不重复交付。
5. 订单持久化与幂等更新
- 持久化订单记录(
orderId、状态、paidAt、proof);同一orderId原地更新,禁止重复建单。 - 异步通知(
trade_status=TRADE_SUCCESS / TRADE_FINISHED)须做 RSA2 签名校验,校验通过将订单置为PAID且幂等(重复通知不重复计费)。
安全红线
- 应用私钥仅存服务端(环境变量 / KMS 注入),禁止写入包内、日志或公开仓库;Java 用 PKCS#8,非 Java 用 PKCS#1。
- 生产环境必须校验本地订单、金额与资源关系;
service_id用真实API_前缀值(沙箱api_mock_service_id仅调试用)。 - 全程不向用户暴露支付链接、二维码原文或交易号等中间过程。
何时使用
- 对企业做税务合规健康自检或申报前风险提示
- 识别虚开发票、逾期申报/缴纳、代扣代缴缺失等高风险事项
- 检查企业所得税纳税调整(招待费、广宣费、福利费、研发加计等)是否到位
- 生成可交付的合规自查报告(Excel)或控制台 Markdown 摘要
- 对多主体批量预检(循环调用脚本,按评分横向对比)
目录结构
SKILL.md 本说明文件(skill 入口)
README.md 自说明文档(结构/上手/评分口径/免责声明)
scripts/
run_check.py 核心引擎:规则解释执行 + 评分 + Markdown摘要 + Excel报告
rules.json 数据驱动规则基线(24 条 / 六大类),增删规则只改此文件
references/
compliance_baseline.md 24 条规则的合规逻辑、触发场景、整改要点、法规索引
sample_data/
sample_input.json 完整可运行示例(星海智造有限公司 2025 年度),可作填表模板
output/
税务合规自查报告.xlsx 示例跑出的可交付报告(4 个 Sheet)核心工作流
- 整理输入 JSON:参照
sample_data/sample_input.json,在company填企业信息,在facts下按vat / cit / iit / stamp / invoice / filing六个分组填入事实。能填多少填多少,缺失字段会被标记为"待确认"而非误报。 - (可选)调整规则基线:
scripts/rules.json是数据驱动的规则库,新增/调整规则只需编辑 JSON(condition 类型见下),无需改代码。 - 运行引擎:调用
scripts/run_check.py,得到 Markdown 摘要 + Excel 报告。 - 复核风险清单:优先处置"高"严重度项,逐项落实整改建议并留存证据链;"待确认"项补充数据后复评。
- (批量)循环调用:对多个主体,分别准备 facts JSON 并循环执行,汇总各主体评分。
快速上手
# 用自带示例跑通完整流程(输出 Excel 到 output/税务合规自查报告.xlsx)
python scripts/run_check.py -i sample_data/sample_input.json -o output/税务合规自查报告.xlsx
# 仅看控制台 Markdown 摘要,不生成 Excel
python scripts/run_check.py -i sample_data/sample_input.json --no-excel
# 金额以"万元"展示
python scripts/run_check.py -i facts.json -o report.xlsx --unit wan命令行参数:
--input / -i:输入 JSON 路径(必填)--out / -o:Excel 输出路径(默认output/税务合规自查报告.xlsx)--rules / -r:规则库路径(默认scripts/rules.json)--unit:金额展示单位,可选yuan(元,默认)或wan(万元)--no-excel:仅打印控制台 Markdown 摘要,不生成 Excel
控制台会打印:合规评分、各严重度命中数、风险清单(严重度/编号/类别/风险点/法规/整改)、待确认项清单。
完整端到端示例与常见问题解答:报错时先看下文「异常处理」章节的排查顺序;上手流程与结果解读可参照
README.md与sample_data/sample_input.json。
规则条件类型(rules.json 的 condition.type)
脚本解释执行以下内置类型,新增规则在 JSON 中声明即可:
| type | 含义 | 触发(=风险命中) |
|---|---|---|
flag_true | 路径值"为真/非空" | 值真 → 命中 |
flag_false | 路径值"为假/为空" | 值假 → 命中 |
missing | 路径缺失或为空 | 缺失/空 → 命中 |
gt / lt / ge / le | 数值与阈值比较 | 满足条件 → 命中 |
diff_pct | 两路径差异百分比 | 差异% > max_pct → 命中 |
meal_limit | 业务招待费限额 | 发生额×60% > 营收×5‰ → 命中 |
deduct_limit | 按比例限额(如福利费14%) | 金额 > 基数×rate → 命中 |
all / any | 子条件组合(含 conds 数组) | 全部/任一命中 → 命中 |
路径统一以 facts.xxx.yyy 形式书写(见 sample_data/sample_input.json 与 scripts/rules.json)。
合规评分口径
- 每条规则按严重度赋权:高=3、中=2、低=1。
- 评分 = 100 ×(已评估规则赋权之和 − 命中规则赋权之和)÷ 已评估规则赋权之和。
- 数据缺失导致"待确认"的规则不计入评分分母,避免误判。
通用性(Generality)
本工具是行业中立、纳税人规模中立的通用税务合规自查基线:
- 不绑定行业:规则只描述合规风险逻辑,不含医药、房地产、金融等行业的专属口径。特殊事项在
scripts/rules.json追加"行业规则包"即可,不影响通用基线。 - 不绑定税率/规模:规则不硬编码 13% 等特定税率,一般纳税人、小规模纳税人、服务业/贸易/制造等各类企业均可直接跑。
- 多主体可比:对集团下属多家公司分别准备 facts JSON 循环调用,评分口径一致,便于横向对比与排名。
异常处理
所有报错统一为「现象 + 怎么做」格式,给出原因与可操作的修复步骤,而非只说"错了":
- 输入文件不存在 → 提示检查路径、用绝对路径、加双引号,退出码 2。
- JSON 语法错误 → 带行号列号 + 出错位置附近片段 + 常见原因 + 具体怎么改(删逗号/补引号/去注释)。
- 文件编码非 UTF-8 → 提示"另存为 UTF-8 编码"。
- 文件无读取权限/被占用 → 提示关闭占用程序或检查权限。
- 缺顶层
facts→ 报错并给出期望结构;缺company或个别税种子分组 → 仅告警不中断,相关规则转"待确认"。 - 规则库损坏(缺
rules数组、规则缺必填字段、condition.type 未知、编号重复)→ 启动即自检并提示具体规则编号。 - openpyxl 缺失 → 降级仅输出控制台摘要,提示
pip install openpyxl,不崩溃。 - Excel 报告保存失败(被锁定/无写权限)→ 降级保留控制台摘要,提示"关闭 Excel / 换输出名",不崩溃。
排查顺序:① 看报错最后一行(已给出怎么做)→ ② 确认文件存在且是 UTF-8 JSON → ③ 确认 openpyxl 已装 → ④ 还不行,带上完整报错信息反馈。
反模式与注意
- 本工具是辅助自查,不是税务意见——重大涉税事项、优惠资格、地方性政策以最新法规与主管税务机关为准,建议由税务师复核。
- 别把"待确认"当"通过"——缺失字段不会被评通过,补数据后必须复评。
- 别只盯高风险——中低风险(如纳税调整不到位)长期累积也会引发补税+滞纳金,应纳入日常内控。
- 别把规则当穷尽——基线覆盖高频风险点,不是全量法规;行业特殊事项可自行在
rules.json增补。 - 输入单位统一为"元"——
--unit wan仅影响 Excel 展示,不改计算口径。
免责声明
本工具为辅助自查,不构成税务、法律或审计意见。所有结论请以最新法规及主管税务机关口径为准,重大涉税事项建议由持证税务师复核。