【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。
【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。
SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。[政策时效,政策提醒,法规效力,政策有效期]
> **本地运行,零网络请求、免 API Key、不主动外发数据。** > 时效判定严格以「输入清单里的生效/失效日期 + 参考日」做确定性日期运算,不联网查库、不臆造效力。关键/高风险政策的最终效力,以主管机关现行有效法规及官方公告为准,本包只做日期维度提醒,不替代权威核验。 <!-- WB-CLAIM-BOUNDARY v1 --> # 政策时效提醒 政策工具箱里最容易被忽略的风险,是**「还在用一份已经废止的文件」**: 财税优惠、扣除标准、申报口径年年更新,旧文废止、新文施行、过渡期衔接,一旦引用错版本,结论直接错。 本包不做「联网查库」——那不是本地工具该干的活;它做的是**把你手上的政策清单,按日期维度统一过一遍时效**: 已废止 / 即将到期 / 仍有效 / 未填失效日期(须人工确认),并给每条一个**提醒动作**和**转交建议**。 > ⚠️ 本包仅做**日期维度提醒**。对关键/高风险政策,时效结论须以主管机关现行有效法规及官方公告为准,必要时转 `caiyouyun-policy-validity-check` 做权威核验。 ## 运行方式 <!-- WB-INVOKE-CONTRACT v1 --> **环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。 **作用**:以给定参考日(默认今天)为基准,逐条判定政策时效状态。 **命令**(在技能目录下执行): ```bash # 基准日=今天,清单含 生效日期/失效日期 列 python scripts/policy-validity-reminder.py <政策清单.csv> # 指定参考日(如 2026-12-31 做年末盘点) python scripts/policy-validity-reminder.py <政策清单.csv> --as-of 2026-12-31 # 调整「即将到期」阈值(默认距失效 ≤180 天) python scripts/policy-validity-reminder.py <政策清单.csv> --horizon 90 # 确认无误后正式执行 python scripts/policy-validity-reminder.py <政策清单.csv> --execute ``` **参数**: | 参数 | 说明 | |---|---| | `<file>` | 政策清单(.xlsx / .csv),首行表头 | | `--as-of YYYY-MM-DD` | 参考日(默认今天) | | `--horizon N` | 距失效 ≤N 天算「即将到期」(默认 180) | | `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) | | `--operator OPERATOR` | 操作人(写入留痕) | | `--execute` | 真正写盘 | **退出码**:`0` 成功 / `2` 输入错误 / `3` 鉴权失败 / `4` 环境或依赖失败 / `8` 部分成功。 **输出**:四件套写入 `--out-dir`,源文件不改动;先跑预览确认,再加 `--execute` 落盘。 ## 何时不触发 1. 要的是**权威核验某文是否现行有效**(联网/查库/出处溯源) → 转 `caiyouyun-policy-validity-check`。 2. 要的是**政策内容解读/适用判断**(这份文对我公司适用吗) → 转专业税务/法务。 3. 清单**完全没有失效日期也没有效力状态** → 本包无法判定,先补齐日期或状态再跑。 ## 工作流(编号阶段) | 阶段 | 做什么 | 产物 | 闸门 | |---|---|---|---| | 一 | 读取清单:逐行取 文号/名称、生效、失效、效力状态 | 政策清单 | 行内无标识(无文号无名)→ 异常表 | | 二 | 日期运算:以参考日比对生效/失效,定状态 | 状态判定 | 失效日期缺失 → 标「须人工确认」 | | 三 | 出提醒:状态 + 剩余天数 + 提醒动作 + 转交建议 | 提醒主表 | — | ## 判断框架(时效状态口径) | 状态 | 判定(参考日 T、失效日 E) | 提醒动作 | |---|---|---| | 已废止 | E < T | 不得再引用,清理引用处、定位替代政策 | | 即将到期 | 0 < (E−T) ≤ 阈值(默认180天) | 提前评估替代/续期/合规切换 | | 仍有效 | (E−T) > 阈值 | 纳入周期复核 | | 未填失效日期 | 清单未给失效日 | 请补充日期或确认是否长期有效 | | 未生效 | 生效日 > T | 留意施行后衔接 | > 若输入同时给了「效力状态=已废止/失效」,本包尊重该标注并提示以主管机关口径最终确认。 ## 输入 / 输出 输入:1 张政策清单(`.xlsx` / `.csv`),首行表头。 | 列 | 必需 | 别名 | |---|---|---| | 文号 | 与名称二选一 | 文号 / 文件文号 / 发文字号 / 编号 | | 文件名称 | 与文号二选一 | 名称 / 文件名 / 政策名称 / 标题 | | 生效日期 | 可选 | 生效日期 / 施行日期 / 执行日期 | | 失效日期 | 与效力状态二选一 | 失效日期 / 到期日期 / 有效期至 / 废止日期 | | 效力状态 | 与失效日期二选一 | 效力状态 / 状态 / 是否有效 | 输出(进 `--out-dir`,源文件一个字节都不动): | 文件 | 内容 | |---|---| | `政策时效提醒_主表.csv` | 文号/名称 / 生效日期 / 失效日期 / 时效状态 / 剩余天数 / 提醒动作 / 转交建议 | | `政策时效提醒_异常表.csv` | 无法标识或须人工确认的记录 | | `政策时效提醒_校验表.csv` | 核验口径 / 参考日 / 阈值 / 版本 / 重要声明 / **条目守恒校验** | | `fin-log.jsonl` | 处理日志(追加,含输入 sha256) | ## 真实输出 正常(参考日 2026-12-31): ``` --- 政策时效提醒(参考日 2026-12-31,共 2 条,0 条须人工确认)--- 财税〔2019〕13号 | 即将到期 | 剩余45天 国税发〔2018〕28号 | 已废止 | 剩余-400天 --- 校验表 --- 条目守恒 | 输入 2 = 主表 2 + 异常 0 参考日 | 2026-12-31 重要声明 | 时效仅作日期维度提醒;关键政策以主管机关口径为准 ``` ## 拒绝权(什么情况下不给判定) | 情况 | 处理 | |---|---| | 缺「文号」且无「文件名称」 | **拒绝(RC=2)**,列出可用别名 | | 既无失效日期又无效力状态 | **拒绝(RC=2)**,先补齐日期或状态 | | 参考日无法识别 | **拒绝(RC=2)**,用 YYYY-MM-DD | | 索要「某文是否现行有效」的权威结论 | 明确转 `caiyouyun-policy-validity-check`,本包不做联网核验 | ## 关键设计(容易踩的坑) 1. **日期维度 ≠ 权威核验**。本包只用你给的日期算,不联网、不查库、不臆造效力。 2. **缺日期不猜**。失效日期缺失一律标「须人工确认」,绝不默认「长期有效」放行。 3. **尊重用户标注**。你若明确写了「效力状态=已废止」,本包尊重并提示以主管机关口径最终确认。 4. **条目守恒**:输入条数 = 主表条数 + 异常表条数。对不上账,本包**拒绝输出**。 ## 人工复核(必读) - 本包输出是**时效提醒**,不是法律意见,不能作为「某文是否现行有效」的最终依据; - 关键/高风险政策(优惠依据、税前扣除、行业特准)务必以**主管机关现行有效法规及官方公告**为准; - 对「即将到期」「已废止」的条目,建议转 `caiyouyun-policy-validity-check` 做权威核验后再落结论。 ## 相邻路线转交 | 用户要做的事 | 转交给 | |---|---| | 权威核验某文是否现行有效 | `caiyouyun-policy-validity-check` | | 政策内容解读/对我司适用性 | 专业税务/法务 | | 政策红利匹配(我公司能享受哪些优惠) | `caiyouyun-tax-benefit-matcher` | ## 可直接复制的说法 ```text 把这份政策清单跑一遍时效提醒,参考日用今天。 每条给我:时效状态、剩余天数、提醒动作、转交建议。 关键政策别只信日期,转权威核验;先跑预览,我确认了再加 --execute。 ``` ## 做完怎么算完成 - [ ] 每条政策都标了**时效状态 + 剩余天数 + 提醒动作** - [ ] 「已废止/即将到期」的条目已给出**转交建议** - [ ] 异常表里的「须人工确认」项已逐条处理或有明确去向 - [ ] 校验表「条目守恒」对得上 - [ ] 明白本包是**日期维度提醒**,关键政策已转权威核验 ## 参考资料(渐进式披露) | 文件 | 内容 | 何时读 | |---|---|---| | `references/01-legal-basis.md` | 政策时效相关依据与口径来源 | 需要核对依据时 | | `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 / 合规声明 / 必备章节 / 打包卫生 / 脚本可编译 / 入口脚本 `--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/,你原来的账套和表格一个字节都不会被动。
【财友云】内置国家税务总局税收法规库的法规条目索引离线快照(约 5,473 条),按法规名称、关键词或税种检索,逐条给出时效性(全文有效/已修改/全文失效/全文废止/尚未生效)、效力等级(法律/行政法规/部门规章/规范性文件)、发布日期、修订沿革注释与官方原文链接,并支持按「有效」或「废止」等时效性、按效力等级筛选。适用于下结论前先确认依据文件还生不生效、某一税种有哪些现行文件、文号文件被谁替代等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置出口退税率文库商品码表快照(约 3.2 万个 8/10 位商品代码),把待查编码按 HS 规则拆成「章 / 品目 / 子目 / 本国子目」四层,做 8/10 位位数校验,并在码表里命中官方商品名称与计量单位,同时给出《进出口税则》归类总规则(GRI 1–6)的方法论提示。适用于外贸 / 财税人员核对编码层级写对没写对、按名称反查可能的编码、编码位数自检等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置国务院关税税则委员会《2026年关税调整方案》五张附表离线快照(进口商品暂定税率表 935 条、关税配额商品税目税率表 47 条、出口商品税率表 107 条,另有税目调整表与本国子目注释调整表),按税则号列或商品名称查进口最惠国税率、2026 年暂定税率、关税配额税率与出口税率,并提示该税则号列是否涉及税目调整 / 子目注释变化。适用于进出口报价前核税率、判断「出口要不要交关税」、核对进口暂定税率适用等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置财政部关税司(国务院关税税则委员会办公室)政策发布公告索引离线快照(497 条,2008–2026 年),按关键词或年份检索关税税则委员会公告,输出标题、发布日期与原文链接,并按发布日期倒序。适用于追踪「美国 / 加征 / 零关税 / 暂定税率 / 税则」等主题的最新关税政策、核对某年度关税公告清单、定位政策原文链接等场景。数据为离线快照、版本可查,运行时零联网;本包只做公告索引检索与定位,不做政策解读。
【财友云】内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码),按商品代码或商品名称查出口退税率、征税率、计量单位与生效期,并支持「退税率 13% 的商品有哪些」这类反向清单查询。适用于外贸企业报价前核税率、出口退税申报前核对商品退税率、财务复核退税额计算口径等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】把一句财税问题检索到权威官方口径——在内置的国家税务总局「互动交流」官方问答语料(394 条,跨 2021–2026)上做本地 BM25 检索,返回命中的官方问答原文要点 + 依据文号 + 发布日期 + 原文链接。检索不到就说检索不到并给官方入口,绝不拿「看起来相关」的问答凑答案。
【财友云】内置两套官方数据:① 国家税务总局「税收条约」栏目索引快照(142 条,含条约/协定名称与原文链接);② 国务院关税税则委员会《2026 年关税调整方案》附 6「自贸协定和优惠贸易安排实施税率表」(8,931 个税则号列 × 32 个协定/优惠安排)。按协定或国家名定位条约原文,按税则号列摘录各协定优惠税率。适用于查某国/某协定有没有税收协定、条约原文在哪、某税则号列在东盟/RCEP/韩国等协定下适用什么优惠税率等场景。只做条款与税率的定位与摘录,不做原产地判定。数据为离线快照、版本可查,运行时零联网。
【财友云】逐条核验财税法规的效力状态——现行有效、尚未生效、已修改、条款废止、条款失效、部分废止、条款修订、全文失效、全文废止等,判定依据以**官方时效性字段**为第一级来源(内置国家税务总局法规库效力快照,去重后 5,386 条),每条结论标注来源与置信分级,官方库未标注或未收录的一律标「须回官方核验」不猜。适用于引法前的效力自查、政策清理、存量制度梳理等场景。
【财友云】逐行判断研发费用能不能加计、加计多少,含「其他相关费用」10%÷(1−10%) 交叉限额与负面清单筛查,每条结论带条文号。认不出的费用标「需人工核实」。适用于研发费用归集、加计扣除自查、辅助账核对等场景。