1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | itr-wala |
| 作者/维护者 | Karan Bansal（karanb192） |
| 来源链接 | https://github.com/karanb192/itr-wala |
| 许可证 | MIT（GitHub API 与仓库 LICENSE 文件均确认） |
| GitHub Stars/Forks | 449 ★ / 52 forks（GitHub API 获取） |
| 最新版本 | 未打版本标签，以最新 main 分支提交为准 |
| 安装方式 | Claude Code 插件市场 / 通用 curl 安装脚本（支持 Claude Code、Codex CLI、Gemini CLI） |
2. 功能介绍与亮点
itr-wala 帮用户在终端里准备并申报印度个人所得税（ITR，FY 2025-26 / AY 2026-27），核心设计是把“AI 读文档”和“代码算税”严格分开：
- 确定性税务引擎：所有税额、利息、滞纳金、两种税制（新/旧）比较，全部由本地 Python 脚本计算，配 47 项手工推导的黄金测试、104 项输入校验测试，以及一个跑过 35 万次以上随机化场景的属性测试模糊器（fuzzer），CI 在每次提交时都会重跑。AI 只负责读取 Form 16、AIS、经纪商结单等文档并转录数字，不参与任何税务算术。
- 交叉校验与来源留痕：每个提取出的数字都要求记录来源文档与字段位置，并与 26AS/AIS 等独立文档互相核对；校验器会拒绝含 PAN、Aadhaar 形态字符串的输入文件，降低敏感信息误存风险。
- 覆盖面：多份工资单、房产收入（含亏损结转）、股票与基金资本利得（含分级豁免规则）、加密货币/VDA、彩票与网络游戏奖金、利息股息、家庭养老金、第 89 条追溯救济、推定收入、全部第六甲章扣除项、附带边际减免的附加税、精确到实际缴款日的预缴税利息、逾期申报规则；遇到非居民、期货期权交易、审计案例等超出范围的情形会明确告知用户改找注册会计师，而不是模糊估算。
- 不越权：明确不索取门户密码或一次性密码，“缴费”“提交”“电子核验”三个关键动作始终由用户本人在官方门户上点击完成。
3. 适用场景
所属分类：文档与办公自动化
适用于需要自行申报印度个人所得税的居民纳税人：整理 Form 16、AIS、26AS、经纪商结单等原始文件后，由该技能完成信息提取、新旧税制对比、扣除项梳理，产出一份可直接对照政府门户逐字段填报的申报材料包，免去雇佣会计师或在门户上手工核对的时间成本。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——提供插件市场安装（
/plugin marketplace add+/plugin install）与普通 skill 安装两种路径，官方推荐插件市场方式以便后续更新。 - Codex：✅ 原生支持——安装脚本提供
-s codex选项，同时装入~/.agents/skills（跨 Agent 通用位置）与~/.codex/skills（Codex 原生位置）。 - OpenClaw：❓ 未验证——已抓取材料未提及该平台，未做兼容性判断。
- Hermes Agent：❓ 未验证——同上；但 SKILL.md 遵循通用 Agent Skills 规范（YAML front matter + 指令正文），理论上可手动迁移安装。
5. 推荐理由
市面上不少“AI 报税”演示都让大模型直接做税务算术，这恰恰是 LLM 最不可靠的环节。itr-wala 把边界划得很清楚：AI 只做它擅长的（读文档、问遗漏的扣除项、讲解规则），税额计算全部交给经过大规模测试的确定性 Python 引擎，且从不触碰密码或代替用户点击提交。作者本人是应用安全领域的从业者（DEFCON/OWASP 讲者），项目测试覆盖度与文档透明度都明显高于同类工具。对居住在印度、需要自行申报所得税的 Claude Code/Codex 用户来说，这是一个能显著降低“算错税”风险、且完全免费开源的实用工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 449 stars / 52 forks，仓库创建仅约两周即达到该量级，增长速度明显；作者是个人开发者而非厂商或机构，同时维护另一个 50+ 条目的 awesome-claude-skills 收录列表，在 Claude Skills 社区有既有影响力 |
| 可用性 | 9 | 一条命令即可装进 Claude Code / Codex / Gemini 三种 Agent；文档详尽且含真实运行示例；零第三方依赖（仅用 Python 标准库）；自带自检脚本，CI 对每次提交自动跑测试套件 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 项目 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅在用户本机运行随包附带的 Python 脚本（税务计算、输入校验、自检），不执行任意外部命令 |
| ② 运行时联网外发 | 税务计算全程本地完成、不联网；用户主动交给 AI 模型阅读的文档内容会按常规 AI 对话方式离开本机，SKILL.md 对此有明确提示 |
| ③ API Key/凭据 | 明确规定绝不索取、读取或存储门户密码、一次性密码、PAN 关联登录信息或银行信息；校验器会主动拒绝含 PAN/Aadhaar 形态字符串的输入文件 |
| ④ 可疑指令迹象 | 未发现 prompt injection 或混淆代码迹象，指令内容与其自述功能一致 |
| ⑤ 作者信誉 | 作者具名、履历可查（应用安全行业从业者，DEFCON/OWASP 讲者），另维护有一定影响力的开源项目，未见刷星或自我造假迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 仓库创建于 2026-07-26，处于活跃发布初期，README 明确写出后续路线图（Windows 原生支持、离线上传 JSON 等） |
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| file-itr（shivprime94） | 已知最早的印度 ITR 申报类 skill，提供了门户字段与 AIS SFT 代码方面的先驱性研究 | 以提示词引导为主，税务计算依赖模型判断而非独立测试的确定性引擎 |
| itr-prep-skill（NidheeshJain） | 同样解析 Form 16/AIS/26AS/经纪商结单，产出可供浏览器 Agent 申报用的数据包 | 定位偏向“数据包生成 + 浏览器自动化申报”一体化流程，itr-wala 更强调计算引擎本身的测试覆盖与人工复核环节，不涉及自动化提交 |
itr-wala 的差异化在于把税务算术彻底移出模型职责范围，用可复现的测试套件（黄金测试 + 校验器测试 + 模糊测试）为每一版税率变更提供回归保护，这是同类“提示词驱动”报税技能普遍缺失的一层保障。
8. 用户评价
该技能目前在第三方平台尚无独立于其自身仓库之外的具名用户评价；可查到的是作者本人在 README 中公开的真实使用声明（本人用它申报自己的税），以及同一生态内另一款报税技能（itr-prep-skill）的存在，间接说明该细分场景已有多方独立尝试。
9. 安装使用方式
Claude Code（推荐，随插件市场更新）：
/plugin marketplace add karanb192/itr-wala
/plugin install itr-wala@itr-wala通用安装脚本（Claude Code / Codex CLI / Gemini CLI）：
curl -fsSL https://raw.githubusercontent.com/karanb192/itr-wala/main/install.sh | bash # Claude Code
curl -fsSL https://raw.githubusercontent.com/karanb192/itr-wala/main/install.sh | bash -s codex # Codex CLI
curl -fsSL https://raw.githubusercontent.com/karanb192/itr-wala/main/install.sh | bash -s gemini # Gemini CLI安装完成后重启 CLI，对 Agent 说“file my ITR”（Claude Code 也可用 /itr-wala，Codex 用 $itr-wala）即可开始。首次运行会先执行自检脚本，确认税务引擎测试全部通过后才会继续。需要 Python 3.9 及以上版本（仅标准库，无需额外安装依赖包）；macOS 与 Linux 原生支持，Windows 需通过 WSL 使用。
10. 注意事项
- 仅覆盖印度居民个人纳税人 FY 2025-26（AY 2026-27）这一个纳税年度，非居民、期货期权交易者、需做税务审计的用户及其他复杂情形不在覆盖范围内，技能会明确提示并建议咨询注册会计师，不会强行给出近似结果。
- 该技能不会代替用户完成“缴费”“提交”“电子核验”这三个操作，用户仍需亲自登录官方门户完成最后步骤。
- Windows 用户需通过 WSL 运行，官方原生 Windows 安装器仍在路线图中、尚未发布。
- 仓库上线时间较短（约两周），长期维护稳定性有待观察；作者已在 README 中说明每次财政法案变更都需要对应更新税率常量与测试。