furusato

不碰外部（只输出文字）无严重或高危命中kazukinagata/shinkoku

它会碰到什么

扫了多少4 个文本文件，18 KB

它会碰到什么不碰外部（只输出文字）

命中总数0 处

命中统计严重 0 · 高 0 · 中 0 · 低 0

这一栏是扫描器报的事实，不是结论。命中多不等于有毒（安全工具、规则库、示例脚本本来就会包含危险写法），命中少也不等于干净。它和你手上的凭据、文件、网络有什么关系，需要你自己看。

技能内容

ふるさと納税管理（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円）
ワンストップ特例申請数
控除上限の推定（所得情報がある場合）

控除上限の推定

所得情報が把握できている場合は shinkoku tax calc-furusato-limit で上限を推定する。

shinkoku tax calc-furusato-limit --input FILE

推奨（詳細推定）: 所得税と住民税では所得控除額が異なる（基礎控除: 所得税58〜104万 vs 住民税43万等）ため、

住民税側の控除・調整控除を考慮した詳細推定を使う。入力 JSON は calc-deductions と同じ粒度で控除の元データを渡す:

{
  "fiscal_year": 2026,
  "total_income": 4_500_000,
  "social_insurance": 750_000,
  "life_insurance_detail": {"general_new": 80_000},
  "earthquake_insurance_premium": 20_000,
  "medical_expenses": 0,
  "ideco_contribution": 276_000,
  "spouse_income": null,
  "dependents": [
    {"name": "子", "relationship": "子", "birth_date": "2010-04-01", "income": 0}
  ]
}

total_income は総所得金額等（給与所得控除後の給与所得 + 事業所得（青色申告特別控除後）+ 雑所得等）
出力には estimated_limit のほか、住民税課税所得・所得割額・調整控除・特例控除の税率・上限（193万キャップ）の内訳が含まれる
特例控除の所得税率は「住民税課税所得 − 人的控除差 − (所得税の基礎控除 − 48万)」で判定する（地方税法37条の2第2項）。令和8年分は基礎控除104万の影響で所得税率が下がり、上限が令和7年分より小さくなる層がある
住宅ローン控除の住民税控除分は考慮されないため、該当者は結果を少なめに見る

簡易推定（後方互換）: {"total_income": N, "total_income_deductions": M} を渡すと所得税の所得控除合計から逆算する。

所得税の基礎控除の方が大きいため上限を過少に見積もる（令和8年分では1〜2万円程度の差が出る）。

上限超過の場合は警告を表示:

「寄附合計額が推定上限を超えています。超過分は自己負担となります。」

ステップ5: 確定申告との関係

以下を説明する:

副業で確定申告する場合、ワンストップ特例は使えない
確定申告で寄附金控除（所得控除）として申告する
所得税からの控除 = (寄附合計 - 2,000) x 所得税率
住民税からの控除は別途計算される（特例分含む）

令和7年10月以降の制度変更（ユーザーに伝えるべき点）

令和7年10月1日以降、ポータルサイト経由の寄附へのポイント付与は禁止（総務省告示）。クレジットカード自体のポイントは対象外
令和8年10月1日以降の指定から、自治体の「寄附金活用可能額」を寄附額の6割以上とする基準（経過措置: R8.10〜52.5%、R9.10〜55%、R10.10〜57.5%）と地場産品基準の厳格化が適用される。返礼品の内容・還元率が変わる可能性がある
令和9年中以後の寄附（令和10年度分住民税）から、住民税特例控除額に193万円の上限が設けられる（合計所得金額4,000万円超程度の高所得者のみ影響）

リファレンスファイル参照ガイド

| 質問カテゴリ | 参照ファイル |

|-------------|-------------|

| ふるさと納税の税制ルール・計算式 | 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 とし、内容は「該当なし」と記載する。