底座 · 计算工具 / 归档 / 合规

政策时效提醒

【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。

已上线 P2 L0

政策时效提醒

【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。

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

标签

[政策时效,政策提醒,法规效力,政策有效期]

技能正文(随包 SKILL.md)

> **本地运行,零网络请求、免 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 上线,可一键安装。
在 SkillHub 上查看完整说明、版本记录与安装方式,支持一键装到你的 AI 客户端。

常见问题

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

政策时效提醒 这个技能,具体能帮我做什么?

【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。

常见的触发场景有:政策提醒、政策时效、法规效力。

完整说明、版本记录和安装方式在 SkillHub 上的「政策时效提醒」页面 →。

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

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

1.政策时效提醒_主表.csv文号/名称 / 生效日期 / 失效日期 / 时效状态 / 剩余天数 / 提醒动作 /
2.政策时效提醒_异常表.csv无法标识或须人工确认的记录
3.政策时效提醒_校验表.csv核验口径 / 参考日 / 阈值 / 版本 / 重要声明 / 条目守恒校验
有没有算不了、它明确拒绝的情况?

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

·缺「文号」且无「文件名称」:拒绝(RC=2),列出可用别名
·既无失效日期又无效力状态:拒绝(RC=2),先补齐日期或状态

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

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

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

·日期维度 ≠ 权威核验。本包只用你给的日期算,不联网、不查库、不臆造效力。
·缺日期不猜。失效日期缺失一律标「须人工确认」,绝不默认「长期有效」放行。
·尊重用户标注。你若明确写了「效力状态=已废止」,本包尊重并提示以主管机关口径最终确认。
跑完的数能不能直接用?我还要核什么?

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

·本包输出是时效提醒,不是法律意见,不能作为「某文是否现行有效」的最终依据;
·关键/高风险政策(优惠依据、税前扣除、行业特准)务必以主管机关现行有效法规及官方公告为准;
·对「即将到期」「已废止」的条目,建议转 caiyouyun-policy-validity-check 做权威核验后再落结论。
数据会不会传出去?我自己怎么验证?

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

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

打开包里的 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 底座

财税法规原文速查

【财友云】内置国家税务总局税收法规库的法规条目索引离线快照(约 5,473 条),按法规名称、关键词或税种检索,逐条给出时效性(全文有效/已修改/全文失效/全文废止/尚未生效)、效力等级(法律/行政法规/部门规章/规范性文件)、发布日期、修订沿革注释与官方原文链接,并支持按「有效」或「废止」等时效性、按效力等级筛选。适用于下结论前先确认依据文件还生不生效、某一税种有哪些现行文件、文号文件被谁替代等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

商品归类结构指引

【财友云】内置出口退税率文库商品码表快照(约 3.2 万个 8/10 位商品代码),把待查编码按 HS 规则拆成「章 / 品目 / 子目 / 本国子目」四层,做 8/10 位位数校验,并在码表里命中官方商品名称与计量单位,同时给出《进出口税则》归类总规则(GRI 1–6)的方法论提示。适用于外贸 / 财税人员核对编码层级写对没写对、按名称反查可能的编码、编码位数自检等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

进出口关税税率速查

【财友云】内置国务院关税税则委员会《2026年关税调整方案》五张附表离线快照(进口商品暂定税率表 935 条、关税配额商品税目税率表 47 条、出口商品税率表 107 条,另有税目调整表与本国子目注释调整表),按税则号列或商品名称查进口最惠国税率、2026 年暂定税率、关税配额税率与出口税率,并提示该税则号列是否涉及税目调整 / 子目注释变化。适用于进出口报价前核税率、判断「出口要不要交关税」、核对进口暂定税率适用等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

关税政策追踪

【财友云】内置财政部关税司(国务院关税税则委员会办公室)政策发布公告索引离线快照(497 条,2008–2026 年),按关键词或年份检索关税税则委员会公告,输出标题、发布日期与原文链接,并按发布日期倒序。适用于追踪「美国 / 加征 / 零关税 / 暂定税率 / 税则」等主题的最新关税政策、核对某年度关税公告清单、定位政策原文链接等场景。数据为离线快照、版本可查,运行时零联网;本包只做公告索引检索与定位,不做政策解读。

规划中 P2 底座

出口退税率速查

【财友云】内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码),按商品代码或商品名称查出口退税率、征税率、计量单位与生效期,并支持「退税率 13% 的商品有哪些」这类反向清单查询。适用于外贸企业报价前核税率、出口退税申报前核对商品退税率、财务复核退税额计算口径等场景。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

财税官方问答检索

【财友云】把一句财税问题检索到权威官方口径——在内置的国家税务总局「互动交流」官方问答语料(394 条,跨 2021–2026)上做本地 BM25 检索,返回命中的官方问答原文要点 + 依据文号 + 发布日期 + 原文链接。检索不到就说检索不到并给官方入口,绝不拿「看起来相关」的问答凑答案。

规划中 P2 底座

原产地规则与协定税率速查

【财友云】内置两套官方数据:① 国家税务总局「税收条约」栏目索引快照(142 条,含条约/协定名称与原文链接);② 国务院关税税则委员会《2026 年关税调整方案》附 6「自贸协定和优惠贸易安排实施税率表」(8,931 个税则号列 × 32 个协定/优惠安排)。按协定或国家名定位条约原文,按税则号列摘录各协定优惠税率。适用于查某国/某协定有没有税收协定、条约原文在哪、某税则号列在东盟/RCEP/韩国等协定下适用什么优惠税率等场景。只做条款与税率的定位与摘录,不做原产地判定。数据为离线快照、版本可查,运行时零联网。

规划中 P2 底座

法规效力核验

【财友云】逐条核验财税法规的效力状态——现行有效、尚未生效、已修改、条款废止、条款失效、部分废止、条款修订、全文失效、全文废止等,判定依据以**官方时效性字段**为第一级来源(内置国家税务总局法规库效力快照,去重后 5,386 条),每条结论标注来源与置信分级,官方库未标注或未收录的一律标「须回官方核验」不猜。适用于引法前的效力自查、政策清理、存量制度梳理等场景。

规划中 P2 底座

研发费用加计扣除归集判断

【财友云】逐行判断研发费用能不能加计、加计多少,含「其他相关费用」10%÷(1−10%) 交叉限额与负面清单筛查,每条结论带条文号。认不出的费用标「需人工核实」。适用于研发费用归集、加计扣除自查、辅助账核对等场景。