npx skills add https://github.com/kazukinagata/shinkoku --skill furusato读取ふるさと納税（故乡税）的捐赠收据证明，管理捐赠数据，并计算扣除额的技能。
shinkoku.config.yaml/setup 技能并结束db_path: 用于 CLI 脚本的 --db-path 参数（基于 CWD 转换为绝对路径）tax_year: 目标年度furusato_receipts_dir: 收据证明的存储目录（可选）加载配置后，读取交接文件以了解前一步骤的结果。
.shinkoku/progress/progress-summary.md（如果存在）广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
.shinkoku/progress/01-setup.md使用 import_data.py furusato-receipt --file-path PATH 确认文件是否存在。
重要：图像读取委托给相应的 reading- 技能。*
使用 /reading-receipt 技能读取图像文件。遵循该技能的指示，执行双重验证（比对两个独立的读取结果）以获取结果。
结果比对： 比较两个读取结果的 amount、date、municipality_name
一致的情况： 直接采用。报告“两个独立的读取结果一致”
不一致的情况： 向用户展示原始图像路径和两个结果，请用户选择正确的：
从读取结果的 ---FURUSATO_RECEIPT_DATA--- 块中获取以下信息：
使用 Glob 工具获取收据证明图像列表（例如：furusato_receipts/*.jpg、furusato_receipts/*.png）
使用 shinkoku import furusato-receipt --file-path PATH 确认每个文件的存在
使用 /reading-receipt 技能读取图像文件。遵循该技能的指示，执行双重验证（比对两个独立的读取结果）以获取结果。
结果比对： 按文件比较两个读取结果的 amount、date、municipality_name
一致的情况： 直接采用。报告“两个独立的读取结果一致”
不一致的情况： 对于不一致的文件，向用户展示原始图像路径和两个结果，请用户选择正确的：
* 明确指出存在差异的字段
* 使用 AskUserQuestion 提供三个选项：采用 A / 采用 B / 手动输入
4. 将所有证明的结果汇总展示给用户
将提取的信息以列表形式展示，请用户确认是否正确。如有修正，则根据用户输入进行更新。
确认完成后，使用 furusato.py add 进行注册。
shinkoku furusato add --db-path DB --input FILE
输入 JSON 文件的格式：
{
"fiscal_year": 2025,
"municipality_name": "自治体名",
"amount": 30000,
"date": "2025-06-15",
"municipality_prefecture": "都道府県",
"receipt_number": "受領証明書番号",
"one_stop_applied": false
}
注册时询问“您申请了一站式特例吗？”
重要提示：如果因副业需要进行确定申告，一站式特例将失效。必须在确定申告时将全额作为捐赠扣除进行申报。
询问“还有其他收据证明吗？”，如果有，则重复步骤1~2。
注册完所有捐赠数据后，使用 furusato.py summary 进行汇总。
shinkoku furusato summary --db-path DB --fiscal-year YEAR [--estimated-limit N]
显示的信息：
如果已掌握所得信息，则使用 tax_calc.py furusato-limit 估算上限。
shinkoku tax furusato-limit --input FILE
如果超过上限，则显示警告：“捐赠总额超过了估算上限。超出部分需自行承担。”
说明以下内容：
| 问题类别 | 参考文件 |
|---|---|
| ふるさと納税的税制规则·计算公式 | references/furusato-tax-rules.md |
| 上限额·回礼·时机·咨询等综合问题 | references/furusato-consultation-guide.md |
income-tax 技能继续计算所得税（捐赠扣除将自动反映）展示摘要后，使用 Write 工具输出以下文件。这样，即使会话中断或发生 Compact，也能在下一步骤中继承结果。
以以下格式输出到 .shinkoku/progress/05-furusato.md：
---
step: 5
skill: furusato
status: completed
completed_at: "{当日日期 YYYY-MM-DD}"
fiscal_year: {tax_year}
---
# ふるさと納税管理的结果
## 已注册捐赠列表
| 自治体名 | 都道府県 | 金額 | 寄附日 | ワンストップ |
|---------|---------|------|--------|------------|
| {自治体名} | {都道府県} | {金額}円 | {日期} | {已申请/未申请} |
## 汇总
- 捐赠目的地自治体数: {件数}
- 捐赠总额: {总金额}円
- 扣除额（总计 - 2,000円）: {扣除额}円
## 与扣除上限的比较
- 估算扣除上限: {上限额}円（如果有所得信息）
- 是否超过上限: {无/有（超出额: {金额}円）}
## 下一步
使用 /income-tax 继续计算所得税
如果没有捐赠（跳过），则将 status 设为 skipped，内容记载为“无相关项目”。
更新 .shinkoku/progress/progress-summary.md（如果不存在则新建）：
输出文件后，告知用户以下内容：
.shinkoku/progress/。即使会话中断，也可以在下一个技能中继承结果。”Weekly Installs
237
Repository
GitHub Stars
323
First Seen
Feb 22, 2026
Security Audits
Installed on
codex165
cursor162
opencode159
github-copilot158
gemini-cli155
amp155
ふるさと納税の寄附金受領証明書を読み取り、寄附データを管理し、控除額を計算するスキル。
shinkoku.config.yaml を Read ツールで読み込む/setup スキルの実行を案内して終了するdb_path: CLI スクリプトの --db-path 引数に使用（CWD基準で絶対パスに変換）tax_year: 対象年度furusato_receipts_dir: 受領証明書の格納ディレクトリ（任意）設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。
.shinkoku/progress/progress-summary.md を Read ツールで読み込む（存在する場合）.shinkoku/progress/01-setup.mdimport_data.py furusato-receipt --file-path PATH でファイルの存在を確認する。
重要: 画像の読み取りは対応する reading- スキルに委任する。*
画像ファイルの読み取りには /reading-receipt スキルを使用する。 スキルの指示に従い、デュアル検証（2つの独立した読み取り結果の照合）を行って結果を取得する。
結果照合: 両方の読み取り結果から amount, date, municipality_name を比較する
一致の場合: そのまま採用。「2つの独立した読み取りで結果が一致しました」と報告
不一致の場合: ユーザーに元画像パスと両方の結果を提示し、正しい方を選択してもらう:
読み取り結果の ---FURUSATO_RECEIPT_DATA--- ブロックから以下の情報を取得する:
Glob ツールで受領証明書画像の一覧を取得する（例: furusato_receipts/*.jpg, furusato_receipts/*.png）
shinkoku import furusato-receipt --file-path PATH で各ファイルの存在を確認する
画像ファイルの読み取りには /reading-receipt スキルを使用する。 スキルの指示に従い、デュアル検証（2つの独立した読み取り結果の照合）を行って結果を取得する。
結果照合: ファイル単位で両方の読み取り結果の amount, date, municipality_name を比較する
一致の場合: そのまま採用。「2つの独立した読み取りで結果が一致しました」と報告
不一致の場合: 不一致のファイルについてユーザーに元画像パスと両方の結果を提示し、正しい方を選択してもらう:
* 差異のあるフィールドを明示する
* A を採用 / B を採用 / 手動入力 の3択を AskUserQuestion で提示する
4. 各証明書の結果をまとめてユーザーに提示する
抽出した情報を一覧表示し、正しいか確認する。修正があればユーザーの入力を反映する。
確認が完了したら furusato.py add で登録する。
shinkoku furusato add --db-path DB --input FILE
入力 JSON ファイルのフォーマット:
{
"fiscal_year": 2025,
"municipality_name": "自治体名",
"amount": 30000,
"date": "2025-06-15",
"municipality_prefecture": "都道府県",
"receipt_number": "受領証明書番号",
"one_stop_applied": false
}
登録時に「ワンストップ特例を申請しましたか？」と確認する。
重要な注意 : 副業で確定申告する場合、ワンストップ特例は無効化 される。 確定申告時に全額を寄附金控除として申告する必要がある。
「他に受領証明書はありますか？」と確認し、あればステップ1~2を繰り返す。
すべての寄附データを登録したら furusato.py summary で集計する。
shinkoku furusato summary --db-path DB --fiscal-year YEAR [--estimated-limit N]
表示する情報:
所得情報が把握できている場合は tax_calc.py furusato-limit で上限を推定する。
shinkoku tax furusato-limit --input FILE
上限超過の場合は警告を表示: 「寄附合計額が推定上限を超えています。超過分は自己負担となります。」
以下を説明する:
| 質問カテゴリ | 参照ファイル |
|---|---|
| ふるさと納税の税制ルール・計算式 | references/furusato-tax-rules.md |
| 上限額・返礼品・タイミング・相談全般 | references/furusato-consultation-guide.md |
income-tax スキルで所得税の計算に進む（寄附金控除が自動反映される）サマリー提示後、以下のファイルを Write ツールで出力する。 これにより、セッションの中断や Compact が発生しても次のステップで結果を引き継げる。
.shinkoku/progress/05-furusato.md に以下の形式で出力する:
---
step: 5
skill: furusato
status: completed
completed_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---
# ふるさと納税管理の結果
## 登録済み寄附一覧
| 自治体名 | 都道府県 | 金額 | 寄附日 | ワンストップ |
|---------|---------|------|--------|------------|
| {自治体名} | {都道府県} | {金額}円 | {日付} | {申請済み/未申請} |
## 集計
- 寄附先自治体数: {件数}
- 寄附合計額: {合計金額}円
- 控除額（合計 - 2,000円）: {控除額}円
## 控除上限との比較
- 推定控除上限: {上限額}円（所得情報がある場合）
- 上限超過: {なし/あり（超過額: {金額}円）}
## 次のステップ
/income-tax で所得税の計算に進む
寄附がない場合（スキップ）は status を skipped とし、内容は「該当なし」と記載する。
.shinkoku/progress/progress-summary.md を更新する（存在しない場合は新規作成）:
ファイルを出力したらユーザーに以下を伝える:
.shinkoku/progress/ に保存しました。セッションが中断しても次のスキルで結果を引き継げます。」Weekly Installs
237
Repository
GitHub Stars
323
First Seen
Feb 22, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex165
cursor162
opencode159
github-copilot158
gemini-cli155
amp155
Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程
27,400 周安装
智能媒体下载器 - 一键下载图片视频，支持YouTube剪辑与免费商用素材
436 周安装
Firecrawl 爬虫技能：智能网页抓取、网站爬取与内容提取工具
437 周安装
LobeHub桌面端开发指南：基于Electron的桌面应用架构与功能实现教程
451 周安装
AI API响应测试固件生成指南 - Vercel AI SDK测试工具与最佳实践
448 周安装
安全与合规专家指南：纵深防御、零信任架构、合规框架全流程解析
446 周安装
Spring Boot 3.x OpenAPI 文档生成指南 - SpringDoc集成与Swagger UI配置
453 周安装