itr-wala Skill 技能

技能简介（32字） 面向印度个人所得税（AY 2026-27）的确定性税务引擎 CLI 工具，Claude Code 插件形态，支持 ITR-1/2/3/4 全表，双税制定期回归测试覆盖。

核心能力（6条）

1. 确定性 Python 税务引擎：所有 slab、rebate、surcharge、cess、234A/B/C 利息计算由纯 Python 脚本执行，而非 LLM 推理，消除幻觉风险。47 个黄金测试用例覆盖 87A 边际救济、资本利得免税排序、s.71 亏损抵销、各 surcharge 分级（含独有收入测试与 15% 上限）、234A/B/C/F 利息精确到月与 challan 日期。
2. 三层测试防线：47 黄金测试（手算法规格值）+ 104 输入验证测试（拒绝 PAN/Aadhaar 形状字符串等格式错误）+ 35 万次属性模糊测试（fuzz_engine.py 随机边界用例），每次 commit 均触发 CI 完整回归。
3. 自主式 AI 工作流：Skill 读取 Form 16 + AIS JSON → 严格验证数字一致性 → 主动引导扣除项收集（80C/80D/NPS/HRA/房贷）→ 双税制对比计算 → 生成申报数据包（portal 字段映射 + 最终应付/退税金额），用户只需在 portal 输入 AI 告诉你的数字。
4. 双税制智能比较：新旧税制对比表以精确卢比金额呈现，s.115BAC(6) 规则强制提示（逾期申报者锁定旧税制）， regime gap 通常五位数。
5. 全本地隐私保护：Python 脚本 100% 本地运行，税务数据不离开机器；文档处理前主动提示遮蔽 PAN/Aadhaar 账号；validator 以机制（非请求）强制拒绝含敏感字段的输入文件。
6. 广泛收入覆盖：支持多雇主薪资（含退休金豁免）、房产 s.71 亏损抵销、股票/基金资本利得（111A/112A/112，含 grandfathering）、加密货币/VDA、彩票/网络游戏、利息/股息/家庭养老金、预提所得（44AD/ADA）、所有 Chapter VI-A 扣除、新旧 surcharge 与 marginal relief。

安装与配置（3步） 第一步：git clone https://github.com/karanb192/itr-wala.git && cd itr-wala && ./install.sh，install.sh 零网络访问，仅将已审阅的文件复制到本地目录。 第二步（可选作用域限制）：cd ~/tax-2026 && ~/itr-wala/install.sh --here，仅在 Tax 文件夹内启用，避免与项目代码混淆。 第三步（Claude Code 插件模式）：/plugin marketplace add karanb192/itr-wala && /plugin install itr-wala@itr-wala，或 npx skills add karanb192/itr-wala。

使用步骤（4步） 第一步：收集文件——下载 Form 16 PDF 与 AIS JSON（系统会告诉你从哪个政府门户下载具体文件），放入同一文件夹。 第二步：交给 AI——在 Claude Code 中说「file my ITR」并把文件夹丢给 AI，Skill 逐字转录每个数字进入 income.json，严格验证器交叉核验 TDS 与 26AS/AIS 总和。 第三步：核验自测——AI 运行 47 个黄金测试证明数学引擎无误（$ python3 skills/itr-wala/scripts/test_tax_engine.py），任何 CA 都能当场演示测试套件。 第四步：Portal 申报——Skill 生成完整的 filing pack（每个 portal 字段对应值，按顺序排列），你对照输入，AI 旁白引导；AI 永远看不到你的密码或 OTP，只有你能点击 Pay、Submit、e-Verify。

适用场景（3个） 年度税务申报季：印度受雇人员（ salaried employees）每年 ITR 申报，可在 30 分钟内完成从 Form 16/AIS 到最终申报数据包的全流程，无需 CA。 多收入来源自由职业者：拥有股票/MF 资本利得、加密货币收益、HRA/房贷利息等多种收入来源的纳税人，Skill 自动处理跨类别亏损抵销与特殊税率。 安全敏感的 AI 工作流：希望借助 AI 辅助完成税务计算但不愿将财务数据发送给第三方 SaaS 的用户，税务数学完全在本地 Python 执行。

适用人群（103字） 在印度报税季（ITR-1~ITR-4）需要合规申报个人所得税的受雇人员与自由职业者；拥有股票、外汇、加密货币、HRA、房贷等多类收入的纳税人；希望借助 AI 辅助完成从数据收集到税额计算全流程、但要求税务数据完全留本地的隐私敏感用户；以及想要验证 CA 计算结果是否正确的纳税人。

官方链接 GitHub：https://github.com/karanb192/itr-wala