ふるさと納税管理（Furusato Nozei Management）

ふるさと納税の寄附金受領証明書を読み取り、寄附データを管理し、控除額を計算するスキル。

設定の読み込み（最初に実行）

shinkoku.config.yaml

を Read ツールで読み込む

ファイルが存在しない場合は

/setup

スキルの実行を案内して終了する

設定値を把握する:

db_path

CLI スクリプトの

--db-path

引数に使用（CWD基準で絶対パスに変換）

tax_year

対象年度

furusato_receipts_dir

受領証明書の格納ディレクトリ（任意）

進捗情報の読み込み

設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。

.shinkoku/progress/progress-summary.md

を Read ツールで読み込む（存在する場合）

以下の引継書を Read ツールで読み込む（存在する場合）:

.shinkoku/progress/01-setup.md

読み込んだ情報を以降のステップで活用する（ユーザーへの再質問を避ける）

ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する

ステップ1: 受領証明書の画像読み取り

1-1. ファイルの確認

import_data.py furusato-receipt --file-path PATH

でファイルの存在を確認する。

1-2. 画像の読み取り

重要: 画像の読み取りは対応する reading-

スキルに委任する。

*

単一の受領証明書の場合

画像ファイルの読み取りには

/reading-receipt

スキルを使用する。

スキルの指示に従い、デュアル検証（2つの独立した読み取り結果の照合）を行って結果を取得する。

結果照合:

両方の読み取り結果から

amount

,

date

,

municipality_name

を比較する

一致の場合:

そのまま採用。「2つの独立した読み取りで結果が一致しました」と報告

不一致の場合:

ユーザーに元画像パスと両方の結果を提示し、正しい方を選択してもらう:

差異のあるフィールドを明示する

A を採用 / B を採用 / 手動入力 の3択を AskUserQuestion で提示する

読み取り結果の

---FURUSATO_RECEIPT_DATA---

ブロックから以下の情報を取得する:

自治体名

寄附先の市区町村名

都道府県名

寄附先の都道府県

寄附金額

円単位の整数

寄附日

YYYY-MM-DD 形式

受領証明書番号

記載があれば

複数の受領証明書を一括処理する場合

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 で提示する

各証明書の結果をまとめてユーザーに提示する

1-3. ユーザーに確認

抽出した情報を一覧表示し、正しいか確認する。修正があればユーザーの入力を反映する。

ステップ2: 寄附データの登録

確認が完了したら

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

}

ワンストップ特例の確認

登録時に「ワンストップ特例を申請しましたか？」と確認する。

重要な注意

副業で確定申告する場合、ワンストップ特例は 無効化 される。 確定申告時に全額を寄附金控除として申告する必要がある。 ステップ3: 複数の証明書を繰り返し処理 「他に受領証明書はありますか？」と確認し、あればステップ1~2を繰り返す。 ステップ4: 集計と控除上限チェック すべての寄附データを登録したら furusato.py summary で集計する。 shinkoku furusato summary --db-path DB --fiscal-year YEAR [ --estimated-limit N ] 表示する情報: 寄附先自治体数と合計金額 所得控除額（合計 - 2,000円） ワンストップ特例申請数 控除上限の推定（所得情報がある場合） 控除上限の推定 所得情報が把握できている場合は tax_calc.py furusato-limit で上限を推定する。 shinkoku tax furusato-limit --input FILE 上限超過の場合は警告を表示: 「寄附合計額が推定上限を超えています。超過分は自己負担となります。」 ステップ5: 確定申告との関係 以下を説明する: 副業で確定申告する場合、ワンストップ特例は使えない 確定申告で寄附金控除（所得控除）として申告する 所得税からの控除 = (寄附合計 - 2,000) x 所得税率 住民税からの控除は別途計算される（特例分含む） リファレンスファイル参照ガイド 質問カテゴリ 参照ファイル ふるさと納税の税制ルール・計算式 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}

ふるさと納税管理の結果

登録済み寄附一覧