记账 · 凭证 / 账簿

申报表填报指引

【财友云】输入填报事项,输出涉及的申报表、关键栏次与填入口径、填报要点、附报资料与依据。解决「这个业务该填哪张表、填在哪一栏」的高频刚需;不代算税额。

已上线 P2 L0

申报表填报指引

【财友云】输入填报事项,输出涉及的申报表、关键栏次与填入口径、填报要点、附报资料与依据。解决「这个业务该填哪张表、填在哪一栏」的高频刚需;不代算税额。

这个包已上线。正文与用法以下方随包 SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。

标签

[申报表, 填报指引, 纳税申报, 表单定位, 附报资料]

技能正文(随包 SKILL.md)

> **本地运行,零网络请求、免 API Key、不主动外发数据。**
> 四项诚实承诺:① 认不出的表就说不认识,绝不猜一张表;② 高危动作强制人工确认;③ 幂等断点,绝不重复副作用;④ 全程留痕可审计。
> 边界说明:本包脚本自身不联网、不外发;若你把内容贴进 AI 对话,内容是否离开本机由你所使用的客户端决定,不由本包决定。
<!-- WB-CLAIM-BOUNDARY v1 -->

# 申报表填报指引

「这个业务到底该填哪张表?」——这是财税人每天问得最多的问题。

**表填错,比数填错更麻烦**:数填错了改一行,表填错了要作废重报。
而申报表体系庞大——增值税主表加四张附列资料、企业所得税年报几十张表单、
财产和行为税合并申报后一表多税——**知道「填在哪」本身就是专业能力**。

本包做的事:把你要办的事项过一遍内置表单指引表,
给出**涉及哪张表、关键栏次填什么、要点是什么、附什么资料**,
认不出的**进异常表**——而不是替你猜一张表名。

> ⚠️ 本包只给**表单定位与栏次口径**,**不代算税额**(税额计算转 `caiyouyun-tax-amount-calc`)。
> 表单版本与行次会随总局修订调整,本包以**栏次名称**为主、行次为辅,以最新表单为准。

## 运行方式

<!-- WB-INVOKE-CONTRACT v1 -->

**环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。

**作用**:按填报事项定位申报表,输出关键栏次、填报要点与附报资料。

**命令**(在技能目录下执行):

```bash
# 默认预览(不写盘)
python scripts/tax_form_guide.py <事项清单.csv>

# 确认无误后正式执行
python scripts/tax_form_guide.py <事项清单.csv> --execute
```

**参数**:

| 参数 | 说明 |
|---|---|
| `<file>` | 事项清单(.xlsx / .csv),首行表头,含 事项 |

**选项**:

| 选项 | 说明 |
|---|---|
| `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) |
| `--operator OPERATOR` | 操作人(写入留痕) |
| `--execute` | 真正写盘 |

**退出码**:`0` 成功 / `2` 输入错误 / `3` 鉴权失败 / `4` 环境或依赖失败 / `8` 部分成功。

**输出**:四件套写入 `--out-dir`,源文件不改动;先跑预览确认,再加 `--execute` 落盘。

## 何时不触发

以下情况**不要**启动本技能,并主动告诉用户该走哪条路:

1. 要的是**把数据填进表、生成申报文件** → 用 `caiyouyun-tax-form-fill`。
2. 要算的是**具体该交多少税** → 转 `caiyouyun-tax-amount-calc`。
3. 要判断的是**这笔支出能不能税前扣除** → 转 `caiyouyun-cit-deduction-check`。
4. 要查的是**减免性质代码/税收分类编码** → 转 `caiyouyun-tax-code-lookup`。
5. 要核验的是**某个政策文号还有没有效** → 转 `caiyouyun-policy-validity-check`。
6. 事项是**未收录的冷门表单**、用户已知道该填哪张 → 直接答,不用跑流程。

> 误触发一次的成本高于漏触发一次:表单版本会变,本包给的是定位与口径,不能替代最新表单填报说明。

## 工作流(编号阶段)

| 阶段 | 做什么 | 产物 | 闸门 |
|---|---|---|---|
| 一 | 事项读取:逐行取「事项」描述 | 事项清单 | 行内无描述 → 进异常表 |
| 二 | 表单匹配:命中内置指引表(取最长命中键);税种名兜底 | 命中清单 | 无命中 → 进异常表,不猜表名 |
| 三 | 出表:表名 + 关键栏次 + 要点 + 附报资料 + 依据 | 指引主表 | — |

> 按顺序推进;上一阶段闸门没过,不进入下一阶段。

## 判断框架(两层定位)

**第一层 · 事项精确命中**:事项文本命中指引表条目(如「企业所得税年度汇算清缴」)→ 直接给对应表单。

**第二层 · 税种名兜底**:只写了税种(如「增值税」)→ 给该税种**最常用的申报表**,并在备注中提示「按主体类型选择一般纳税人/小规模版本」。

**都不命中** → 进异常表,写「未收录于内置申报表指引表,须人工确认」。

> 兜底是**有边界**的:只在税种层面兜底,不跨税种猜表单。

## 表单速查(内置 24 条,节选)

| 事项 | 涉及申报表 |
|---|---|
| 增值税(一般纳税人) | 增值税及附加税费申报表(一般纳税人适用)+ 附列资料(一)~(四) |
| 增值税(小规模) | 增值税及附加税费申报表(小规模纳税人适用) |
| 企业所得税季度预缴 | 企业所得税月(季)度预缴纳税申报表(A类) |
| 企业所得税年度汇算 | 企业所得税年度纳税申报表(A类,2017年版)+ 系列明细表 |
| 个税综合所得年度汇算 | 个人所得税年度自行纳税申报表(A表/简易版/B表) |
| 个税经营所得 | 个人所得税经营所得纳税申报表(A表/B表/C表) |
| 印花税 / 房产税 / 城镇土地使用税 / 环保税 / 资源税 / 契税 / 车船税 / 耕地占用税 | 财产和行为税纳税申报表 + 对应税源明细表 |
| 土地增值税(预缴/清算) | 土地增值税纳税申报表(一)/(二) |
| 消费税 | 消费税及附加税费申报表 |
| 研发费用加计扣除 | 研发费用加计扣除优惠明细表(A107012) |
| 出口退税 | 出口货物劳务免退税申报表系列 |
| 关联业务往来 | 企业年度关联业务往来报告表(22 张表单) |

> 完整表单条目、关键栏次与附报资料见 `references/01-legal-basis.md`;
> 定位口径与边界见 `references/02-decision-table.md`;
> 填报前核查清单见 `references/03-verification-checklist.md`。

## 输入 / 输出

输入:1 张事项清单(`.xlsx` / `.csv`),首行表头。

| 列 | 必需 | 别名 |
|---|---|---|
| 事项 | 必需 | 事项 / 填报事项 / 业务 / 场景 / 申报事项 / 问题 / 需求 |
| 主体类型 | 可选 | 主体类型 / 纳税人类型 / 身份 / 纳税人资格 |

输出(进 `--out-dir`,源文件一个字节都不动):

| 文件 | 内容 |
|---|---|
| `申报表指引_主表.csv` | 逐条:事项 / 主体类型 / **涉及申报表** / 关键栏次与口径 / 填报要点 / 附报资料 / 依据 |
| `申报表指引_异常表.csv` | 须人工确认项(未收录),带风险等级 |
| `申报表指引_校验表.csv` | 核验口径 / 表单条目 / 版本 / 重要声明 / **条目守恒校验** |
| `fin-log.jsonl` | 处理日志(追加,含输入 sha256) |

## 真实输出

正常(8 行输入):

```
--- 申报表指引(共 7 条)---
  增值税一般纳税人申报   -> 《增值税及附加税费申报表(一般纳税人适用)》及附列资料(一)~(四)…
  企业所得税年度汇算清缴  -> 《企业所得税年度纳税申报表(A类,2017年版)》及系列明细表…
  个人所得税经营所得申报  -> 《个人所得税经营所得纳税申报表(A表/B表/C表)》
  印花税申报         -> 《财产和行为税纳税申报表》(印花税税源明细表)
  土地增值税清算       -> 《土地增值税纳税申报表(二)(从事房地产开发的纳税人清算适用)》
  研发费用加计扣除申报   -> 《研发费用加计扣除优惠明细表》(A107012)及《研发支出辅助账汇总表》

--- 须人工确认(1 条)---
  某个没听过的表   未收录于内置申报表指引表,须人工确认
```

校验表(条目守恒):

```
  条目守恒 | 输入 8 = 主表 7 + 异常 1
  内置表单条目 | 24
  重要声明 | 表单版本与行次以最新总局表单为准;税额计算转 caiyouyun-tax-amount-calc
```

## 拒绝权(什么情况下不给判断)

| 情况 | 处理 |
|---|---|
| 缺「事项」列 | **拒绝(RC=2)**,列出可用别名 |
| 行内无事项描述 | 该行进异常表(高),不猜 |
| 事项未收录 | 该行进异常表(中),标「须人工确认」 |
| 输入文件不存在 / 格式不支持 | **拒绝(RC=2)**,说明支持 .xlsx / .csv |
| 用户索要**税额计算** | 明确拒绝代算,转 `caiyouyun-tax-amount-calc` |
| 用户索要**生成申报文件** | 明确边界,转 `caiyouyun-tax-form-fill` |

## 关键设计(容易踩的坑)

1. **给栏次名,不迷信行次号**。表单修订会改行次,但「销售额」「应纳税额」这类**栏次名称**稳定;
   本包以栏次名为主,行次为辅。
2. **合并申报的一表多税**。财产和行为税合并申报后,多个税种共用一张申报表 + 各自税源明细表;
   不能因为「都是财产行为税」就只给一张主表了事。
3. **兜底不跨税种**。只写「增值税」时给常用版本并提示按主体选版;
   但不会把「增值税」兜底到「消费税」——兜底有边界。
4. **不代算税额**。本包给的是「填在哪一栏」,不是「填多少」;
   越界定额计算会让错误无处追责。
5. **填报要点写「口径」不写「数字」**。如「填入免税销售额栏」而非「填 250000」——
   数字由使用者按实际业务确定。
6. **条目守恒**:输入条数 = 主表条数 + 异常表条数。对不上账,本包**拒绝输出**。

## 人工复核(必读)

- 表单**版本与行次**以国家税务总局最新发布为准,本包为定位辅助;
- 「关键栏次」为常见口径,**特殊业务(差额征税、即征即退、跨区预缴等)须核对填报说明**;
- 附报资料清单为**常见要求**,具体以主管税务机关与最新征管要求为准;
- 涉及**税额计算**的,请转专门工具或人工复核,本包不代算。

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 把数据填进表、生成申报文件 | `caiyouyun-tax-form-fill` |
| 算具体应纳税额 | `caiyouyun-tax-amount-calc` |
| 判断支出能否税前扣除 | `caiyouyun-cit-deduction-check` |
| 查减免性质代码 / 税收分类编码 | `caiyouyun-tax-code-lookup` |
| 核验政策文号效力 | `caiyouyun-policy-validity-check` |

## 可直接复制的说法

```text
把这份事项清单跑一遍申报表填报指引。
告诉我每项涉及哪张表、关键栏次填什么、要点是什么、要附什么资料。
认不出的进异常表,别给我猜一个表名。
只给表单定位和栏次口径,不要替我算税额。
先跑预览,我确认了再加 --execute。
```

## 做完怎么算完成

- [ ] 每条都定位到了**具体申报表**(或明确进异常表)
- [ ] 给了**关键栏次与填入口径**,不是只丢一个表名
- [ ] 附报资料清单已明确
- [ ] 明白表单版本以最新总局表单为准
- [ ] 校验表「条目守恒」对得上
- [ ] 未越界代算税额

## 参考资料(渐进式披露)

| 文件 | 内容 | 何时读 |
|---|---|---|
| `references/01-legal-basis.md` | 表单全表 + 关键栏次 + 附报资料 + dataVersion | 需要定位表单、备资料时 |
| `references/02-decision-table.md` | 两层定位口径、兜底边界、特殊业务 | 需要确认定位逻辑时 |
| `references/03-verification-checklist.md` | 填报前核查清单 + 易错情形 | 填报前准备 |

> 这三份是**表单定位与栏次口径**,不是申报表模板——
> 实际填报请以最新官方表单及填报说明为准。

## 输出规范

- **交付形态**:执行结果 + 变更清单,说清动了什么、没动什么。
- **必含字段**:执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。
- **留痕**:产生副作用的执行必须写留痕文件(manifest / log),可回溯。
- **自检**:失败项未列原因,或无可回滚路径,视为未完成。

## 免责声明

本技能输出的是**申报表填报指引**,不构成税务意见,**不替代官方填报说明**。
申报表的版本、行次、填报要求,均以国家税务总局最新发布为准。
因填报不当产生的申报错误、滞纳金等后果,由使用者自行承担。

---

版本:v0.1.0 · 出品:【财友云】 · 规则版本:2026.10

## 反例对照(避开这些写法)

| ❌ 反例 | ✅ 正例 | 判据 |
|---|---|---|
| 只给一个表名,不给栏次 | 表名 + 关键栏次 + 口径 | 用户能否直接照着填 |
| 把行次号当稳定标识硬编码 | 以栏次名为主、行次为辅 | 会不会随表单修订失效 |
| 把「增值税」兜底到「消费税」 | 兜底只在税种层面 | 有没有跨税种乱猜 |
| 替用户算出应填金额 | 只给栏次口径,金额由使用者定 | 是否越界代算 |
| 合并申报只给一张主表 | 主表 + 对应税源明细表 | 是否漏了明细表 |
| 未收录就编一个相似表名 | 进异常表标「须人工确认」 | 有没有把猜当结果 |

<!-- WB-SELFCHECK v1 -->

## 交付前自检(必跑)

本包自带可执行自检脚本。**在交付 / 打包 / 发布之前,必须运行并通过**:

```bash
python scripts/selfcheck.py
```

退出码语义(与本节末尾「退出码(脚本契约)」一致):

| 码 | 含义 | 你要做的事 |
|---|---|---|
| 0 | 全部通过 | 可以交付 |
| 2 | 用法错误 | 检查运行路径,用包根目录下 `scripts/selfcheck.py` |
| 3 | **门禁未通过** | 按 FAIL 项逐条修好再交付,**不要带病交付** |
| 4 | 环境问题 | 检查 Python 版本(需 3.8+)与入口脚本是否可运行 |
| 8 | 部分通过 | 无 FAIL,但有 WARN;建议先修警告项再交付 |

自检覆盖:SKILL.md 与 frontmatter(`name`·`description`)/ 合规声明(frontmatter `license` **或** `ATTRIBUTION.md`,二者其一即可)/ 必备章节 / 打包卫生(禁止 .pyc·__pycache__·.bak·.zip)/ 脚本可编译 / 入口脚本 `--help` 可运行。
<!-- /WB-SELFCHECK -->

## 退出码(脚本契约)

| 码 | 含义 | 你要对用户说的话 |
|---|---|---|
| 0 | 成功 | 直接给结果,不解释过程 |
| 2 | 输入错误(缺参数 / 格式不对 / 文件不存在) | 「你给的 <X> 不对,需要 <Y>」—— 说明正确格式,不要猜默认值硬跑 |
| 3 | 鉴权/授权失败(密钥缺失、无权限) | 「需要你先提供 <凭据>」—— 说明去哪里拿,不要跳过鉴权 |
| 4 | 服务/环境失败(网络不可用、依赖缺失) | 「这一步依赖 <X> 不可用」—— 给出替代路径或降级方案 |
| 8 | 部分成功(有成功项也有失败项) | 「N 项成功、M 项失败」—— 逐条列出失败项与原因,不要只报总数 |

脚本退出非 0 时:**不要静默重试**。先把该码对应的话告诉用户,再决定是补齐输入重试、还是换路径。

## 状态与断点

- 多阶段流程在执行目录写 `outputs/.state.json`,记录「当前阶段 + 已完成产物路径 + 时间」。
- **每个阶段结束后写一次**;中途中断后重启,先读该文件,从断点阶段继续,**不从头重跑**。
- 状态文件只记阶段与产物路径,不记对话内容、不记敏感数据。
- 发现状态文件与实际情况不符(产物已不存在)时,以实际产物为准并重置状态。
这个包已在 SkillHub 上线,可一键安装。
在 SkillHub 上查看完整说明、版本记录与安装方式,支持一键装到你的 AI 客户端。

常见问题

按真实会被问到的顺序排,每条答案都给得出可核对的依据,不含含糊其辞的部分。

申报表填报指引 这个技能,具体能帮我做什么?

【财友云】输入填报事项,输出涉及的申报表、关键栏次与填入口径、填报要点、附报资料与依据。解决「这个业务该填哪张表、填在哪一栏」的高频刚需;不代算税额。

常见的触发场景有:该填哪张表、这个业务填哪张申报表、申报表怎么填。

完整说明、版本记录和安装方式在 SkillHub 上的「申报表填报指引」页面 →。

跑完之后我会拿到什么东西?

输出会落在 _out/ 目录,主要包括:

1.申报表指引_主表.csv逐条:事项 / 主体类型 / 涉及申报表 / 关键栏次与口径 / 填报要点 / 附报
2.申报表指引_异常表.csv须人工确认项(未收录),带风险等级
3.申报表指引_校验表.csv核验口径 / 表单条目 / 版本 / 重要声明 / 条目守恒校验
有没有算不了、它明确拒绝的情况?

有。下面几种情况它会明确拒绝,而不是硬给答案:

·缺「事项」列:拒绝(RC=2),列出可用别名
·行内无事项描述:该行进异常表(高),不猜

总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。

用之前我得注意什么?容易踩哪些坑?

这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:

·给栏次名,不迷信行次号。表单修订会改行次,但「销售额」「应纳税额」这类栏次名称稳定;
·合并申报的一表多税。财产和行为税合并申报后,多个税种共用一张申报表 + 各自税源明细表;
·兜底不跨税种。只写「增值税」时给常用版本并提示按主体选版;
跑完的数能不能直接用?我还要核什么?

不能直接拿去报。它给的是建议和依据,最终判断还是得你来做。下面这几条是它要求你逐条过的:

·表单版本与行次以国家税务总局最新发布为准,本包为定位辅助;
·「关键栏次」为常见口径,特殊业务(差额征税、即征即退、跨区预缴等)须核对填报说明;
·附报资料清单为常见要求,具体以主管税务机关与最新征管要求为准;
数据会不会传出去?我自己怎么验证?

不会。运行时不发一个网络包。你自己就能验证,三条路任选:

把网断掉再跑一遍,功能照常——它本来就没打算联网。

打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。

直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。

要付费吗?要不要配 API Key?

都不要。免费使用,不需要任何 API Key,不联网就不需要 Key,也不存在额度这回事。开源协议 BUSL-1.1,发布满 4 年后自动转为 Apache License 2.0。

装上之后怎么用?

安装后,在支持 SkillHub 的 AI 客户端(如 WorkBuddy)里直接使用即可。

触发方式:对话里提到「该填哪张表、这个业务填哪张申报表、申报表怎么填」等场景,或上传相关表格/凭证,它就会自动响应。

典型用法:把原始文件发给 AI,说『帮我跑 申报表填报指引』或『处理一下这个』,结果会输出到当前目录的 _out/申报表指引_主表.csv。

也可以从客户端的「已安装技能」列表里手动唤起。

什么环境能跑?需要装依赖吗?

Windows / macOS / Linux 都能跑,不需要 pip install 任何东西。

运行只依赖 Python 3 标准库:全站 345 个脚本的首行都是 #!/usr/bin/env python3,没有第三方依赖,也就没有环境冲突要调。

装在哪个客户端上?会不会弄坏我原来的文件?

在 SkillHub 上一键安装即可,主流 AI 客户端都能装。运行是只读 + 输出到 _out/,你原来的账套和表格一个字节都不会被动。

相邻技能

规划中 P2 记账

减免性质代码映射

【财友云】内置国家税务总局《减免税政策代码目录》码表离线快照(有效码 912 条 + 失效码 689 条,共 1,601 条),支持双向映射:输入 8 位减免性质代码,返回收入种类、减免政策大类/小类、政策名称、优惠条款、减免项目名称、有效期与关联政策,并标注该代码有效或失效;输入政策名称或减免项目关键词,反查匹配的全部代码。适用于填报减免税申报表时核对减免性质代码含义、复核申报表引用的代码是否已失效、按优惠项目反查代码等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 记账

财报附注撰写辅助

【财友云】上市公司财报附注的章节模板与撰写检查单(会计政策、估计变更、关联方、重要事项),面向 IR/董秘。是写不是荐,完全安全。

规划中 P1 记账

科目映射标准化

多系统科目对照,模糊匹配 + 人工确认清单,输出映射表

规划中 P1 记账

批量生成记账凭证

从业务单据表按科目映射批量生成凭证草稿,借贷平衡预检

规划中 P2 记账

会计政策与准则应用助手

【财友云】新收入准则五步法、租赁、金融工具、减值等会计准则应用问答框架与决策树。企业财务高频刚需,纯知识交付。

规划中 P2 记账

财报结构化提取与差异对比

【财友云】把财报科目表结构化并对比两个报告期的科目变动、措辞与附注增删改,输出客观 diff 清单。纯信息整理,不评价好坏。

规划中 P2 记账

凭证整理归档包生成

【财友云】把散文件夹整理成可归档结构:原件归位+元数据提取+与凭证的关联关系表+移交清册,本地生成目录结构不托管。

规划中 P2 记账

月度归档 Playbook

【财友云】月度归档订阅的方法学:每月固定跑同一套检查(原件核对+查重+四性),输出本月差异项与上月未闭环项跟踪。

规划中 P2 记账

跨年度凭证匹配自检

【财友云】检查凭证开票日期与入账期间是否跨年度,按跨度分组,标出入账早于开票的暂估项。