{"id":"5b6e9a79-eece-421d-8232-246826ef27a7","shortId":"rrW3X2","kind":"skill","title":"setup","tagline":"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を作り直す\".","description":"# セットアップウィザード（Setup Wizard）\n\nshinkoku の初回セットアップを対話的に行うスキル。\n設定ファイル（`shinkoku.config.yaml`）の生成とデータベースの初期化を実施する。\n\n## ステップ0: CLI のインストール確認\n\n`shinkoku` コマンドが利用可能か確認する。\n\n1. `shinkoku --version` を実行する\n2. **コマンドが存在しない場合**: `uv tool install git+https://github.com/kazukinagata/shinkoku` を実行してインストールする\n3. **コマンドが存在する場合**: `uv tool upgrade shinkoku` を実行して最新版に更新する\n\n## ステップ1: 既存設定の確認\n\nCWD の `shinkoku.config.yaml` を Read ツールで読み込む。\n\n- **ファイルが存在する場合**: 内容を表示し、更新するか確認する。更新しない場合はスキルを終了する。\n- **ファイルが存在しない場合**: セットアップウィザードを開始する。\n\n## ステップ2: 基本設定のヒアリング\n\n以下の項目を AskUserQuestion で確認する:\n\n### 2-1. 対象年度\n\n- `tax_year`: 確定申告の対象年度（デフォルト: 2025）\n\n### 2-1b. 事業所得の有無\n\n- `has_business_income`: 事業所得（副業含む）の有無（true / false）\n\n事業所得がない場合、以下のステップをスキップする:\n- 2-2（インボイス登録番号）\n- 2.6-3（事業所住所）\n- 2.7（事業情報）\n- 2.8 の申告の種類（blue/white）・記帳方法の質問（給与所得のみなら不要）\n\n### 2-2. 適格請求書発行事業者の登録番号（事業所得がある場合のみ）\n\n- `invoice_registration_number`: T + 13桁の番号（任意、スキップ可）\n\n## ステップ2.5: 納税者情報のヒアリング\n\n以下の項目を AskUserQuestion で段階的に確認する。すべて任意（スキップ可能）だが、確定申告書等作成コーナーへの入力や人的控除の判定に使用される。\n\n### 2.5-1. 氏名\n\n- `taxpayer.last_name`: 姓\n- `taxpayer.first_name`: 名\n- `taxpayer.last_name_kana`: 姓（カタカナ）\n- `taxpayer.first_name_kana`: 名（カタカナ）\n\n### 2.5-2. 基本情報\n\n- `taxpayer.gender`: 性別（male / female）\n- `taxpayer.date_of_birth`: 生年月日（YYYY-MM-DD）\n- `taxpayer.phone`: 電話番号\n- `taxpayer.relationship_to_head`: 世帯主との続柄（本人/妻/夫/子等）\n\n### 2.5-3. マイナンバー\n\n- `taxpayer.my_number`: マイナンバー12桁（取扱注意 — config に保存するが、ツール出力やログには一切表示しない）\n\n### 2.5-4. 人的控除に関する状態（任意）\n\n- `taxpayer.widow_status`: 寡婦/ひとり親の区分（none / widow / single_parent）\n- `taxpayer.disability_status`: 障害者の区分（none / general / special）\n- `taxpayer.working_student`: 勤労学生に該当するか（true / false）\n\n## ステップ2.6: 住所情報のヒアリング\n\n### 2.6-1. 自宅住所\n\n- `address.postal_code`: 郵便番号\n- `address.prefecture`: 都道府県\n- `address.city`: 市区町村\n- `address.street`: 番地\n- `address.building`: 建物名・部屋番号（任意）\n\n### 2.6-2. 1月1日時点の住所（異なる場合のみ）\n\n- `address.jan1_address`: 1/1 時点の住所（住民税の課税自治体判定に使用）\n\n### 2.6-3. 事業所住所（事業所得がある場合のみ。自宅と異なる場合のみ）\n\n- `business_address.postal_code` 〜 `business_address.building`\n\n## ステップ2.7: 事業情報のヒアリング\n\n事業所得がある場合に確認する。\n\n- `business.trade_name`: 屋号\n- `business.industry_type`: 業種\n- `business.business_description`: 事業内容\n- `business.establishment_year`: 開業年\n\n## ステップ2.8: 申告方法の確認\n\n以下の項目を順に確認し、青色申告特別控除額を**自動判定**する。\n\n### ヒアリング項目\n\n- `filing.submission_method`: 提出方法（e-tax / mail / in-person）\n  - **mail / in-person を選択した場合**、選択直後に以下を伝える:\n    > このプラグインの帳簿管理・税額計算機能はご利用いただけますが、確定申告書等作成コーナーへの自動入力（`/e-tax` スキル）は e-Tax 提出専用のため利用できません。作成コーナーへの入力はご自身で行っていただく必要があります。\n  - e-tax を選択した場合は通知不要（フルサポート）\n- `filing.return_type`: 申告の種類（blue / white）— **事業所得がある場合のみ質問する**（事業所得がない場合はスキップ）\n  - **white を選択した場合**、選択直後に以下を伝える:\n    > 白色申告に対応しています。決算書コーナーでは収支内訳書を使用します。なお、帳簿機能は複式簿記ベースで設計されているため、白色申告に必要な水準以上の記帳が行われます。\n  - blue を選択した場合は通知不要\n- `filing.tax_office_name`: 所轄税務署名\n\n### 青色申告特別控除の自動判定フロー\n\n`return_type` が `blue` の場合、以下のフローで控除額を判定する:\n\n1. 記帳方法を聞く（複式簿記 / 簡易帳簿）\n2. **簡易帳簿の場合** → `simple_bookkeeping: true`、控除額 = 100,000円で確定\n3. **複式簿記の場合**:\n   - **e-Tax提出** (`submission_method: e-tax`) → 控除額 = 650,000円で確定（`electronic_bookkeeping` は不問）\n   - **書面提出** (`submission_method: mail` or `in-person`) → `electronic_bookkeeping` を聞く\n     - `true`（優良な電子帳簿保存あり） → 控除額 = 650,000円\n       - **true を選択した場合**、選択直後に以下を伝える:\n         > 優良な電子帳簿保存の適用には、あらかじめ「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出する必要があります。届出書の様式は国税庁ウェブサイトからダウンロードできます。\n         > 令和9年分から適用する場合は、令和8年中に届出書を提出してください。\n         > なお、届出済みかどうかの確認や、システムの要件充足状況の診断は `/e-bookkeeping-compliance` スキルで実行できます。\n     - `false` → 控除額 = 550,000円\n\n4. 判定結果をユーザーに表示して確認する\n\n### 関連フィールド\n\n- `filing.blue_return_deduction`: 青色申告特別控除額（自動判定される。手動指定も可）\n  - 650,000: 複式簿記 + (e-Tax提出 又は 電子帳簿保存) + 期限内申告\n  - 550,000: 複式簿記 + 書面提出 + 期限内申告（e-Tax/電子帳簿保存なし）\n  - 100,000: 簡易帳簿 又は 期限後申告\n- `filing.simple_bookkeeping`: 簡易帳簿かどうか（true / false、デフォルト: false）\n- `filing.electronic_bookkeeping`: 優良な電子帳簿保存の有無（true / false）。e-Tax提出の場合は不問（65万円控除にはe-Taxだけで十分）\n\n## ステップ2.9: 控除・申告に影響する重要事項の確認（スキップ不可）\n\n以下の項目は所得税額・住民税に大きく影響するため、**全項目について必ず確認する**。\n「該当なし」も含め、明示的な回答を得ること。未確認のまま次のステップに進んではならない。\n\n### 2.9-1. 家族構成（配偶者・扶養親族）\n\n以下を確認し、config に保存する。詳細（所得金額・障害区分等）は `/income-tax` で登録する。\n\n- `family.has_spouse`: 配偶者の有無（true / false）\n  - true の場合:\n    - 配偶者の年間所得（概算）を確認し、配偶者控除/特別控除の適用可能性を把握する\n    - 所得48万円以下 → 配偶者控除、48万〜133万円 → 配偶者特別控除\n    - **事業専従者かどうか**: 青色事業専従者として給与を受けている配偶者は配偶者控除の対象外\n- `family.has_dependents`: 扶養親族の有無（true / false）\n  - true の場合: 人数と概要（子・親など）を確認する\n  - **16歳未満の子供も含める**: 扶養控除は対象外だが、住民税の非課税判定・均等割判定に\n    必要なため、申告書第二表「住民税に関する事項」に記載が必要\n  - **事業専従者は除外**: 青色事業専従者・白色事業専従者は扶養親族に該当しない\n- `family.dependent_count`: 扶養親族の人数（16歳未満を含む）\n\n※ 配偶者・扶養親族のマイナンバーは `/income-tax` スキルのステップ1.5 で収集する。\n\n### 2.9-2. 住宅ローン控除\n\n- `housing_loan.applicable`: 住宅ローン控除の適用有無（true / false）\n  - true の場合:\n    - `housing_loan.first_year`: 初年度かどうか（true / false）\n    - 初年度 → `/income-tax` のステップ3.7 で計算明細書を作成する（添付書類が別途必要）\n    - 2年目以降 → 年末調整で適用済みなら確定申告での追加手続きは原則不要\n\n### 2.9-3. 予定納税\n\n- `estimated_tax.applicable`: 予定納税の有無（true / false）\n  - 判定基準: 前年の確定申告書の㊺欄（申告納税額）が **15万円以上** → 予定納税あり\n  - true の場合:\n    - `estimated_tax.amount`: 予定納税の合計額（第1期 + 第2期、int 円）を確認する\n    - 減額申請をした場合は減額後の金額を記入する\n\n### 2.9-4. 世帯主の氏名（本人でない場合）\n\nステップ2.5-2 で `relationship_to_head` が「本人」以外の場合:\n- `taxpayer.household_head_name`: 世帯主の氏名を確認する（申告書に記載が必要）\n\n## ステップ3: パス設定\n\n以下のパスを確認する。デフォルト値を提示し、変更がなければそのまま採用する。\n\n- `db_path`: データベースファイルのパス（デフォルト: `./shinkoku.db`）\n- `output_dir`: 進捗ファイル等の出力先ディレクトリ（デフォルト: `./output`）\n\n## ステップ4: 書類ディレクトリの設定（任意）\n\n以下のディレクトリを設定するか確認する。スキップ可能。\n\n- `invoices_dir`: 請求書PDF等のディレクトリ\n- `withholding_slips_dir`: 源泉徴収票のディレクトリ\n- `receipts_dir`: レシート・領収書のディレクトリ\n- `bank_statements_dir`: 銀行明細CSVのディレクトリ\n- `credit_card_statements_dir`: クレジットカード明細CSVのディレクトリ\n- `deductions_dir`: 控除関連書類のディレクトリ\n- `past_returns_dir`: 過去の確定申告データのディレクトリ\n\n## ステップ5: 設定のプレビューと保存\n\n1. 収集した設定内容を YAML 形式でプレビュー表示する\n2. ユーザーの確認を得る\n3. Write ツールで CWD に `shinkoku.config.yaml` を保存する\n\nYAML の形式は以下のテンプレートに従う:\n\n```yaml\n# shinkoku ユーザー設定ファイル\n# /setup スキルで対話的に生成できます。\n\n# 対象年度\ntax_year: {tax_year}\n\n# 事業所得の有無（副業含む）\nhas_business_income: {has_business_income}\n\n# データベースファイルのパス\ndb_path: {db_path}\n\n# 進捗ファイル等の出力先ディレクトリ\noutput_dir: {output_dir}\n\n# 適格請求書発行事業者の登録番号（T + 13桁）\ninvoice_registration_number: {invoice_registration_number}\n\n# --- 納税者情報 ---\ntaxpayer:\n  last_name: {last_name}\n  first_name: {first_name}\n  last_name_kana: {last_name_kana}\n  first_name_kana: {first_name_kana}\n  gender: {gender}\n  date_of_birth: {date_of_birth}\n  phone: {phone}\n  my_number: {my_number}\n  widow_status: {widow_status}\n  disability_status: {disability_status}\n  working_student: {working_student}\n  relationship_to_head: {relationship_to_head}\n\n# --- 住所 ---\naddress:\n  postal_code: {postal_code}\n  prefecture: {prefecture}\n  city: {city}\n  street: {street}\n  building: {building}\n  jan1_address: {jan1_address}\n\n# --- 事業所住所（自宅と異なる場合のみ） ---\nbusiness_address:\n  postal_code:\n  prefecture:\n  city:\n  street:\n  building:\n\n# --- 事業情報 ---\nbusiness:\n  trade_name: {trade_name}\n  industry_type: {industry_type}\n  business_description: {business_description}\n  establishment_year: {establishment_year}\n\n# --- 申告方法 ---\nfiling:\n  submission_method: {submission_method}\n  return_type: {return_type}\n  blue_return_deduction: {blue_return_deduction}\n  simple_bookkeeping: {simple_bookkeeping}\n  electronic_bookkeeping: {electronic_bookkeeping}\n  tax_office_name: {tax_office_name}\n\n# --- 家族構成 ---\nfamily:\n  has_spouse: {has_spouse}\n  has_dependents: {has_dependents}\n  dependent_count: {dependent_count}\n\n# --- 住宅ローン控除 ---\nhousing_loan:\n  applicable: {applicable}\n  first_year: {first_year}\n\n# --- 予定納税 ---\nestimated_tax:\n  applicable: {applicable}\n  amount: {amount}\n\n# --- 書類ディレクトリ（任意） ---\ninvoices_dir: {invoices_dir}\nwithholding_slips_dir: {withholding_slips_dir}\npast_returns_dir: {past_returns_dir}\ndeductions_dir: {deductions_dir}\nreceipts_dir: {receipts_dir}\nbank_statements_dir: {bank_statements_dir}\ncredit_card_statements_dir: {credit_card_statements_dir}\n```\n\n未設定の項目は値を空にする（`key:` のみ）。\n\n**`my_number` の取扱い**: マイナンバーは config YAML に保存するが、`profile.py` の出力では `has_my_number: true/false` のみ返す。ログ・会話には出力しない。確定申告書等作成コーナーへの入力時のみ config から直接読み取る。\n\n```bash\nshinkoku profile --config PATH\n```\n\n## ステップ5.5: Git セーフティ設定\n\nユーザーの個人情報・財務データが誤って git にコミットされないよう、`.gitignore` を設定する。\n\n### 手順\n\n1. `git rev-parse --is-inside-work-tree` を実行し、CWD が git リポジトリかどうか確認する\n\n2. **git リポジトリでない場合** → 以下のメッセージを表示してスキップする:\n   > 現在のディレクトリは git リポジトリではありません。今後 git リポジトリ化する場合は、`.gitignore` に shinkoku 関連ファイルを追加して個人情報の漏洩を防いでください。\n\n3. **git リポジトリの場合**:\n   a. CWD の `.gitignore` を Read ツールで読み込む（存在しなければ新規作成前提で進める）\n   b. 以下の必須エントリが `.gitignore` に含まれているか確認する:\n      ```\n      # shinkoku 確定申告データ（個人情報を含む — 削除しないこと）\n      shinkoku.config.yaml\n      shinkoku.db\n      shinkoku.db-wal\n      shinkoku.db-shm\n      .shinkoku/\n      output/\n      ```\n   c. ステップ4で設定された書類ディレクトリ（`invoices_dir`, `receipts_dir` 等）があれば、それも追加対象にする\n   d. 不足しているエントリがある場合:\n      - 追加するエントリの一覧をユーザーに提示する\n      - ユーザーの確認を得てから `.gitignore` に追記する（既存の内容は保持し、末尾に追加する）\n   e. 既に全エントリが含まれている場合 → 「`.gitignore` は設定済みです」と表示してスキップする\n\n## ステップ6: データベースの初期化\n\n1. `db_path` の値を確認し、相対パスの場合は CWD を基準に絶対パスに変換する\n2. `ledger.py init` コマンドでデータベースを初期化する:\n   ```bash\n   shinkoku ledger init --db-path DB --fiscal-year YEAR\n   ```\n   - `--fiscal-year`: ステップ2 で設定した `tax_year`\n   - `--db-path`: 絶対パスに変換した値\n\n## ステップ7: 次のステップの案内\n\nセットアップ完了後、以下を案内する:\n\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nセットアップ完了\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n■ 生成されたファイル:\n  → shinkoku.config.yaml（設定ファイル）\n  → {db_path}（データベース）\n\n■ 次のステップ:\n  1. /assess — 申告要否・種類の判定\n  2. /gather — 必要書類の確認・収集\n  3. /journal — 仕訳入力・帳簿管理\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n```\n\n## 引継書の出力\n\nサマリー提示後、以下のファイルを Write ツールで出力する。\nこれにより、セッションの中断や Compact が発生しても次のステップで結果を引き継げる。\n\n### ステップ別ファイルの出力\n\n`.shinkoku/progress/01-setup.md` に以下の形式で出力する:\n\n```\n---\nstep: 1\nskill: setup\nstatus: completed\ncompleted_at: \"{当日日付 YYYY-MM-DD}\"\nfiscal_year: {tax_year}\n---\n\n# セットアップ結果\n\n## 設定内容\n\n- 対象年度: {tax_year}\n- データベースパス: {db_path}\n- 出力ディレクトリ: {output_dir}\n- インボイス登録番号: {invoice_registration_number}\n\n## 納税者情報\n\n- 氏名: {last_name} {first_name}\n- 生年月日: {date_of_birth}\n- マイナンバー: {登録済み/未登録}\n- 寡婦/ひとり親: {widow_status}\n- 障害者区分: {disability_status}\n- 勤労学生: {working_student}\n- 世帯主との続柄: {relationship_to_head}\n\n## 住所\n\n- 自宅: {postal_code} {prefecture}{city}{street}{building}\n- 1/1時点の住所: {jan1_address}（同上/異なる住所）\n- 事業所住所: {設定あり/自宅と同じ}\n\n## 事業情報\n\n- 屋号: {trade_name}\n- 業種: {industry_type}\n- 事業内容: {business_description}\n\n## 申告方法\n\n- 提出方法: {submission_method}\n- 申告の種類: {return_type}\n- 青色申告特別控除: {blue_return_deduction}円\n- 所轄税務署: {tax_office_name}\n\n## 控除・申告に影響する重要事項\n\n- 配偶者: {あり（概算所得: ○万円）/ なし}\n- 扶養親族: {あり（○人、うち16歳未満○人）/ なし}\n- 住宅ローン控除: {適用あり（初年度/2年目以降）/ 適用なし}\n- 予定納税: {あり（合計○円）/ なし}\n- 世帯主: {本人 / ○○（氏名）}\n\n## 書類ディレクトリ\n\n- 請求書: {invoices_dir}\n- 源泉徴収票: {withholding_slips_dir}\n- レシート: {receipts_dir}\n- 銀行明細: {bank_statements_dir}\n- クレカ明細: {credit_card_statements_dir}\n- 控除関連: {deductions_dir}\n- 過去の申告: {past_returns_dir}\n\n## DB初期化\n\n- 初期化結果: 成功\n- 勘定科目マスタ: 登録済み\n\n## 次のステップ\n\n/assess で申告要否・種類を判定する\n```\n\n未設定の項目は「未設定」と記載する。\n\n### 進捗サマリーの更新\n\n`.shinkoku/progress/progress-summary.md` を新規作成する:\n\n- YAML frontmatter: fiscal_year、last_updated（当日日付）、current_step: setup\n- テーブル: 全ステップの状態を記載（setup を completed に、他は pending に）\n- 次のステップの案内を記載\n\n### 出力後の案内\n\nファイルを出力したらユーザーに以下を伝える:\n- 「引継書を `.shinkoku/progress/` に保存しました。セッションが中断しても次のスキルで結果を引き継げます。」\n- 次のステップの案内","tags":["setup","shinkoku","kazukinagata","agent-skills","bookkeeping","claude-code-plugin","claude-code-skills","japan","python","tax-filing"],"capabilities":["skill","source-kazukinagata","skill-setup","topic-agent-skills","topic-bookkeeping","topic-claude-code-plugin","topic-claude-code-skills","topic-japan","topic-python","topic-tax-filing"],"categories":["shinkoku"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/kazukinagata/shinkoku/setup","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add kazukinagata/shinkoku","source_repo":"https://github.com/kazukinagata/shinkoku","install_from":"skills.sh"}},"qualityScore":"0.619","qualityRationale":"deterministic score 0.62 from registry signals: · indexed on github topic:agent-skills · 339 github stars · SKILL.md body (11,250 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:53:50.117Z","embedding":null,"createdAt":"2026-04-18T22:02:52.533Z","updatedAt":"2026-05-02T18:53:50.117Z","lastSeenAt":"2026-05-02T18:53:50.117Z","tsv":"'-1':94,102,149,228,466 '-2':116,129,168,244,530 '-3':119,193,252,551 '-4':203,575 '/2':1197 '/assess':1056,1241 '/e-bookkeeping-compliance':398 '/e-tax':300 '/gather':1060 '/income-tax':477,526,544 '/journal':1064 '/kazukinagata/shinkoku':65 '/output':605 '/setup':658 '/shinkoku.db':600 '000':414,423,432 '000円':384,403 '000円で確定':352,365 '1':53,341,640,929,1009,1055,1080 '1/1':248,1146 '100':351,431 '133万円':494 '13桁':685 '13桁の番号':136 '15万円以上':562 '16歳未満の子供も含める':509 '16歳未満を含む':523 '1月1日時点の住所':245 '2':57,93,101,115,128,345,644,944,1016,1059 '2.5':148,167,192,202 '2.6':118,227,243,251 '2.7':121 '2.8':123 '2.9':465,529,550,574 '2025':100 '2年目以降':548 '3':67,353,646,958,1063 '4':404 '48万':493 '550':402,422 '650':364,383,413 '65万円控除にはe':452 '65万円控除にはe-taxだけで十分':451 'address':747,761,763,767,1149 'address.building':239 'address.city':235 'address.jan1_address':247 'address.postal':230 'address.prefecture':233 'address.street':237 'amount':850,851 'applic':839,840,848,849 'askuserquest':91,142 'b':103,969 'bank':622,878,881,1220 'bash':914,1020 'birth':176,718,721,1120 'blue':316,328,338,802,805,1173 'blue/white':125 'bookkeep':348,367,378,437,444,809,811,813,815 'build':758,759,773,1145 'busi':106,668,671,766,775,784,786,1163 'business.business':268 'business.establishment':271 'business.industry':265 'business.trade':262 'business_address.building':258 'business_address.postal':256 'c':985 'card':627,885,889,1225 'citi':754,755,771,1143 'cli':49 'code':231,257,749,751,769,1141 'compact':1074 'complet':1084,1085,1264 'config':34,199,471,899,912,917 'configur':21 'configを作り直す':39 'count':521,833,835 'credit':626,884,888,1224 'current':1257 'cwd':76,649,940,962,1014 'd':994 'date':716,719,1118 'db':596,674,676,1010,1025,1027,1040,1051,1102 'db-path':1024,1039 'db初期化':1235 'dd':181,1091 'deduct':409,631,804,807,870,872,1175,1229 'depend':499,829,831,832,834 'descript':269,785,787,1164 'dir':602,612,616,619,624,629,632,636,680,682,855,857,860,863,866,869,871,873,875,877,880,883,887,891,988,990,1106,1211,1215,1218,1222,1227,1230,1234 'disabl':732,734,1129 'e':285,304,309,356,361,417,428,449,1002 'e-tax':284,303,308,360,427 'e-tax提出':355,416 'e-tax提出の場合は不問':448 'electron':366,377,812,814 'establish':788,790 'estim':846 'estimated_tax.amount':566 'estimated_tax.applicable':553 'exist':25 'fals':112,224,400,440,442,447,483,502,535,542,556 'famili':823 'family.dependent':520 'family.has':479,498 'femal':173 'file':793 'filing.blue':407 'filing.electronic':443 'filing.return':313 'filing.simple':436 'filing.submission':281 'filing.tax':330 'first':17,698,700,708,711,841,843,1115 'fiscal':1029,1033,1092,1252 'fiscal-year':1028,1032 'frontmatt':1251 'gender':714,715 'general':218 'git':62,920,924,930,942,945,949,952,959 'github.com':64 'github.com/kazukinagata/shinkoku':63 'gitignor':926,954,964,971,998,1004 'head':186,582,587,742,745,1137 'hous':837 'housing_loan.applicable':532 'housing_loan.first':538 'in-person':288,292,374 'includ':29 'incom':107,669,672 'industri':780,782,1160 'init':1018,1023 'initi':19 'insid':936 'instal':61 'int':570 'invoic':132,611,686,689,854,856,987,1108,1210 'is-inside-work-tre':934 'jan1':760,762,1148 'kana':159,164,704,707,710,713 'key':893 'last':694,696,702,705,1113,1254 'ledger':1022 'ledger.py':1017 'loan':838 'mail':287,291,372 'male':172 'method':282,359,371,795,797,1168 'mm':180,1090 'name':152,155,158,163,263,332,588,695,697,699,701,703,706,709,712,777,779,818,821,1114,1116,1158,1180 'none':210,217 'number':134,196,688,691,725,727,896,906,1110 'offic':331,817,820,1179 'output':601,679,681,984,1105 'parent':213 'pars':933 'past':634,864,867,1232 'path':597,675,677,918,1011,1026,1041,1052,1103 'pend':1267 'person':290,294,376 'phone':722,723 'phrase':28 'postal':748,750,768,1140 'prefectur':752,753,770,1142 'profil':916 'profile.py':902 'read':80,966 'receipt':618,874,876,989,1217 'registr':133,687,690,1109 'relationship':580,740,743,1135 'return':335,408,635,798,800,803,806,865,868,1170,1174,1233 'rev':932 'rev-pars':931 'set':12,26 'setup':1,35,41,1082,1259,1262 'shinkoku':14,43,51,54,72,656,915,956,973,983,1021 'shinkoku.config.yaml':46,78,651,977,1049 'shinkoku.db':978,979,981 'shinkoku/progress':1273 'shinkoku/progress/01-setup.md':1077 'shinkoku/progress/progress-summary.md':1248 'shinkokuの設定':33 'shm':982 'simpl':347,808,810 'singl':212 'skill':3,1081 'skill-setup' 'slip':615,859,862,1214 'source-kazukinagata' 'special':219 'spous':480,825,827 'statement':623,628,879,882,886,890,1221,1226 'status':207,215,729,731,733,735,1083,1127,1130 'step':1079,1258 'street':756,757,772,1144 'student':221,737,739,1133 'submiss':358,370,794,796,1167 'tax':96,286,305,310,362,429,661,663,816,819,847,1037,1094,1099,1178 'taxpay':693 'taxpayer.date':174 'taxpayer.disability':214 'taxpayer.first':154,162 'taxpayer.gender':170 'taxpayer.household':586 'taxpayer.last':151,157 'taxpayer.my':195 'taxpayer.phone':182 'taxpayer.relationship':184 'taxpayer.widow':206 'taxpayer.working':220 'taxだけで十分':453 'tax提出':357,418 'tax提出の場合は不問':450 'time':18 'tool':60,70 'topic-agent-skills' 'topic-bookkeeping' 'topic-claude-code-plugin' 'topic-claude-code-skills' 'topic-japan' 'topic-python' 'topic-tax-filing' 'trade':776,778,1157 'tree':938 'trigger':27 'true':111,223,349,380,385,439,446,482,484,501,503,534,536,541,555,564 'true/false':907 'type':266,314,336,781,783,799,801,1161,1171 'updat':23,1255 'upgrad':71 'use':6 'user':9 'uv':59,69 'version':55 'wal':980 'want':10 'white':317,320 'widow':211,728,730,1126 'withhold':614,858,861,1213 'wizard':42 'work':736,738,937,1132 'write':647,1070 'yaml':642,653,655,900,1250 'year':97,272,539,662,664,789,791,842,844,1030,1031,1034,1038,1093,1095,1100,1253 'yyyi':179,1089 'yyyy-mm-dd':178,1088 'あらかじめ':389 'あり':1184,1189,1201 'うち16歳未満':1191 'から直接読み取る':913 'が':337,561,583,941 'があれば':992 'が発生しても次のステップで結果を引き継げる':1075 'このプラグインの帳簿管理':297 'これにより':1072 'すべて任意':144 'する':279 'それも追加対象にする':993 'だが':146 'で':579 'で収集する':528 'で段階的に確認する':143 'で申告要否':1242 'で登録する':478 'で確認する':92 'で計算明細書を作成する':546 'で設定した':1036 'と表示してスキップする':1006 'と記載する':1246 'なお':325,395 'なし':1187,1193,1204 'に':650,955,1265,1268 'にコミットされないよう':925 'に以下の形式で出力する':1078 'に保存しました':1274 'に保存する':472 'に保存するが':200,901 'に含まれているか確認する':972 'に記載が必要':516 'に追記する':999 'の':77,963 'のみ':894 'のみ返す':908 'のインストール確認':50 'のステップ3.7':545 'の値を確認し':1012 'の出力では':903 'の初回セットアップを対話的に行うスキル':44 'の取扱い':897 'の場合':339,485,504,537,565 'の形式は以下のテンプレートに従う':654 'の有無':110 'の生成とデータベースの初期化を実施する':47 'の申告の種類':124 'は':302,476 'は不問':368 'は設定済みです':1005 'ひとり親':1125 'ひとり親の区分':209 'も含め':462 'を':79,965,1263 'を保存する':652 'を基準に絶対パスに変換する':1015 'を実行し':939 'を実行してインストールする':66 'を実行して最新版に更新する':73 'を実行する':56 'を所轄税務署に提出する必要があります':391 'を新規作成する':1249 'を確認し':488 'を確認する':508,572 'を聞く':379 'を設定する':927 'を選択した場合':295,321,386 'を選択した場合は通知不要':311,329 'インボイス登録番号':117,1107 'カタカナ':161,166 'クレカ明細':1223 'クレジットカード明細csvのディレクトリ':630 'コマンドが利用可能か確認する':52 'コマンドが存在しない場合':58 'コマンドが存在する場合':68 'コマンドでデータベースを初期化する':1019 'サマリー提示後':1068 'システムの要件充足状況の診断は':397 'スキップ不可':457 'スキップ可':138 'スキップ可能':145,610 'スキル':301 'スキルで実行できます':399 'スキルで対話的に生成できます':659 'スキルのステップ1.5':527 'ステップ0':48 'ステップ1':74 'ステップ2':88,1035 'ステップ2.5':139 'ステップ2.5-2':578 'ステップ2.6':225 'ステップ2.7':259 'ステップ2.8':274 'ステップ2.9':454 'ステップ3':591 'ステップ4':606 'ステップ4で設定された書類ディレクトリ':986 'ステップ5':638 'ステップ5.5':919 'ステップ6':1007 'ステップ7':1043 'ステップ別ファイルの出力':1076 'セッションが中断しても次のスキルで結果を引き継げます':1275 'セッションの中断や':1073 'セットアップ':30 'セットアップウィザード':40 'セットアップウィザードを開始する':87 'セットアップ完了':1047 'セットアップ完了後':1045 'セットアップ結果':1096 'セーフティ設定':921 'ツールで':648 'ツールで出力する':1071 'ツールで読み込む':81,967 'ツール出力やログには一切表示しない':201 'テーブル':1260 'デフォルト':99,441,599,604 'デフォルト値を提示し':594 'データベース':1053 'データベースの初期化':1008 'データベースパス':1101 'データベースファイルのパス':598,673 'パス設定':592 'ヒアリング項目':280 'ファイルが存在しない場合':86 'ファイルが存在する場合':82 'ファイルを出力したらユーザーに以下を伝える':1271 'フルサポート':312 'マイナンバー':194,1121 'マイナンバー12桁':197 'マイナンバーは':898 'ユーザーの個人情報':922 'ユーザーの確認を得てから':997 'ユーザーの確認を得る':645 'ユーザー設定ファイル':657 'リポジトリかどうか確認する':943 'リポジトリでない場合':946 'リポジトリではありません':950 'リポジトリの場合':960 'リポジトリ化する場合は':953 'レシート':620,1216 'ログ':909 '万円':1186 '不足しているエントリがある場合':995 '世帯主':1205 '世帯主との続柄':187,1134 '世帯主の氏名':576 '世帯主の氏名を確認する':589 '予定納税':552,845,1200 '予定納税あり':563 '予定納税の合計額':567 '予定納税の有無':554 '事業内容':270,1162 '事業専従者かどうか':496 '事業専従者は除外':517 '事業情報':122,774,1155 '事業情報のヒアリング':260 '事業所住所':120,253,764,1152 '事業所得':108 '事業所得がある場合に確認する':261 '事業所得がある場合のみ':131,254 '事業所得がある場合のみ質問する':318 '事業所得がない場合':113 '事業所得がない場合はスキップ':319 '事業所得の有無':104,665 '人':1190,1192 '人数と概要':505 '人的控除に関する状態':204 '今後':951 '仕訳入力':1065 '他は':1266 '令和8年中に届出書を提出してください':394 '令和9年分から適用する場合は':393 '以下のステップをスキップする':114 '以下のディレクトリを設定するか確認する':609 '以下のパスを確認する':593 '以下のファイルを':1069 '以下のフローで控除額を判定する':340 '以下のメッセージを表示してスキップする':947 '以下の必須エントリが':970 '以下の項目は所得税額':458 '以下の項目を':90,141 '以下の項目を順に確認し':276 '以下を案内する':1046 '以下を確認し':470 '以外の場合':585 '任意':137,205,242,608,853 '会話には出力しない':910 '住宅ローン控除':531,836,1194 '住宅ローン控除の適用有無':533 '住所':746,1138 '住所情報のヒアリング':226 '住民税に大きく影響するため':459 '住民税に関する事項':515 '住民税の課税自治体判定に使用':250 '住民税の非課税判定':511 '作成コーナーへの入力はご自身で行っていただく必要があります':307 '使い方':37 '個人情報を含む':975 '優良な電子帳簿保存あり':381 '優良な電子帳簿保存の有無':445 '優良な電子帳簿保存の適用には':388 '全ステップの状態を記載':1261 '全項目について必ず確認する':460 '内容を表示し':83 '円':571,1176,1203 '出力ディレクトリ':1104 '出力後の案内':1270 '初年度':543,1196 '初年度かどうか':540 '初期化結果':1236 '初期設定':31 '判定基準':557 '判定結果をユーザーに表示して確認する':405 '削除しないこと':976 '前年の確定申告書の':558 '副業含む':109,666 '勘定科目マスタ':1238 '勤労学生':1131 '勤労学生に該当するか':222 '又は':419,434 '収集':1062 '収集した設定内容を':641 '取扱注意':198 '合計':1202 '同上':1150 '名':156,165 '国税関係帳簿の電磁的記録等による保存等に係る届出書':390 '均等割判定に':512 '基本情報':169 '基本設定のヒアリング':89 '変更がなければそのまま採用する':595 '夫':190 '妻':189 '始め方':36 '姓':153,160 '子':506 '子等':191 '存在しなければ新規作成前提で進める':968 '家族構成':467,822 '寡婦':208,1124 '対象年度':95,660,1098 '届出書の様式は国税庁ウェブサイトからダウンロードできます':392 '届出済みかどうかの確認や':396 '屋号':264,1156 '市区町村':236 '帳簿機能は複式簿記ベースで設計されているため':326 '帳簿管理':1066 '年末調整で適用済みなら確定申告での追加手続きは原則不要':549 '年目以降':1198 '建物名':240 '引継書の出力':1067 '引継書を':1272 '当日日付':1087,1256 '形式でプレビュー表示する':643 '必要なため':513 '必要書類の確認':1061 '性別':171 '成功':1237 '所得48万円以下':491 '所得金額':474 '所轄税務署':1177 '所轄税務署名':333 '手動指定も可':412 '手順':928 '扶養控除は対象外だが':510 '扶養親族':469,1188 '扶養親族のマイナンバーは':525 '扶養親族の人数':522 '扶養親族の有無':500 '控除':455,1181 '控除関連':1228 '控除関連書類のディレクトリ':633 '控除額':350,363,382,401 '提出専用のため利用できません':306 '提出方法':283,1166 '既に全エントリが含まれている場合':1003 '既存の内容は保持し':1000 '既存設定の確認':75 '明示的な回答を得ること':463 '時点の住所':249,1147 '更新しない場合はスキルを終了する':85 '更新するか確認する':84 '書面提出':369,425 '書類ディレクトリ':852,1208 '書類ディレクトリの設定':607 '期限内申告':421,426 '期限後申告':435 '未登録':1123 '未確認のまま次のステップに進んではならない':464 '未設定':1245 '未設定の項目は':1244 '未設定の項目は値を空にする':892 '末尾に追加する':1001 '本人':188,584,1206 '本人でない場合':577 '業種':267,1159 '概算':487 '概算所得':1185 '欄':559 '次のステップ':1054,1240 '次のステップの案内':1044,1276 '次のステップの案内を記載':1269 '氏名':150,1112,1207 '決算書コーナーでは収支内訳書を使用します':324 '添付書類が別途必要':547 '減額申請をした場合は減額後の金額を記入する':573 '源泉徴収票':1212 '源泉徴収票のディレクトリ':617 '特別控除の適用可能性を把握する':490 '現在のディレクトリは':948 '生年月日':177,1117 '生成されたファイル':1048 '申告に影響する重要事項':1182 '申告に影響する重要事項の確認':456 '申告の種類':315,1169 '申告方法':792,1165 '申告方法の確認':275 '申告書に記載が必要':590 '申告書第二表':514 '申告納税額':560 '申告要否':1057 '番地':238 '異なる住所':1151 '異なる場合のみ':246 '登録済み':1122,1239 '白色事業専従者は扶養親族に該当しない':519 '白色申告に対応しています':323 '白色申告に必要な水準以上の記帳が行われます':327 '相対パスの場合は':1013 '確定申告の対象年度':98 '確定申告データ':974 '確定申告書等作成コーナーへの入力や人的控除の判定に使用される':147 '確定申告書等作成コーナーへの入力時のみ':911 '確定申告書等作成コーナーへの自動入力':299 '税額計算機能はご利用いただけますが':298 '種類の判定':1058 '種類を判定する':1243 '第1期':568 '第2期':569 '等':991 '簡易帳簿':344,433 '簡易帳簿かどうか':438 '簡易帳簿の場合':346 '納税者情報':692,1111 '納税者情報のヒアリング':140 '給与所得のみなら不要':127 '絶対パスに変換した値':1042 '自動判定':278 '自動判定される':411 '自宅':1139 '自宅と同じ':1154 '自宅と異なる場合のみ':255,765 '自宅住所':229 '複式簿記':343,415,424 '複式簿記の場合':354 '親など':507 '記帳方法の質問':126 '記帳方法を聞く':342 '設定あり':1153 '設定のプレビューと保存':639 '設定を更新':38 '設定ファイル':45,1050 '設定ファイルを作る':32 '設定内容':1097 '該当なし':461 '詳細':473 '請求書':1209 '請求書pdf等のディレクトリ':613 '財務データが誤って':923 '追加するエントリの一覧をユーザーに提示する':996 '進捗サマリーの更新':1247 '進捗ファイル等の出力先ディレクトリ':603,678 '過去の申告':1231 '過去の確定申告データのディレクトリ':637 '適格請求書発行事業者の登録番号':130,683 '適用あり':1195 '適用なし':1199 '選択直後に以下を伝える':296,322,387 '部屋番号':241 '郵便番号':232 '都道府県':234 '配偶者':468,524,1183 '配偶者の年間所得':486 '配偶者の有無':481 '配偶者控除':489,492 '配偶者特別控除':495 '銀行明細':1219 '銀行明細csvのディレクトリ':625 '開業年':273 '関連ファイルを追加して個人情報の漏洩を防いでください':957 '関連フィールド':406 '障害区分等':475 '障害者の区分':216 '障害者区分':1128 '電子帳簿保存':420 '電子帳簿保存なし':430 '電話番号':183 '青色事業専従者':518 '青色事業専従者として給与を受けている配偶者は配偶者控除の対象外':497 '青色申告特別控除':1172 '青色申告特別控除の自動判定フロー':334 '青色申告特別控除額':410 '青色申告特別控除額を':277 '領収書のディレクトリ':621","prices":[{"id":"511cdbcf-2f83-4d3d-99cb-a40de4c1b9f5","listingId":"5b6e9a79-eece-421d-8232-246826ef27a7","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"kazukinagata","category":"shinkoku","install_from":"skills.sh"},"createdAt":"2026-04-18T22:02:52.533Z"}],"sources":[{"listingId":"5b6e9a79-eece-421d-8232-246826ef27a7","source":"github","sourceId":"kazukinagata/shinkoku/setup","sourceUrl":"https://github.com/kazukinagata/shinkoku/tree/main/skills/setup","isPrimary":false,"firstSeenAt":"2026-04-18T22:02:52.533Z","lastSeenAt":"2026-05-02T18:53:50.117Z"}],"details":{"listingId":"5b6e9a79-eece-421d-8232-246826ef27a7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"kazukinagata","slug":"setup","github":{"repo":"kazukinagata/shinkoku","stars":339,"topics":["agent-skills","bookkeeping","claude-code-plugin","claude-code-skills","japan","python","tax-filing"],"license":"mit","html_url":"https://github.com/kazukinagata/shinkoku","pushed_at":"2026-03-21T04:08:44Z","description":"確定申告自動化 AI エージェントプラグイン — 帳簿管理から e-Tax 入力代行まで","skill_md_sha":"0b50deb2aa4c6a3f580b71e8256f7a94e703b8b6","skill_md_path":"skills/setup/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/kazukinagata/shinkoku/tree/main/skills/setup"},"layout":"multi","source":"github","category":"shinkoku","frontmatter":{"name":"setup","description":"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を作り直す\"."},"skills_sh_url":"https://skills.sh/kazukinagata/shinkoku/setup"},"updatedAt":"2026-05-02T18:53:50.117Z"}}