印花税政策第二大脑（stamp-tax-policy）
把用户桌面 印花税政策文档/ 下 159 篇印花税政策 docx（国家税务总局 147 + 财政部 8 + 地方法规 4）封装成可全文检索的「第二大脑」。每篇文档正文前都内嵌结构化元数据（来源 / 效力级别 / 发布日期 / 栏目 / 原文链接），其中 88 篇已通过 印花税政策清单.xlsx 的「涉及印花税要点」列补充关键标签，可精准过滤与引用。
何时使用
- 用户问「某印花税政策怎么规定」「XX 合同 / 产权转移书据 / 营业账簿 怎么贴花」「免征范围 / 优惠怎么享受」「计税依据 / 纳税期限 / 申报地点 如何确定」。
- 需要定位并引用政策原文、出具处（发文机关 + 发布日期 + 原文链接）。
- 对比「印花税法」与「印花税暂行条例」、新旧优惠政策衔接等。
- 用户要「查某个政策的全文 / 解读」。
文档根目录（可配置）
默认根目录（按此优先级解析）：
1. 环境变量 STAMP_TAX_ROOT
2. 用户桌面 ~/Desktop/印花税政策文档（~ = C:\Users\<用户名>）
脚本均接受 --root DIR 覆盖。
> 语料（159 篇 docx + 两份 xlsx 清单）在用户桌面目录，不随技能包分发。
> 安装本技能后，请将印花税政策语料（财政部 / 国家税务总局 / 地方法规 三个目录的 .docx，以及 印花税政策清单.xlsx、待补清单.xlsx）整体置于 ~/Desktop/印花税政策文档/，或设置环境变量 STAMP_TAX_ROOT 指向该目录；首次运行 query.py 会自动构建索引。语料不随技能包分发。
首次运行 query.py 时脚本会自动构建索引库（约 1 秒），之后直接复用。发布/分发技能时需提醒使用者自备该目录。
核心脚本
位于 scripts/，用隔离 Python 运行（见下）。两个脚本：
- build_index.py：扫描 docx + 解析「印花税政策清单.xlsx」「待补清单.xlsx」，生成 SQLite FTS5 索引（trigram 中文子串检索）。仅在索引库不存在时自动构建一次，之后 query.py 直接复用。
- query.py：检索接口，子命令 search / list / read / lookup / gaps / stats。
运行环境（重要）
使用受管 Python 与其 venv（已装 python-docx / openpyxl）：
PY="C:/Users/<用户名>/.workbuddy/binaries/python/envs/default/Scripts/python.exe"
SKILL="C:/Users/<用户名>/.workbuddy/skills/stamp-tax-policy"
所有命令在 scripts/ 目录内执行（cd "$SKILL/scripts"），因为 query.py 内部 import build_index。
工作流（请严格按此做检索）
- 先理解用户意图，把口语转成 2~6 字的政策关键词（如「免征印花税」「计税依据」「营业账簿」「产权转移书据」「纳税期限」「证券交易印花税」）。中文检索按子串匹配，关键词越精炼命中越准。
- 检索：
"$PY" query.py search "关键词" --limit 10
可叠加过滤：--source 国家税务总局/--source 财政部/--source 地方法规/--column 政策解读/--level 有效/--after 2024-01-01/--before 2025-12-31。 - 阅读全文（拿到 doc_id 后）：
"$PY" query.py read MOF-0008
返回元数据 + 「涉及印花税要点」+ 正文；引用时务必带上「来源 + 发布日期 + 原文链接」。 - 定位标题：若记得大概标题，用
lookup：
"$PY" query.py lookup "印花税法" - 缺口核查：若检索无果，先查
gaps确认该政策是否本就在「待补清单」（抓取失败未入库）：
"$PY" query.py gaps
若命中缺口，明确告知用户「该政策在本地缺漏清单中（原因为抓取失败），建议按原文链接补全」。
输出纪律
- 先给结论，再给依据：回答印花税问题时，第一句直接说结论；随后列出命中政策的「标题 + 来源 + 发布日期 + 适用要点」，并附原文链接。
- 区分政策文件与政策解读：
栏目=政策解读是官方释义，引用法条以政策法规原文为准，解读仅作理解辅助。 - 效力提示：注意《印花税法》2021-06-10 公布、2022-07-01 施行，原《印花税暂行条例》同时废止；旧公告在其废止前仍可能有效，回答时标注时效性，并以语料中最新有效文件为准。
- 不杜撰：检索无结果且不在 gaps 中时，说明「本地语料未覆盖，建议补充」，不要凭记忆编条文。
- 已知缺口：语料中 6 条政策因抓取失败缺漏（见
待补清单.xlsx），属已知局限，已内置于gaps命令。
关键锚点（语料可直接验证，作答/出题可引用）
- 纳税人：在境内书立应税凭证、进行证券交易的单位和个人；境外书立在境内使用的应税凭证也需缴纳（《印花税法》第一条）。
- 证券交易印花税：对证券交易的出让方征收，不对受让方征收（第三条，语料 MOF-0008 已索引）。
- 计税依据：应税合同 / 产权转移书据的计税依据为所列金额，不包括列明的增值税税款（第五条）。
- 税目税率：合同、产权转移书据、营业账簿、证券交易，依《印花税税目税率表》执行（第四条）。
- 免征范围：应税凭证副本/抄本、涉农买卖合同、无息贴息借款、财产赠与政府/学校/福利机构/慈善组织的产权转移书据、个人与电商经营者订立的电子订单等多类免征（第十二条）。
- 检索时优先用
印花税法/若干事项政策执行口径/改制重组/离岸贸易/高校学生公寓等高频关键词。
统计与维护
- 查看语料概览：
"$PY" query.py stats - 新增/替换 docx 后重建索引：
"$PY" build_index.py --force - 索引库位置：
<skill>/data/stamp_tax.db（由脚本自动生成，不随技能包分发；使用者首次运行自动构建）。
