Setup

セットアップウィザード（Setup Wizard）

shinkoku の初回セットアップを対話的に行うスキル。 設定ファイル（shinkoku.config.yaml）の生成とデータベースの初期化を実施する。

ステップ0: CLI のインストール確認

shinkoku コマンドが利用可能か確認する。

1. shinkoku --version を実行する
2. コマンドが存在しない場合: uv tool install git+https://github.com/kazukinagata/shinkoku を実行してインストールする
3. コマンドが存在する場合: uv tool upgrade shinkoku を実行して最新版に更新する

ステップ1: 既存設定の確認

CWD の shinkoku.config.yaml を Read ツールで読み込む。

• ファイルが存在する場合: 内容を表示し、更新するか確認する。更新しない場合はスキルを終了する。
• ファイルが存在しない場合: セットアップウィザードを開始する。

ステップ2: 基本設定のヒアリング

以下の項目を AskUserQuestion で確認する:

2-1. 対象年度

• tax_year: 確定申告の対象年度（デフォルト: 2025）

2-1b. 事業所得の有無

• has_business_income: 事業所得（副業含む）の有無（true / false）

事業所得がない場合、以下のステップをスキップする:

• 2-2（インボイス登録番号）
• 2.6-3（事業所住所）
• 2.7（事業情報）
• 2.8 の申告の種類（blue/white）・記帳方法の質問（給与所得のみなら不要）

2-2. 適格請求書発行事業者の登録番号（事業所得がある場合のみ）

• invoice_registration_number: T + 13桁の番号（任意、スキップ可）

ステップ2.5: 納税者情報のヒアリング

以下の項目を AskUserQuestion で段階的に確認する。すべて任意（スキップ可能）だが、確定申告書等作成コーナーへの入力や人的控除の判定に使用される。

2.5-1. 氏名

• taxpayer.last_name: 姓
• taxpayer.first_name: 名
• taxpayer.last_name_kana: 姓（カタカナ）
• taxpayer.first_name_kana: 名（カタカナ）

2.5-2. 基本情報