OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add kazukinagata/shinkoku --skill setup
This skill should be used when the user wants to set up shinkoku for the first time, initialize their configuration, or update their existing settings. Trigger phrases include: "セットアップ", "初期設定", "設定ファイルを作る", "shinkokuの設定", "config", "setup", "始め方", "使い方", "設定を更新", "configを作り直す".
npx skills add kazukinagata/shinkoku --skill setup
shinkoku の初回セットアップを対話的に行うスキル。
設定ファイル（shinkoku.config.yaml）の生成とデータベースの初期化を実施する。
shinkoku コマンドが利用可能か確認する。
shinkoku --version を実行するuv tool install git+https://github.com/kazukinagata/shinkoku を実行してインストールするuv tool upgrade shinkoku を実行して最新版に更新するCWD の shinkoku.config.yaml を Read ツールで読み込む。
以下の項目を AskUserQuestion で確認する:
tax_year: 確定申告の対象年度（デフォルト: 2025）has_business_income: 事業所得（副業含む）の有無（true / false）事業所得がない場合、以下のステップをスキップする:
invoice_registration_number: T + 13桁の番号（任意、スキップ可）以下の項目を AskUserQuestion で段階的に確認する。すべて任意（スキップ可能）だが、確定申告書等作成コーナーへの入力や人的控除の判定に使用される。
taxpayer.last_name: 姓taxpayer.first_name: 名taxpayer.last_name_kana: 姓（カタカナ）taxpayer.first_name_kana: 名（カタカナ）taxpayer.gender: 性別（male / female）taxpayer.date_of_birth: 生年月日（YYYY-MM-DD）taxpayer.phone: 電話番号taxpayer.relationship_to_head: 世帯主との続柄（本人/妻/夫/子等）taxpayer.my_number: マイナンバー12桁（取扱注意 — config に保存するが、ツール出力やログには一切表示しない）taxpayer.widow_status: 寡婦/ひとり親の区分（none / widow / single_parent）taxpayer.disability_status: 障害者の区分（none / general / special）taxpayer.working_student: 勤労学生に該当するか（true / false）address.postal_code: 郵便番号address.prefecture: 都道府県address.city: 市区町村address.street: 番地address.building: 建物名・部屋番号（任意）address.jan1_address: 1/1 時点の住所（住民税の課税自治体判定に使用）business_address.postal_code 〜 business_address.building事業所得がある場合に確認する。
business.trade_name: 屋号business.industry_type: 業種business.business_description: 事業内容business.establishment_year: 開業年以下の項目を順に確認し、青色申告特別控除額を自動判定する。
filing.submission_method: 提出方法（e-tax / mail / in-person）
このプラグインの帳簿管理・税額計算機能はご利用いただけますが、確定申告書等作成コーナーへの自動入力（
/e-taxスキル）は e-Tax 提出専用のため利用できません。作成コーナーへの入力はご自身で行っていただく必要があります。
filing.return_type: 申告の種類（blue / white）— 事業所得がある場合のみ質問する（事業所得がない場合はスキップ）
白色申告に対応しています。決算書コーナーでは収支内訳書を使用します。なお、帳簿機能は複式簿記ベースで設計されているため、白色申告に必要な水準以上の記帳が行われます。
filing.tax_office_name: 所轄税務署名return_type が blue の場合、以下のフローで控除額を判定する:
記帳方法を聞く（複式簿記 / 簡易帳簿）
簡易帳簿の場合 → simple_bookkeeping: true、控除額 = 100,000円で確定
複式簿記の場合:
submission_method: e-tax) → 控除額 = 650,000円で確定（electronic_bookkeeping は不問）submission_method: mail or in-person) → electronic_bookkeeping を聞く
true（優良な電子帳簿保存あり） → 控除額 = 650,000円
優良な電子帳簿保存の適用には、あらかじめ「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出する必要があります。届出書の様式は国税庁ウェブサイトからダウンロードできます。 令和9年分から適用する場合は、令和8年中に届出書を提出してください。 なお、届出済みかどうかの確認や、システムの要件充足状況の診断は
/e-bookkeeping-complianceスキルで実行できます。
false → 控除額 = 550,000円判定結果をユーザーに表示して確認する
filing.blue_return_deduction: 青色申告特別控除額（自動判定される。手動指定も可）
filing.simple_bookkeeping: 簡易帳簿かどうか（true / false、デフォルト: false）filing.electronic_bookkeeping: 優良な電子帳簿保存の有無（true / false）。e-Tax提出の場合は不問（65万円控除にはe-Taxだけで十分）以下の項目は所得税額・住民税に大きく影響するため、全項目について必ず確認する。 「該当なし」も含め、明示的な回答を得ること。未確認のまま次のステップに進んではならない。
以下を確認し、config に保存する。詳細（所得金額・障害区分等）は /income-tax で登録する。
family.has_spouse: 配偶者の有無（true / false）
family.has_dependents: 扶養親族の有無（true / false）
family.dependent_count: 扶養親族の人数（16歳未満を含む）※ 配偶者・扶養親族のマイナンバーは /income-tax スキルのステップ1.5 で収集する。
housing_loan.applicable: 住宅ローン控除の適用有無（true / false）
housing_loan.first_year: 初年度かどうか（true / false）/income-tax のステップ3.7 で計算明細書を作成する（添付書類が別途必要）estimated_tax.applicable: 予定納税の有無（true / false）
estimated_tax.amount: 予定納税の合計額（第1期 + 第2期、int 円）を確認するステップ2.5-2 で relationship_to_head が「本人」以外の場合:
taxpayer.household_head_name: 世帯主の氏名を確認する（申告書に記載が必要）以下のパスを確認する。デフォルト値を提示し、変更がなければそのまま採用する。
db_path: データベースファイルのパス（デフォルト: ./shinkoku.db）output_dir: 進捗ファイル等の出力先ディレクトリ（デフォルト: ./output）以下のディレクトリを設定するか確認する。スキップ可能。
invoices_dir: 請求書PDF等のディレクトリwithholding_slips_dir: 源泉徴収票のディレクトリreceipts_dir: レシート・領収書のディレクトリbank_statements_dir: 銀行明細CSVのディレクトリcredit_card_statements_dir: クレジットカード明細CSVのディレクトリdeductions_dir: 控除関連書類のディレクトリpast_returns_dir: 過去の確定申告データのディレクトリshinkoku.config.yaml を保存するYAML の形式は以下のテンプレートに従う:
未設定の項目は値を空にする（key: のみ）。
my_number の取扱い: マイナンバーは config YAML に保存するが、profile.py の出力では has_my_number: true/false のみ返す。ログ・会話には出力しない。確定申告書等作成コーナーへの入力時のみ config から直接読み取る。
ユーザーの個人情報・財務データが誤って git にコミットされないよう、.gitignore を設定する。
git rev-parse --is-inside-work-tree を実行し、CWD が git リポジトリかどうか確認する
git リポジトリでない場合 → 以下のメッセージを表示してスキップする:
現在のディレクトリは git リポジトリではありません。今後 git リポジトリ化する場合は、
.gitignoreに shinkoku 関連ファイルを追加して個人情報の漏洩を防いでください。
git リポジトリの場合:
a. CWD の .gitignore を Read ツールで読み込む（存在しなければ新規作成前提で進める）
b. 以下の必須エントリが .gitignore に含まれているか確認する:
c. ステップ4で設定された書類ディレクトリ（invoices_dir, receipts_dir 等）があれば、それも追加対象にする
d. 不足しているエントリがある場合:
.gitignore に追記する（既存の内容は保持し、末尾に追加する）
e. 既に全エントリが含まれている場合 → 「.gitignore は設定済みです」と表示してスキップするdb_path の値を確認し、相対パスの場合は CWD を基準に絶対パスに変換するledger.py init コマンドでデータベースを初期化する:
--fiscal-year: ステップ2 で設定した tax_year--db-path: 絶対パスに変換した値セットアップ完了後、以下を案内する:
サマリー提示後、以下のファイルを Write ツールで出力する。 これにより、セッションの中断や Compact が発生しても次のステップで結果を引き継げる。
.shinkoku/progress/01-setup.md に以下の形式で出力する:
未設定の項目は「未設定」と記載する。
.shinkoku/progress/progress-summary.md を新規作成する:
ファイルを出力したらユーザーに以下を伝える:
.shinkoku/progress/ に保存しました。セッションが中断しても次のスキルで結果を引き継げます。」# shinkoku ユーザー設定ファイル
# /setup スキルで対話的に生成できます。
# 対象年度
tax_year: {tax_year}
# 事業所得の有無（副業含む）
has_business_income: {has_business_income}
# データベースファイルのパス
db_path: {db_path}
# 進捗ファイル等の出力先ディレクトリ
output_dir: {output_dir}
# 適格請求書発行事業者の登録番号（T + 13桁）
invoice_registration_number: {invoice_registration_number}
# --- 納税者情報 ---
taxpayer:
last_name: {last_name}
first_name: {first_name}
last_name_kana: {last_name_kana}
first_name_kana: {first_name_kana}
gender: {gender}
date_of_birth: {date_of_birth}
phone: {phone}
my_number: {my_number}
widow_status: {widow_status}
disability_status: {disability_status}
working_student: {working_student}
relationship_to_head: {relationship_to_head}
# --- 住所 ---
address:
postal_code: {postal_code}
prefecture: {prefecture}
city: {city}
street: {street}
building: {building}
jan1_address: {jan1_address}
# --- 事業所住所（自宅と異なる場合のみ） ---
business_address:
postal_code:
prefecture:
city:
street:
building:
# --- 事業情報 ---
business:
trade_name: {trade_name}
industry_type: {industry_type}
business_description: {business_description}
establishment_year: {establishment_year}
# --- 申告方法 ---
filing:
submission_method: {submission_method}
return_type: {return_type}
blue_return_deduction: {blue_return_deduction}
simple_bookkeeping: {simple_bookkeeping}
electronic_bookkeeping: {electronic_bookkeeping}
tax_office_name: {tax_office_name}
# --- 家族構成 ---
family:
has_spouse: {has_spouse}
has_dependents: {has_dependents}
dependent_count: {dependent_count}
# --- 住宅ローン控除 ---
housing_loan:
applicable: {applicable}
first_year: {first_year}
# --- 予定納税 ---
estimated_tax:
applicable: {applicable}
amount: {amount}
# --- 書類ディレクトリ（任意） ---
invoices_dir: {invoices_dir}
withholding_slips_dir: {withholding_slips_dir}
past_returns_dir: {past_returns_dir}
deductions_dir: {deductions_dir}
receipts_dir: {receipts_dir}
bank_statements_dir: {bank_statements_dir}
credit_card_statements_dir: {credit_card_statements_dir}shinkoku profile --config PATH