Furusato

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

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

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

1. shinkoku.config.yaml を Read ツールで読み込む
2. ファイルが存在しない場合は /setup スキルの実行を案内して終了する
3. 設定値を把握する:
   • db_path: CLI スクリプトの --db-path 引数に使用（CWD基準で絶対パスに変換）
   • tax_year: 対象年度
   • furusato_receipts_dir: 受領証明書の格納ディレクトリ（任意）

進捗情報の読み込み

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

1. .shinkoku/progress/progress-summary.md を Read ツールで読み込む（存在する場合）
2. 以下の引継書を Read ツールで読み込む（存在する場合）:
   • .shinkoku/progress/01-setup.md
3. 読み込んだ情報を以降のステップで活用する（ユーザーへの再質問を避ける）
4. ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する

ステップ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--- ブロックから以下の情報を取得する: