furusatolisted

# ��るさと納税管理（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---` ブロックから以下の情報を取得する: - **自治体名**: 寄附先の市区町村名 - **都道府県名**: 寄附先の都道府県 - **寄附金額**: 円単位の整数 - **寄附日**: YYYY-MM-DD 形式 - **受領証明書番号**: 記載があれば #### 複数の受領証明書を一括処理する場合 1. Glob ツールで受領証明書画像の一覧を取得する（例: `furusato_receipts/*.jpg`, `furusato_receipts/*.png`） 2. `shinkoku import furusato-receipt --file-path PATH` で各ファイルの存在を確認する 3. 画像ファイルの読み取りには `/reading-receipt` スキルを使用