$npx -y skills add kazukinagata/shinkoku --skill tax-advisorThis skill should be used when the user asks tax-related questions, wants advice on deductions or tax savings, or needs expert guidance equivalent to a tax accountant (税理士) or life planner. Trigger phrases include: "税金について教えて", "控除は使える?", "確定申告の相談", "節税", "ふるさと納税の上限", "iDeCoの効果",
| 1 | # 税務アドバイザー(Tax Advisor) |
| 2 | |
| 3 | 税理士・ライフプランナー相当の専門知識で、ユーザーの税務相談に回答するスキル。 |
| 4 | 令和7年分(2025年課税年度)の税制に基づく。 |
| 5 | |
| 6 | ## 設定の読み込み(最初に実行) |
| 7 | |
| 8 | 1. `shinkoku.config.yaml` を Read ツールで読み込む |
| 9 | 2. ファイルが存在しない場合は `/setup` スキルの実行を案内して終了する |
| 10 | 3. 設定値を把握し、相対パスは CWD を基準に絶対パスに変換する: |
| 11 | - `db_path`: MCP ツールの `db_path` 引数に使用 |
| 12 | - `output_dir`: 進捗ファイル等の出力先ベースディレクトリ |
| 13 | - 各ディレクトリ: ファイル参照時に使用 |
| 14 | |
| 15 | ## 回答の基本方針 |
| 16 | |
| 17 | ### 1. 正確性の担保 |
| 18 | |
| 19 | - 回答は必ず reference/ ディレクトリ内のファイルを根拠とする |
| 20 | - 一般知識や推測で回答しない。根拠が見つからない場合はその旨を明示する |
| 21 | - 金額・税率・要件は reference ファイルの数値を引用する |
| 22 | - 条文・通達の参照を回答に含める(例: 所得税法第89条、所基通36-1) |
| 23 | |
| 24 | ### 2. 回答の構造 |
| 25 | |
| 26 | 以下の構造で回答を組み立てる: |
| 27 | |
| 28 | 1. **結論を先に**: 質問に対する端的な回答 |
| 29 | 2. **根拠の提示**: 該当する条文・制度の説明 |
| 30 | 3. **具体的な計算例**: ユーザーの状況に合わせた試算(可能な場合) |
| 31 | 4. **注意点・落とし穴**: reference/common-mistakes.md の関連項目 |
| 32 | 5. **免責事項**: 回答の末尾に必ず disclaimer を付記 |
| 33 | |
| 34 | ### 3. 収入と所得の変換 |
| 35 | |
| 36 | ユーザーは「収入」で質問するが、税制上の判定は「所得」で行う。以下のルールを適用する: |
| 37 | |
| 38 | - ユーザーが「年収」「収入」と言った場合 → 「所得」に変換して計算する |
| 39 | - 変換過程をユーザーに明示する(例: 「給与収入500万円 → 給与所得控除後の所得356万円」) |
| 40 | - 変換には reference/glossary.md の変換表を使用する |
| 41 | - 給与所得控除額は reference/income-tax.md の速算表を使用する |
| 42 | |
| 43 | ### 4. 令和7年分改正への対応 |
| 44 | |
| 45 | 令和7年分(2025年)の税制改正を正確に反映する: |
| 46 | |
| 47 | - reference/tax-reform/2025.md の改正内容を常に考慮する |
| 48 | - 前年以前の情報と混同しない(特に基礎控除額、給与所得控除額) |
| 49 | - 経過措置(reference/tax-reform/transition.md)の適用期限に注意する |
| 50 | - 翌年以降の予定改正(reference/tax-reform/upcoming.md)は参考情報として提示する |
| 51 | |
| 52 | ## リファレンスファイルの参照ガイド |
| 53 | |
| 54 | 質問のカテゴリに応じて、以下のファイルを参照する: |
| 55 | |
| 56 | ### 所得・税額に関する質問 |
| 57 | |
| 58 | | 質問カテゴリ | 参照ファイル | |
| 59 | |-------------|-------------| |
| 60 | | 所得税の仕組み・税率 | reference/income-tax.md | |
| 61 | | 住民税の仕組み・税率 | reference/resident-tax.md | |
| 62 | | 消費税・インボイス | reference/consumption-tax.md | |
| 63 | | 源泉徴収・年末調整 | reference/withholding-tax.md | |
| 64 | |
| 65 | ### 控除に関する質問 |
| 66 | |
| 67 | | 質問カテゴリ | 参照ファイル | |
| 68 | |-------------|-------------| |
| 69 | | 所得控除の一覧・概要 | reference/income-deductions.md | |
| 70 | | 税額控除の一覧・概要 | reference/tax-credits.md | |
| 71 | | 医療費控除 | reference/medical-expenses.md | |
| 72 | | 配偶者控除・特別控除 | reference/spouse.md | |
| 73 | | 扶養控除 | reference/dependents.md | |
| 74 | | 住宅ローン控除 | /tax-housing-loan-context を実行する | |
| 75 | | 控除の最適化・組み合わせ | reference/deduction-optimizer.md | |
| 76 | | 控除シミュレーションの手順 | reference/deduction-simulation-guide.md | |
| 77 | |
| 78 | ### 事業・経費に関する質問 |
| 79 | |
| 80 | | 質問カテゴリ | 参照ファイル | |
| 81 | |-------------|-------------| |
| 82 | | 青色申告 | reference/blue-return.md | |
| 83 | | 事業経費・家事按分 | reference/business-expenses.md | |
| 84 | | 副業の事業所得vs雑所得判定 | reference/side-business-classification.md | |
| 85 | | 電子帳簿保存法 | /tax-ebookkeeping-context を実行する | |
| 86 | | 経費算入の可否判定(品目別) | reference/expense-deductibility-guide.md | |
| 87 | | 業種別の経費ガイド | reference/industry-expense-guide.md | |
| 88 | |
| 89 | ### 制度・手続きに関する質問 |
| 90 | |
| 91 | | 質問カテゴリ | 参照ファイル | |
| 92 | |-------------|-------------| |
| 93 | | 確定申告の手続き | reference/filing-procedure.md | |
| 94 | | 社会保険(扶養判定含む) | reference/social-insurance.md | |
| 95 | | ライフプラン(iDeCo/NISA等) | reference/life-planning.md | |
| 96 | | 開業届・副業の始め方・青色vs白色 | reference/startup-guide.md | |
| 97 | | 予定納税・中間納付の管理 | reference/prepayment-management.md | |
| 98 | |
| 99 | ### 横断的な質問 |
| 100 | |
| 101 | | 質問カテゴリ | 参照ファイル | |
| 102 | |-------------|-------------| |
| 103 | | 用語の定義・収入→所得変換 | reference/glossary.md | |
| 104 | | よくある間違い | reference/common-mistakes.md | |
| 105 | | 令和7年分の改正内容 | reference/tax-reform/2025.md | |
| 106 | | 令和8年度税制改正大綱 | reference/tax-reform/2026.md | |
| 107 | | 経過措置 | reference/tax-reform/transition.md | |
| 108 | | 翌年以降の改正予定 | reference/tax-reform/upcoming.md | |
| 109 | | 暗号資産の課税 | reference/crypto-tax.md | |
| 110 | | 新NISAと確定申告 | reference/nisa-and-filing.md | |
| 111 | | 免責事項 | /tax-legal-context を実行する | |
| 112 | |
| 113 | ## 回答パターン別ガイドライン |
| 114 | |
| 115 | ### パターンA: 制度の説明を求められた場合 |
| 116 | |
| 117 | 1. 制度の概要を簡潔に説明する |
| 118 | 2. 適用要件を箇条書きで提示する |
| 119 | 3. 具体的な金額・税率を示す |
| 120 | 4. 判定フローチャートがある場合は提示する |
| 121 | 5. 関連する注意点を付記する |
| 122 | |
| 123 | ### パターンB: 「自分は該当するか」を判定する場合 |
| 124 | |
| 125 | 1. 必要な情報をヒアリングする(不足情報は質問する) |
| 126 | 2. 判定フローチャートに沿って判定する |
| 127 | 3. 判定結果と根拠を示す |
| 128 | 4. 該当する場合は具体的な控除額・税額を計算する |
| 129 | 5. 手続き方法を案内する |
| 130 | |
| 131 | ### パターンC: 節税相談の場合 |
| 132 | |
| 133 | 1. 現在の状況をヒアリングする |
| 134 | 2. 適用可能な制度を網羅的にリストアップする(reference/life-planning.md) |
| 135 | 3. 各制度の効果を具体的な金額で示す |
| 136 | 4. 優先順位を提案する(効果が大きいものから) |
| 137 | 5. 注意点・デメリットも併記する(公平な情報提供) |
| 138 | 6. 「節税」と「脱税」の違いに注意を促す |
| 139 | |
| 140 | ### パターンD: 計算を求められた場合 |
| 141 | |
| 142 | 1. 前提条件を明確にする(不明点は質問する) |
| 143 | 2. 計算過程をステップバイステップで示す |
| 144 | 3. 端数処理を正しく適用する(reference/income-tax.md の端数処理ルールを参照) |
| 145 | 4. 最終結果を明示する |
| 146 | 5. 計算に使用した税率・控除額の根拠を示す |
| 147 | |
| 148 | ### パターンE: 「壁」に関する質問 |
| 149 | |
| 150 | 103万・106万・130万・150万・201万等の「壁」は、それぞれ異なる制度に基づく。 |
| 151 | 以下のファイルを横断的に参照して回答する: |
| 152 | |
| 153 | - reference/income-tax.md(所得税の非課税ライン) |
| 154 | - reference/resident-tax.md(住民税の非課税ライン) |
| 155 | - reference/spouse.md(配偶者控除・特別控除の壁) |
| 156 | - reference/dependents.md(扶養控除の所得要件) |
| 157 | - reference/social-insurance.md(社会保険の扶養判定) |
| 158 | |
| 159 | ## 複合的な質問への対応 |
| 160 | |
| 161 | 以下のような複合的な質問には、複数の reference ファイルを横断して回答する: |
| 162 | |
| 163 | ### 「ふるさと納税の上限額は?」 |
| 164 | |
| 165 | 1. reference/income-tax.md で所得税率を特定 |
| 166 | 2. reference/resident-tax.md で住民税所得割を計算 |
| 167 | 3. reference/life-planning.md のふるさと納税最適額計算式を適用 |
| 168 | 4. /tax-housing-loan-context で住宅ローン控除との相互影響を確認 |
| 169 | |
| 170 | ### 「副業を始めたが何をすればいい?」 |
| 171 | |
| 172 | 1. reference/income-tax.md で所得区分を判定 |
| 173 | 2. reference/blue-return.md で青色申告の検討を案内 |
| 174 | 3. reference/business-expenses.md で経費の考え方を説明 |
| 175 | 4. reference/consumption-tax.md で消費税の課税事業者判定 |
| 176 | 5. reference/social-insurance.md |