【财友云】面向财务人自身的理财科普:输入关注主题(个税汇算/专项扣除/社保公积金/个人养老金/家庭保障/稳健理财/防诈防坑),输出结构化科普卡(政策依据+核心要点+操作步骤+风险提示),严守不荐股/不承诺收益/不荐具体产品红线。
【财友云】面向财务人自身的理财科普:输入关注主题(个税汇算/专项扣除/社保公积金/个人养老金/家庭保障/稳健理财/防诈防坑),输出结构化科普卡(政策依据+核心要点+操作步骤+风险提示),严守不荐股/不承诺收益/不荐具体产品红线。
SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。[理财科普, 个人理财, 个税汇算, 社保公积金, 稳健理财, 防诈防坑]
> **本地运行,零网络请求、免 API Key、不主动外发数据。** > 四项诚实承诺:① 不荐股(不提具体标的);② 不承诺收益(不写「年化 X%」);③ 不荐具体产品(不指定品牌);④ 仅科普与提醒,配置须咨询持牌顾问。 > 边界说明:本包脚本自身不联网、不外发;若你把内容贴进 AI 对话,内容是否离开本机由你所使用的客户端决定。 <!-- WB-CLAIM-BOUNDARY v1 --> # 财务人理财科普 财务人帮公司算账精明,轮到自己家「理财」却常被两类坑: **一是信息过载**——个税、社保、公积金、养老金、保险、理财,每个都该懂一点,但碎片信息难成体系; **二是销售话术**——「保本高息」「稳赚不赔」「内部渠道」,专挑懂点财务、又想要收益的人。 本包不做「卖你一个产品」,而是把**财务人自身最该懂的理财主题**,整理成一张张**结构化科普卡**: 政策依据 + 核心要点 + 操作步骤 + 风险提示 + 红线。确定性、可核查、不画饼。 > ⚠️ 本包是**理财科普与风险提醒**,**不构成投资建议、不荐股、不承诺收益、不荐具体产品**。 > 任何具体配置(买哪只、投多少、怎么组合)须咨询持牌投资/保险顾问,以监管与机构最新口径为准。 ## 运行方式 <!-- WB-INVOKE-CONTRACT v1 --> **环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。 **作用**:把输入的关注主题,逐条生成结构化科普卡。 **命令**(在技能目录下执行): ```bash # 方式一:清单文件(.xlsx / .csv,首行表头:主题) python scripts/finance_literacy.py <主题清单.csv> # 方式二:直接指定主题(可多个) python scripts/finance_literacy.py --topic 个税汇算 稳健理财 防诈防坑 # 确认无误后正式执行 python scripts/finance_literacy.py <主题清单.csv> --execute ``` **参数**: | 参数 | 说明 | |---|---| | `<file>` | 主题清单(.xlsx / .csv),首行表头,含 主题 | | `--topic` | 主题(可多个,与 file 二选一) | | `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) | | `--operator OPERATOR` | 操作人(写入留痕) | | `--execute` | 真正写盘 | **退出码**:`0` 成功 / `2` 输入错误 / `3` 鉴权失败 / `4` 环境或依赖失败 / `8` 部分成功。 **输出**:四件套写入 `--out-dir`,源文件不改动;先跑预览确认,再加 `--execute` 落盘。 ## 何时不触发 1. 要的是**公司财税筹划**(分红/架构/优惠临界点) → 转 `caiyouyun-tax-plan-advisor`。 2. 要的是**投资个股/基金标的推荐** → 明确拒绝:本包不荐股、不荐具体标的。 3. 要的是**具体产品/平台推荐** → 明确拒绝:本包不荐具体产品,只做科普与机制讲解。 4. 要的是**涉税违法筹划**(阴阳合同/虚开) → 明确拒绝并转专业税务/法律人士。 ## 工作流(编号阶段) | 阶段 | 做什么 | 产物 | 闸门 | |---|---|---|---| | 一 | 主题读取:逐行取「主题」 | 主题清单 | 行内无主题,直接进异常表 | | 二 | 主题匹配:命中内置科普知识库(支持别名/包含匹配) | 命中清单 | 未命中 → 进异常表,不编造 | | 三 | 出卡:政策依据 + 核心要点 + 操作步骤 + 风险提示 + 红线 | 科普卡主表 | — | ## 判断框架(主题覆盖范围) | 主题 | 覆盖要点 | |---|---| | 个税综合所得汇算 | 四类综合所得合并计税、3–6 月办理、多退少补机制 | | 专项附加扣除 | 七项扣除、标准内定额/限额、降应纳税所得额 | | 社保缴费与待遇 | 五险、缴费基数核定、断缴影响 | | 住房公积金 | 缴存比例、购房/租房提取、贷款连续缴存要求 | | 个人养老金 | 年缴上限、递延纳税、封闭运行、自负盈亏 | | 家庭保障配置 | 保障优先于投资、先大人后小孩、看清责任免除 | | 稳健理财 | 风险由低到高:存款→国债→货基→理财R1/R2;收益风险成正比 | | 防诈防坑 | 保本高息/杀猪盘/庞氏识别、查牌照、96110 | > 未收录主题一律进异常表标「须人工判断」,绝不编造一张卡凑数。 ## 输入 / 输出 输入:1 张主题清单(`.xlsx` / `.csv`),首行表头。 | 列 | 必需 | 别名 | |---|---|---| | 主题 | 必需 | 主题 / 关注主题 / 想了解 / 事项 | | 备注 | 可选 | 备注 / 说明 / 补充 | 输出(进 `--out-dir`,源文件一个字节都不动): | 文件 | 内容 | |---|---| | `理财科普_主表.csv` | 逐条:主题 / 政策依据 / 核心要点 / 操作步骤 / 风险提示 / 红线 | | `理财科普_异常表.csv` | 未收录主题(须人工判断) | | `理财科普_校验表.csv` | 核验口径 / 知识库条目 / 版本 / 重要声明 / **条目守恒校验** | | `fin-log.jsonl` | 处理日志(追加,含输入 sha256) | ## 真实输出 正常(3 个主题): ``` --- 理财科普(共 3 张卡,0 条须人工判断)--- 个税综合所得汇算 | 红线:不荐股/不承诺退税金额/不代持身份 稳健理财 | 红线:不荐具体产品/不承诺收益/不写「年化 X%」 防诈防坑 | 红线:不荐任何「项目/平台」;警示一切「保本高息」极高风险 --- 校验表 --- 条目守恒 | 输入 3 = 主表 3 + 异常 0 知识库条目 | 8 重要声明 | 本包为理财科普与风险提醒,不构成投资建议;不荐股/不承诺收益/不荐具体产品 ``` ## 拒绝权(什么情况下不给科普卡) | 情况 | 处理 | |---|---| | 缺「主题」列 | **拒绝(RC=2)**,列出可用别名 | | 行内无主题描述 | 该行进异常表(高),不猜 | | 主题未收录 | 该行进异常表(中),标「须人工判断」 | | 索要「买哪只/投哪个平台」 | 明确拒绝荐产品/荐标的,只做机制科普 | | 索要「稳赚/保本高息」方案 | 明确警示风险,拒绝承诺收益 | ## 关键设计(容易踩的坑) 1. **科普 ≠ 建议**。本包只讲「机制、依据、风险、红线」,不给「你该买什么」。 2. **不承诺收益**。任何「年化 X%」「稳赚」都违反红线,本包输出里不会出现。 3. **不荐股不荐产品**。涉及具体股票/基金/银行/保险/理财品牌,一律不提。 4. **政策时效**。社保/公积金/个人养老金/专项扣除的具体标准由各地与年度公告调整,卡内标注「以现行口径为准」,不替你判断当下数值。 5. **条目守恒**:输入条数 = 主表条数 + 异常表条数。对不上账,本包**拒绝输出**。 ## 人工复核(必读) - 本包输出是**科普与风险提醒**,不是投资建议,不能作为任何投资/投保决策依据; - 具体配置(买哪只、投多少、如何组合)须咨询**持牌**投资/保险顾问; - 涉及税务办理,以**主管税务机关**当年公告与口径为准; - 遇「保本高息」「内部渠道」「拉人头」,先打 96110 / 查金融牌照再动钱。 ## 相邻路线转交 | 用户要做的事 | 转交给 | |---|---| | 公司税务筹划(分红/架构/优惠) | `caiyouyun-tax-plan-advisor` | | 涉税风险自查(稽查信号) | `caiyouyun-audit-redflag-check` | | 政策效力核验 | `caiyouyun-policy-validity-check` | | 具体投资/投保方案 | 持牌投资/保险顾问(本包不替代) | ## 可直接复制的说法 ```text 把这份理财主题清单跑一遍科普生成。 每张卡给我:政策依据、核心要点、操作步骤、风险提示、红线。 不荐股、不承诺收益、不荐具体产品,只做科普与提醒。 先跑预览,我确认了再加 --execute。 ``` ## 做完怎么算完成 - [ ] 每个主题都给到了**政策依据 + 要点 + 操作 + 风险 + 红线** - [ ] 异常表里的「须人工判断」项已逐条处理或有明确去向 - [ ] 明白本包是**科普提醒**、不是投资建议 - [ ] 校验表「条目守恒」对得上 - [ ] 输出未出现任何具体标的/产品/收益承诺 ## 参考资料(渐进式披露) | 文件 | 内容 | 何时读 | |---|---|---| | `references/01-legal-basis.md` | 各主题政策依据与口径来源 | 需要核对依据时 | | `references/02-decision-table.md` | 主题匹配口径、红线含义、边界情形 | 需要确认判定逻辑时 | | `references/03-verification-checklist.md` | 使用前置清单 + 高风险情形 | 自查前准备、事后复核 | > 这三份是**科普口径与政策来源**,不是投资建议库——具体配置以持牌顾问与监管最新口径为准。 ## 输出规范 - **交付形态**:执行结果 + 变更清单,说清动了什么、没动什么。 - **必含字段**:执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。 - **留痕**:产生副作用的执行必须写留痕文件(manifest / log),可回溯。 - **自检**:失败项未列原因,或无可回滚路径,视为未完成。 ## 免责声明 本技能输出的是**理财科普与风险提醒**,不构成任何投资建议、税务意见或法律意见, **不荐股、不承诺收益、不荐具体产品**。具体配置须咨询持牌投资/保险顾问, 并以监管与机构最新口径为准。因使用本提示产生的任何后果,由使用者自行承担。 --- 版本:v0.1.0 · 出品:【财友云】 · 规则版本:2026.10 ## 反例对照(避开这些写法) | ❌ 反例 | ✅ 正例 | 判据 | |---|---|---| | 「这款理财年化 5%,闭眼买」 | 只讲风险等级(R1–R5)与匹配逻辑,不写具体收益 | 有没有承诺收益 | | 「买 XX 银行 XX 产品最划算」 | 不指定品牌,讲机制与对比维度 | 有没有荐具体产品 | | 「这只股票必涨」 | 本包不覆盖个股,转持牌顾问 | 有没有荐股 | | 未收录主题编一张卡 | 进异常表标「须人工判断」 | 用户能否看出这条没把握 | <!-- 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 / 合规声明 / 必备章节 / 打包卫生 / 脚本可编译 / 入口脚本 `--help` 可运行。 ## 退出码(脚本契约) | 码 | 含义 | 你要对用户说的话 | |---|---|---| | 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/,你原来的账套和表格一个字节都不会被动。
【财友云】把企业申报的出口明细逐条与官方出口退税率对账——按商品代码查官方退税率,核对申报退税率是否一致,并按「出口金额 × 官方退税率」勾稽申报退税额,差异超容差或代码查不到的一律进异常表并给差额与风险等级。内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码)。适用于出口退税申报前复核、退税数据自查、代账交接核对等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】把表格变成带数字溯源的分析报告:每个数字可回溯到原表区域与聚合口径,提供溯源模板与回查清单。
【财友云】从零构建可审计工作簿的强制规范:计算用活公式、假设集中引用、关键假设黄底、交付前 recalc 验证零错误。
按标准字段模板合并多张 Excel/CSV,保留来源文件与来源部门列,业务唯一键查重,输出合并表/重复表/缺字段表
【财友云】按《中小企业划型标准规定》逐户判定大型 / 中型 / 小型 / 微型,十六个行业门类的指标门槛内置,多指标行业按「且」关系判定,行业认不出或指标缺失一律进异常表不猜。适用于小微优惠前置判断、政府采购资格、专精特新申报等场景。
【财友云】诊断表格会不会被 AI 误读:合并单元格占比、多级表头、表头偏移、数字存文本、单位混用、日期不一,输出评分与修复项。
【财友云】把复杂 Excel 公式逐层翻译成人话,标风险点:绝对引用缺失、IF嵌套过深、整列引用、易失函数;本地零联网。
从大表抽样 20-50 行并对姓名/税号/银行卡/手机号/金额做保形脱敏,供试跑与外发,原表零改动
日期统一 YYYY-MM-DD、金额转数值、名称按映射表替换、空值/重复/非数字进异常表,输出标准表+异常表+校验表