【财友云】输入填报事项,输出涉及的申报表、关键栏次与填入口径、填报要点、附报资料与依据。解决「这个业务该填哪张表、填在哪一栏」的高频刚需;不代算税额。
【财友云】输入填报事项,输出涉及的申报表、关键栏次与填入口径、填报要点、附报资料与依据。解决「这个业务该填哪张表、填在哪一栏」的高频刚需;不代算税额。
SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。[申报表, 填报指引, 纳税申报, 表单定位, 附报资料]
> **本地运行,零网络请求、免 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 上的「申报表填报指引」页面 →。
输出会落在 _out/ 目录,主要包括:
申报表指引_主表.csv逐条:事项 / 主体类型 / 涉及申报表 / 关键栏次与口径 / 填报要点 / 附报申报表指引_异常表.csv须人工确认项(未收录),带风险等级申报表指引_校验表.csv核验口径 / 表单条目 / 版本 / 重要声明 / 条目守恒校验有。下面几种情况它会明确拒绝,而不是硬给答案:
总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。
这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:
不能直接拿去报。它给的是建议和依据,最终判断还是得你来做。下面这几条是它要求你逐条过的:
不会。运行时不发一个网络包。你自己就能验证,三条路任选:
把网断掉再跑一遍,功能照常——它本来就没打算联网。
打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。
直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。
都不要。免费使用,不需要任何 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/,你原来的账套和表格一个字节都不会被动。
【财友云】内置国家税务总局《减免税政策代码目录》码表离线快照(有效码 912 条 + 失效码 689 条,共 1,601 条),支持双向映射:输入 8 位减免性质代码,返回收入种类、减免政策大类/小类、政策名称、优惠条款、减免项目名称、有效期与关联政策,并标注该代码有效或失效;输入政策名称或减免项目关键词,反查匹配的全部代码。适用于填报减免税申报表时核对减免性质代码含义、复核申报表引用的代码是否已失效、按优惠项目反查代码等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】上市公司财报附注的章节模板与撰写检查单(会计政策、估计变更、关联方、重要事项),面向 IR/董秘。是写不是荐,完全安全。
多系统科目对照,模糊匹配 + 人工确认清单,输出映射表
从业务单据表按科目映射批量生成凭证草稿,借贷平衡预检
【财友云】新收入准则五步法、租赁、金融工具、减值等会计准则应用问答框架与决策树。企业财务高频刚需,纯知识交付。
【财友云】把财报科目表结构化并对比两个报告期的科目变动、措辞与附注增删改,输出客观 diff 清单。纯信息整理,不评价好坏。
【财友云】把散文件夹整理成可归档结构:原件归位+元数据提取+与凭证的关联关系表+移交清册,本地生成目录结构不托管。
【财友云】月度归档订阅的方法学:每月固定跑同一套检查(原件核对+查重+四性),输出本月差异项与上月未闭环项跟踪。
【财友云】检查凭证开票日期与入账期间是否跨年度,按跨度分组,标出入账早于开票的暂估项。