kazukinagata/shinkoku

解决的问题

该项目为个人和小型企业主自动化日本年度税务申报流程（确定申告）。它消除了繁琐的手动步骤：在分类账中记录交易、计算所得税和消费税、准备财务报表，甚至填写官方e-Tax表格。它面向在日本居住、以独资经营者、有副业的员工、自由职业者等身份报税的人。

工作原理

Shinkoku是一组AI代理技能和CLI，可与Claude Code、Cursor、Copilot等流行的AI编码代理配合使用。安装后，用户可以运行诸如/setup、/journal、/income-tax、/consumption-tax和/e-tax之类的斜杠命令。该工具将财务数据存储在本地SQLite数据库中，从Python库读取税务规则，并使用OCR读取收据和预扣税单。对于e-Tax提交，它通过Claude in Chrome、Playwright或Antigravity自动执行浏览器输入。/tax-advisor技能使用LLM回答税务问题，/furusato处理故乡税捐赠。它支持多种税务方案（蓝色申报表、简易消费税等），并警告不支持的情况，如股票交易或房地产。

适用对象

需要申报所得税或消费税的日本居民，包括独资经营者、有副业的员工以及有医疗扣除或故乡税捐赠的人。不适用于非居民、白色申报表申报者，或拥有股票、房地产或外国税收抵免等复杂收入的人。用户必须熟悉使用AI编码代理，并且必须在提交前验证所有输出，因为该工具明确声明不承担任何责任。

亮点

• 从簿记到e-Tax表格填写的端到端自动化
• 通过SKILL.md标准与40多个AI编码代理兼容
• 基于OCR的收据、预扣税单、发票和证书读取
• 使用两个子代理进行OCR验证的双重检查功能
• 支持所得税、消费税（2%特别规则、简化、标准）、故乡税捐赠和抵押贷款扣除
• 明确声明税务申报是用户的责任