itr-wala Skill：让 AI + 确定性税则引擎接管印度个人所得税申报

Skill超级捕获手 技术创作者 2026-08-17 12 阅读

iitr-wala Skill：让 AI + 确定性税则引擎接管印度个人所得税

在 GenAI 应用爆发的大背景下，AI 税务助手不算稀奇——但大多数产品的通病在于：让大语言模型（LLM）直接做算术。印度税法有复杂的 Slab 税率、87A 抵免、Surcharge 分级、234A/B/C 利息规则，模型一旦在边际税率或进位上出错，用户轻则收到税务通知，重则被罚。这正是 itr-wala 出现的原因——把「确定性计算」和「AI 对话」严格分离，前者交给经过 47 个黄金测试用例验证的 Python 引擎，后者交给 Claude Code/Codex/Gemini。

功能与原则

itr-wala 是一个 Claude Code / Codex / Gemini 技能包，用于从终端填写印度个人所得税申报表（ITR）。核心设计原则：AI 做 AI 擅长的事（读文档、问问题、引导用户），确定性代码做它擅长的事（精确算税）。模型永远不碰核心数字，所有金额计算由经过 35 万次模糊测试的 Python 引擎完成，并通过 CI 在每次提交时自动跑 47 个黄金测试。

认可度

  • Star 数：截至 2026-08-17 约 640 ⭐，71 forks
  • 趋势：2026-07-26 才创建，不到一个月 star 增长迅速
  • 更新频率：最近一次更新 2026-08-16（昨日），活跃开发中
  • 来源：GitHub Claude Code Skill 生态，topic 标签为 claude-code-skill

链接

GitHub：https://github.com/karanb192/itr-wala

原作者

karanb192（GitHub 个人开发者）。作者将「AI 税务咨询」和「确定性税务引擎」结合的思路，直接针对当前 AI 税务工具的最大痛点（LLM 算术不可靠）下手。

介绍

印度个人所得税申报是一个典型的高门槛场景：Form 16（薪资证明）、AIS（年度信息报表）、26AS（TDS 对账单）等文档交织，Old Regime 和 New Regime 需要逐项对比，加上 80C/80D/NPS/HRA 等抵扣项，普通纳税人要么花 ₹3,000 找 CA，要么花 3 小时在政府门户上摸索。

itr-wala 将这个流程搬进了终端。用户只需把 Form 16 PDF 和 AIS JSON 文件丢进一个文件夹，对 AI 说一句「file my ITR」，剩下的全由 Skill 自动完成：读文档、转录数据到 income.json、Schema 验证金额一致性、主动询问错漏抵扣项、跑税则引擎算税、比较 Old/New Regime 哪个更划算，最后一步一步引导用户完成政府门户操作。

它支持 ITR-1 到 ITR-4 表格，AY 2026-27 截止日期已内置（ITR-1/2 为 2026 年 7 月 31 日，ITR-3/4 非审计为 2026 年 8 月 31 日）。

特点

  • AI + 确定性引擎分离：税则计算由 Python 完成（47 个黄金测试 + 104 个输入验证测试 + 35 万次模糊测试），LLM 只负责读文档和对话，不碰核心数字
  • 安装安全：提供 install.sh 本地安装脚本，从不触碰网络，用户可先 review 代码再安装
  • 自测机制：在处理真实数据前，引擎先跑自测，用真实申报表中的数字证明自己算对了
  • 输入 Schema 验证：对 income.json 做严格校验，PAN 格式错误、TDS 与 26AS 不匹配等直接拒绝，防止 LLM 幻觉数字进入计算
  • 跨 Regime 对比：自动比较 Old Regime 和 New Regime 税负，给出哪个更划算的结论
  • 支持多表单：ITR-1/2/3/4，覆盖薪资（Form 16）、房产（Home Loan）、股票盈亏（Capital Gains）、加密货币（VDA）等场景

使用方法

基础安装（Claude Code）：

/plugin marketplace add karanb192/itr-wala
/plugin install itr-wala@itr-wala

手动安装：

git clone https://github.com/karanb192/itr-wala.git
cd itr-wala && ./install.sh

使用：
1. 在工作目录准备 Form 16 PDF 和 AIS JSON 文件
2. 打开 Claude Code/Codex，输入 file my ITR
3. AI 自动读取文件、验证、转录、算税，并引导你完成抵扣项补充
4. 自测通过后，AI 一步步带你完成政府门户申报

自测验证：

python3 skills/itr-wala/scripts/test_tax_engine.py
# Ran 47 tests in 0.002s → OK

使用场景与人群

  • 目标用户：居住在印度的个人所得税纳税人，尤其是有 Form 16 的薪资阶层、持有股票或加密货币的投资人、有房产贷款的房东
  • 适用场景：年度税务申报季（每年 4-8 月）、自由职业者结算 TDS、跨 Regime 税务规划
  • 不适用：复杂 Business Income（ITR-3 审计案例）、非印度税务居民

输入与输出案例

案例 1：薪资阶层（Form 16）
– Input：用户提供 Form 16 PDF + AIS JSON，AI 提取 PAN、年收入、TDS 税额、已申报抵扣项
– Output：自动生成 income.json，经 Schema 验证 → 引擎计算 Old/New Regime 税负 → 输出：「New Regime 更划算 ₹12,340，建议选择 New Regime」

案例 2：含房产贷款和股票
– Input：Form 16 + Home Loan Interest 证明 + Broker P&L（加密货币/股票）
– Output：引擎分别计算 HRA 抵扣、Home Loan 利息抵扣（Section 24）、Capital Gains（S.111A/S.112A），输出分项税则表，用户确认后 AI 引导至政府门户完成提交

核心差异：整个过程税则计算由确定性 Python 完成，用户可随时要求 AI「跑自测」确认引擎无误——这是当前所有 Prompt-only 税务工具都无法提供的保障。

GitHub: https://github.com/karanb192/itr-wala

评论区

0 条评论

登录后可评论。

Skill超级捕获手 12 阅读