$npx -y skills add kazukinagata/shinkoku --skill assessThis skill should be used when the user asks to determine what tax filings they need, wants to know if they must file a tax return (確定申告), asks about consumption tax obligations (消費税), or needs help understanding their filing requirements. Trigger phrases include: "確定申告が必要か", "申告
| 1 | # 申告要否・種類の判定(Tax Filing Assessment) |
| 2 | |
| 3 | 確定申告が必要かどうか、どの種類の申告が必要かを対話的に判定するスキル。 |
| 4 | ユーザーの収入状況・家族構成・事業状況をヒアリングし、必要な申告を特定する。 |
| 5 | |
| 6 | ## 設定の読み込み(最初に実行) |
| 7 | |
| 8 | 1. `shinkoku.config.yaml` を Read ツールで読み込む |
| 9 | 2. ファイルが存在しない場合は `/setup` スキルの実行を案内して終了する |
| 10 | 3. 設定値を把握し、相対パスは CWD を基準に絶対パスに変換する: |
| 11 | - `db_path`: CLI スクリプトの `--db-path` 引数に使用 |
| 12 | - `output_dir`: 進捗ファイル等の出力先ベースディレクトリ |
| 13 | - 各ディレクトリ: ファイル参照時に使用 |
| 14 | |
| 15 | ## 進捗情報の読み込み |
| 16 | |
| 17 | 設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。 |
| 18 | |
| 19 | 1. `.shinkoku/progress/progress-summary.md` を Read ツールで読み込む(存在する場合) |
| 20 | 2. 以下の引継書を Read ツールで読み込む(存在する場合): |
| 21 | - `.shinkoku/progress/01-setup.md` |
| 22 | 3. 読み込んだ情報を以降のステップで活用する(ユーザーへの再質問を避ける) |
| 23 | 4. ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する |
| 24 | |
| 25 | ## 判定の基本方針 |
| 26 | |
| 27 | - ユーザーが「収入」で話す場合、内部的に「所得」に変換して判定を行う |
| 28 | - 判定は所得税 → 消費税 → 住民税の順序で実施する |
| 29 | - 各判定で根拠となる条文・通達を示す |
| 30 | - 判定結果は最後にサマリーとして一覧提示する |
| 31 | - 不明な点がある場合は追加質問で確認する(推測で判定しない) |
| 32 | |
| 33 | ### ヒアリング時の質問設計ルール |
| 34 | |
| 35 | - チェックリストの項目は**すべて漏れなく確認する**こと。ツールの選択肢数制限(AskUserQuestionは1問あたり最大4選択肢)のために項目を省略してはならない。項目数が多い場合は**複数回に分けて**確認する |
| 36 | - 1つの事象に複数の側面がある場合(例: 中古住宅を購入してリフォームも実施)は、**複数選択可能(multiSelect: true)**にするか、組み合わせパターンを選択肢に含める |
| 37 | - 選択肢を設計する前に、その項目が**排他的(1つだけ選ぶ)か並立的(複数該当しうる)か**を判断する |
| 38 | |
| 39 | ## ステップ1: 基本情報ヒアリング |
| 40 | |
| 41 | 以下の情報を対話で収集する。一度にすべてを聞かず、自然な会話の流れで段階的に確認する。 |
| 42 | |
| 43 | ### 1-0. 前年の確定申告の確認 |
| 44 | |
| 45 | 事業所得がある場合(開業2年目以降)、前年の確定申告内容を確認する。 |
| 46 | config の `past_returns_dir` にファイルがあれば参照する。 |
| 47 | |
| 48 | #### 確認項目 |
| 49 | |
| 50 | - [ ] 前年の確定申告書(第一表)の有無 |
| 51 | - [ ] 前年の事業所得金額(黒字 or 赤字) |
| 52 | - [ ] 前年の申告納税額(㊺欄)— 15万円を超えていたか |
| 53 | - [ ] 予定納税の有無と納付済み金額(第1期・第2期) |
| 54 | - [ ] 純損失の繰越控除の有無(前年以前に青色申告で赤字を出したか) |
| 55 | - [ ] 前年の消費税の課税売上高(基準期間の判定に使用) |
| 56 | |
| 57 | #### 予定納税の判定ルール(所得税法第104条) |
| 58 | |
| 59 | 前年の申告納税額(㊺欄)が **15万円以上** の場合: |
| 60 | - 第1期(7月): 前年納税額の1/3 |
| 61 | - 第2期(11月): 前年納税額の1/3 |
| 62 | - 残りは確定申告で精算 |
| 63 | |
| 64 | 予定納税を納付済みの場合、確定申告書 ㊹欄「源泉徴収税額」に加算する。 |
| 65 | |
| 66 | #### 純損失の繰越控除(所得税法第70条) |
| 67 | |
| 68 | 前年以前3年以内に青色申告で純損失がある場合: |
| 69 | - 繰越控除可能額を確認する |
| 70 | - 当年の所得から控除できる |
| 71 | |
| 72 | ### 1-1. 給与収入の確認 |
| 73 | |
| 74 | - 給与収入の有無と概算金額 |
| 75 | - 給与の支払元の数(1か所 or 複数) |
| 76 | - 年末調整の実施有無 |
| 77 | - 源泉徴収票の有無 |
| 78 | |
| 79 | ### 1-2. 給与以外の収入の確認 |
| 80 | |
| 81 | 以下の収入の有無を**すべて**順に確認する(項目数が多い場合は複数回に分けること): |
| 82 | |
| 83 | - 事業収入(副業・フリーランス)→ 概算金額、開業届の有無、青色申告承認の有無 |
| 84 | - 不動産収入 |
| 85 | - 株式・配当収入(特定口座/一般口座/NISA)→ 1-2a で詳細確認 |
| 86 | - 雑所得(暗号資産、FX、年金等)→ 1-2b, 1-2c で詳細確認 |
| 87 | - 一時所得(保険満期金、懸賞金等) |
| 88 | - 譲渡所得(不動産売却、ゴルフ会員権等) |
| 89 | - 退職所得 |
| 90 | |
| 91 | ### 1-2a. 株式取引の詳細確認(該当者のみ) |
| 92 | |
| 93 | 株式・配当収入がある場合、以下を確認する: |
| 94 | |
| 95 | 1. **口座の種類**: |
| 96 | - 特定口座(源泉徴収あり): 確定申告は任意。ただし損益通算・繰越損失には申告が必要 |
| 97 | - 特定口座(源泉徴収なし): 確定申告が必要 |
| 98 | - 一般口座: 確定申告が必要 |
| 99 | - NISA口座: 非課税。申告不要 |
| 100 | 2. **配当の課税方式の選択**: |
| 101 | - 総合課税: 配当控除が使える(課税所得695万以下なら有利な場合が多い) |
| 102 | - 分離課税: 株式譲渡損との損益通算が可能 |
| 103 | - 申告不要: 特定口座(源泉あり)の場合のみ選択可能 |
| 104 | 3. **損益通算の確認**: |
| 105 | - 株式譲渡損と分離課税選択の配当を通算可能 |
| 106 | - 前年以前の繰越損失(最大3年)の適用可否 |
| 107 | 4. **概算金額**: 年間の譲渡益/損、配当金額、源泉徴収済み税額 |
| 108 | |
| 109 | ### 1-2b. FX取引の詳細確認(該当者のみ) |
| 110 | |
| 111 | FX取引がある場合、以下を確認する: |
| 112 | |
| 113 | 1. **取引の種類**: 店頭FX / 取引所FX(いずれも分離課税) |
| 114 | 2. **年間の損益**: 実現損益 + スワップ収入 - 取引手数料等 |
| 115 | 3. **繰越損失**: 前年以前の繰越損失(最大3年)の有無 |
| 116 | 4. **注意**: FXの損益は株式とは通算不可(別プール) |
| 117 | |
| 118 | ### 1-2c. 仮想通貨(暗号資産)の詳細確認(該当者のみ) |
| 119 | |
| 120 | 暗号資産の取引がある場合、以下を確認する: |
| 121 | |
| 122 | 1. **取引の種類**: 売却、交換、決済利用、マイニング等 |
| 123 | 2. **年間の損益**: 総平均法または移動平均法で計算 |
| 124 | 3. **課税区分**: 雑所得(総合課税)として申告 |
| 125 | 4. **注意**: 暗号資産の損失は他の所得と通算不可(雑所得内でのみ通算可) |
| 126 | |
| 127 | ### 1-3. 控除関連の確認 |
| 128 | |
| 129 | 以下の項目を**すべて**確認する。項目数が多いため、2回に分けて確認すること。 |
| 130 | |
| 131 | #### グループA: 大型控除(確定申告の要否に直結する項目) |
| 132 | |
| 133 | - 住宅ローン控除(初年度 or 2年目以降)★申告要否に影響 |
| 134 | - 医療費の支払い(10万円超の目安) |
| 135 | - ふるさと納税の有無と金額(ワンストップ特例の利用状況) |
| 136 | |
| 137 | #### グループB: その他の控除 |
| 138 | |
| 139 | - iDeCo・小規模企業共済の加入 |
| 140 | - 生命保険・地震保険の加入 |
| 141 | - 扶養家族の有無 |
| 142 | |
| 143 | ### 1-4. 住宅取得の詳細確認(住宅ローン控除が該当する場合) |
| 144 | |
| 145 | 住宅の取得・リフォームが判明した場合、以下を追加で確認する。 |
| 146 | |
| 147 | #### 取得の種類(複数該当しうるため、multiSelectで確認する) |
| 148 | |
| 149 | - 新築住宅の取得 |
| 150 | - 中古住宅(既存住宅)の取得 |
| 151 | - 増改築・リフォーム |
| 152 | |
| 153 | ※「中古住宅を購入してリフォームも実施」はよくあるパターンのため、必ず複数選択を許可すること。 |
| 154 | 中古取得+リフォームの場合、それぞれで住宅ローン控除の借入限度額が異なる可能性がある。 |
| 155 | |
| 156 | #### 確認すべき詳細情報 |
| 157 | |
| 158 | - 取得価格(土地・建物の内訳がわかれば) |
| 159 | - リフォーム費用(該当する場合) |
| 160 | - 住宅ローンの有無と年末残高の見込み |
| 161 | - 入居日(取得後6か月以内に入居したか) |
| 162 | - 床面積(50㎡以上か。所得1,000万円以下なら40㎡以上) |
| 163 | - 中古の場合: 建築年(昭和57年/1982年以降か = 新耐震基準) |
| 164 | - 省エネ性能区分(認定長期優良住宅・ZEH・省エネ基準適合・その他) |
| 165 | |
| 166 | → 詳細な控除額の判定は /tax-housing-loan-context を実行する |
| 167 | |
| 168 | ### ヒアリング完了チェックリスト |
| 169 | |
| 170 | **ステップ2の判定に進む前に、以下のすべてを確認済みであること。未確認の項目があればユーザーに追加質問する。** |
| 171 | |
| 172 | #### 収入関連 |
| 173 | - [ ] 給与収入の有無・金額・支払元の数 |
| 174 | - [ ] 年末調整の実施有無 |
| 175 | - [ ] 事業収入(副業・フリーランス)の有無 |
| 176 | - [ ] 不動産収入の有無 |
| 177 | - [ ] 株式・配当収入の有無 |
| 178 | - [ ] 雑所得(暗号資産・FX・年金等)の有無 |
| 179 | - [ ] 一時所得の有無 |
| 180 | - [ ] 譲渡所得の有無 |
| 181 | - [ ] 退職所得の有無 |
| 182 | |
| 183 | #### 控除関連 |
| 184 | - [ ] 住宅ローン控除の該当有無(初年度 or 2年目以降) |
| 185 | - [ ] 医療費の支払い状況 |
| 186 | - [ ] ふるさと納税の有無 |
| 187 | - [ ] iDeCo・小規模企業共済の加入有無 |
| 188 | - [ ] 生命保険・地震保険の加入有無 |
| 189 | - [ ] 扶養家族の有無 |
| 190 | |
| 191 | #### 前年確定申告関連 |
| 192 | - [ ] 前年の申告納税額(予定納税の要否判定) |
| 193 | - [ ] 予定納税の有無・納付済み金額 |
| 194 | - [ ] 純損失の繰越の有無 |
| 195 | |
| 196 | ## ステップ2: 所得税の確定申告の要否判定 |
| 197 | |
| 198 | 収集した情報に基づき、以下のフローチャートで判定する。 |
| 199 | |
| 200 | ### 判定フローチャート: 確定申告が必要なケース |
| 201 | |
| 202 | ``` |
| 203 | Q1. 給与所得者ですか? |
| 204 | ├── Yes → Q2へ |
| 205 | └── No → Q5へ |
| 206 | |
| 207 | Q2. 給与収入は2,000万円を超えますか? |
| 208 | ├── Yes → 【確定申告必要】(所得税法第121条第1項) |
| 209 | └── No → Q3へ |
| 210 | |
| 211 | Q3. 給与を2か所以上から受けていますか? |
| 212 | ├── Yes → 主たる給与以外の収入が20万円を超えるか確認 → Q4へ |
| 213 | └── No → Q4へ |
| 214 | |
| 215 | Q4. 給与所得・退職所得以外の所得が20万円を超えますか? |
| 216 | ├── Yes → 【確定申告必要】(所得税法第121条第1項第2号) |
| 217 | └── No → Q6へ |
| 218 | |
| 219 | Q5. 事業所得・不動産所得等がありますか? |
| 220 | ├── Yes → 所得金額が基礎控除+所得控除の合計を超えるか? |
| 221 | │ ├── Yes → 【確定申告必要】 |
| 222 | │ └── No → 【確定申告不要】(ただし損失繰越のために申告する場合あり) |
| 223 | └── No → 各所得の合計で判定 |
| 224 | |
| 225 | Q6. 以下のいずれかに該当しますか? |
| 226 | - 医療費控除を受けたい |
| 227 | - ふるさと納税でワンストップ特例を使わない/使えない |
| 228 | - 住宅ローン控除の初年度 |
| 229 | - 雑損控除を受けたい |
| 230 | - 年末調整で申告漏れした控除がある |
| 231 | ├── Yes → 【確定申告した方が有利(還付申告)】 |
| 232 | └── No → 【 |