setup

Name: setup
Author: kazukinagata

348stars34forks

How to install setup?

kazukinagata/shinkoku/setup

$npx -y skills add kazukinagata/shinkoku --skill setup

Installs into the current project.

Summary

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を作り直す".

Files · 1

View on GitHub

SKILL.md

1	# セットアップウィザード（Setup Wizard）
2
3	shinkoku の初回セットアップを対話的に行うスキル。
4	設定ファイル（`shinkoku.config.yaml`）の生成とデータベースの初期化を実施する。
5
6	## ステップ0: CLI のインストール確認
7
8	`shinkoku` コマンドが利用可能か確認する。
9
10	1. `shinkoku --version` を実行する
11	2. コマンドが存在しない場合: `uv tool install git+https://github.com/kazukinagata/shinkoku` を実行してインストールする
12	3. コマンドが存在する場合: `uv tool upgrade shinkoku` を実行して最新版に更新する
13
14	## ステップ1: 既存設定の確認
15
16	CWD の `shinkoku.config.yaml` を Read ツールで読み込む。
17
18	- ファイルが存在する場合: 内容を表示し、更新するか確認する。更新しない場合はスキルを終了する。
19	- ファイルが存在しない場合: セットアップウィザードを開始する。
20
21	## ステップ2: 基本設定のヒアリング
22
23	以下の項目を AskUserQuestion で確認する:
24
25	### 2-1. 対象年度
26
27	- `tax_year`: 確定申告の対象年度（デフォルト: 2025）
28
29	### 2-1b. 事業所得の有無
30
31	- `has_business_income`: 事業所得（副業含む）の有無（true / false）
32
33	事業所得がない場合、以下のステップをスキップする:
34	- 2-2（インボイス登録番号）
35	- 2.6-3（事業所住所）
36	- 2.7（事業情報）
37	- 2.8 の申告の種類（blue/white）・記帳方法の質問（給与所得のみなら不要）
38
39	### 2-2. 適格請求書発行事業者の登録番号（事業所得がある場合のみ）
40
41	- `invoice_registration_number`: T + 13桁の番号（任意、スキップ可）
42
43	## ステップ2.5: 納税者情報のヒアリング
44
45	以下の項目を AskUserQuestion で段階的に確認する。すべて任意（スキップ可能）だが、確定申告書等作成コーナーへの入力や人的控除の判定に使用される。
46
47	### 2.5-1. 氏名
48
49	- `taxpayer.last_name`: 姓
50	- `taxpayer.first_name`: 名
51	- `taxpayer.last_name_kana`: 姓（カタカナ）
52	- `taxpayer.first_name_kana`: 名（カタカナ）
53
54	### 2.5-2. 基本情報
55
56	- `taxpayer.gender`: 性別（male / female）
57	- `taxpayer.date_of_birth`: 生年月日（YYYY-MM-DD）
58	- `taxpayer.phone`: 電話番号
59	- `taxpayer.relationship_to_head`: 世帯主との続柄（本人/妻/夫/子等）
60
61	### 2.5-3. マイナンバー
62
63	- `taxpayer.my_number`: マイナンバー12桁（取扱注意 — config に保存するが、ツール出力やログには一切表示しない）
64
65	### 2.5-4. 人的控除に関する状態（任意）
66
67	- `taxpayer.widow_status`: 寡婦/ひとり親の区分（none / widow / single_parent）
68	- `taxpayer.disability_status`: 障害者の区分（none / general / special）
69	- `taxpayer.working_student`: 勤労学生に該当するか（true / false）
70
71	## ステップ2.6: 住所情報のヒアリング
72
73	### 2.6-1. 自宅住所
74
75	- `address.postal_code`: 郵便番号
76	- `address.prefecture`: 都道府県
77	- `address.city`: 市区町村
78	- `address.street`: 番地
79	- `address.building`: 建物名・部屋番号（任意）
80
81	### 2.6-2. 1月1日時点の住所（異なる場合のみ）
82
83	- `address.jan1_address`: 1/1 時点の住所（住民税の課税自治体判定に使用）
84
85	### 2.6-3. 事業所住所（事業所得がある場合のみ。自宅と異なる場合のみ）
86
87	- `business_address.postal_code` 〜 `business_address.building`
88
89	## ステップ2.7: 事業情報のヒアリング
90
91	事業所得がある場合に確認する。
92
93	- `business.trade_name`: 屋号
94	- `business.industry_type`: 業種
95	- `business.business_description`: 事業内容
96	- `business.establishment_year`: 開業年
97
98	## ステップ2.8: 申告方法の確認
99
100	以下の項目を順に確認し、青色申告特別控除額を自動判定する。
101
102	### ヒアリング項目
103
104	- `filing.submission_method`: 提出方法（e-tax / mail / in-person）
105	- mail / in-person を選択した場合、選択直後に以下を伝える:
106	> このプラグインの帳簿管理・税額計算機能はご利用いただけますが、確定申告書等作成コーナーへの自動入力（`/e-tax` スキル）は e-Tax 提出専用のため利用できません。作成コーナーへの入力はご自身で行っていただく必要があります。
107	- e-tax を選択した場合は通知不要（フルサポート）
108	- `filing.return_type`: 申告の種類（blue / white）— 事業所得がある場合のみ質問する（事業所得がない場合はスキップ）
109	- white を選択した場合、選択直後に以下を伝える:
110	> 白色申告に対応しています。決算書コーナーでは収支内訳書を使用します。なお、帳簿機能は複式簿記ベースで設計されているため、白色申告に必要な水準以上の記帳が行われます。
111	- blue を選択した場合は通知不要
112	- `filing.tax_office_name`: 所轄税務署名
113
114	### 青色申告特別控除の自動判定フロー
115
116	`return_type` が `blue` の場合、以下のフローで控除額を判定する:
117
118	1. 記帳方法を聞く（複式簿記 / 簡易帳簿）
119	2. 簡易帳簿の場合 → `simple_bookkeeping: true`、控除額 = 100,000円で確定
120	3. 複式簿記の場合:
121	- e-Tax提出 (`submission_method: e-tax`) → 控除額 = 650,000円で確定（`electronic_bookkeeping` は不問）
122	- 書面提出 (`submission_method: mail` or `in-person`) → `electronic_bookkeeping` を聞く
123	- `true`（優良な電子帳簿保存あり） → 控除額 = 650,000円
124	- true を選択した場合、選択直後に以下を伝える:
125	> 優良な電子帳簿保存の適用には、あらかじめ「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出する必要があります。届出書の様式は国税庁ウェブサイトからダウンロードできます。
126	> 令和9年分から適用する場合は、令和8年中に届出書を提出してください。
127	> なお、届出済みかどうかの確認や、システムの要件充足状況の診断は `/e-bookkeeping-compliance` スキルで実行できます。
128	- `false` → 控除額 = 550,000円
129
130	4. 判定結果をユーザーに表示して確認する
131
132	### 関連フィールド
133
134	- `filing.blue_return_deduction`: 青色申告特別控除額（自動判定される。手動指定も可）
135	- 650,000: 複式簿記 + (e-Tax提出又は電子帳簿保存) + 期限内申告
136	- 550,000: 複式簿記 + 書面提出 + 期限内申告（e-Tax/電子帳簿保存なし）
137	- 100,000: 簡易帳簿又は期限後申告
138	- `filing.simple_bookkeeping`: 簡易帳簿かどうか（true / false、デフォルト: false）
139	- `filing.electronic_bookkeeping`: 優良な電子帳簿保存の有無（true / false）。e-Tax提出の場合は不問（65万円控除にはe-Taxだけで十分）
140
141	## ステップ2.9: 控除・申告に影響する重要事項の確認（スキップ不可）
142
143	以下の項目は所得税額・住民税に大きく影響するため、全項目について必ず確認する。
144	「該当なし」も含め、明示的な回答を得ること。未確認のまま次のステップに進んではならない。
145
146	### 2.9-1. 家族構成（配偶者・扶養親族）
147
148	以下を確認し、config に保存する。詳細（所得金額・障害区分等）は `/income-tax` で登録する。
149
150	- `family.has_spouse`: 配偶者の有無（true / false）
151	- true の場合:
152	- 配偶者の年間所得（概算）を確認し、配偶者控除/特別控除の適用可能性を把握する
153	- 所得48万円以下 → 配偶者控除、48万〜133万円 → 配偶者特別控除
154	- 事業専従者かどうか: 青色事業専従者として給与を受けている配偶者は配偶者控除の対象外
155	- `family.has_dependents`: 扶養親族の有無（true / false）
156	- true の場合: 人数と概要（子・親など）を確認する
157	- 16歳未満の子供も含める: 扶養控除は対象外だが、住民税の非課税判定・均等割判定に
158	必要なため、申告書第二表「住民税に関する事項」に記載が必要
159	- 事業専従者は除外: 青色事業専従者・白色事業専従者は扶養親族に該当しない
160	- `family.dependent_count`: 扶養親族の人数（16歳未満を含む）
161
162	※ 配偶者・扶養親族のマイナンバーは `/income-tax` スキルのステップ1.5 で収集する。
163
164	### 2.9-2. 住宅ローン控除
165
166	- `housing_loan.applicable`: 住宅ローン控除の適用有無（true / false）

People who liked this also viewed

6 picks

Type

setup

348stars34forks

View on GitHub

How to install setup?

kazukinagata/shinkoku/setup

$npx -y skills add kazukinagata/shinkoku --skill setup

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# セットアップウィザード（Setup Wizard）
2
3	shinkoku の初回セットアップを対話的に行うスキル。
4	設定ファイル（`shinkoku.config.yaml`）の生成とデータベースの初期化を実施する。
5
6	## ステップ0: CLI のインストール確認
7
8	`shinkoku` コマンドが利用可能か確認する。
9
10	1. `shinkoku --version` を実行する
11	2. コマンドが存在しない場合: `uv tool install git+https://github.com/kazukinagata/shinkoku` を実行してインストールする
12	3. コマンドが存在する場合: `uv tool upgrade shinkoku` を実行して最新版に更新する
13
14	## ステップ1: 既存設定の確認
15
16	CWD の `shinkoku.config.yaml` を Read ツールで読み込む。
17
18	- ファイルが存在する場合: 内容を表示し、更新するか確認する。更新しない場合はスキルを終了する。
19	- ファイルが存在しない場合: セットアップウィザードを開始する。
20
21	## ステップ2: 基本設定のヒアリング
22
23	以下の項目を AskUserQuestion で確認する:
24
25	### 2-1. 対象年度
26
27	- `tax_year`: 確定申告の対象年度（デフォルト: 2025）
28
29	### 2-1b. 事業所得の有無
30
31	- `has_business_income`: 事業所得（副業含む）の有無（true / false）
32
33	事業所得がない場合、以下のステップをスキップする:
34	- 2-2（インボイス登録番号）
35	- 2.6-3（事業所住所）
36	- 2.7（事業情報）
37	- 2.8 の申告の種類（blue/white）・記帳方法の質問（給与所得のみなら不要）
38
39	### 2-2. 適格請求書発行事業者の登録番号（事業所得がある場合のみ）
40
41	- `invoice_registration_number`: T + 13桁の番号（任意、スキップ可）
42
43	## ステップ2.5: 納税者情報のヒアリング
44
45	以下の項目を AskUserQuestion で段階的に確認する。すべて任意（スキップ可能）だが、確定申告書等作成コーナーへの入力や人的控除の判定に使用される。
46
47	### 2.5-1. 氏名
48
49	- `taxpayer.last_name`: 姓
50	- `taxpayer.first_name`: 名
51	- `taxpayer.last_name_kana`: 姓（カタカナ）
52	- `taxpayer.first_name_kana`: 名（カタカナ）
53
54	### 2.5-2. 基本情報
55
56	- `taxpayer.gender`: 性別（male / female）
57	- `taxpayer.date_of_birth`: 生年月日（YYYY-MM-DD）
58	- `taxpayer.phone`: 電話番号
59	- `taxpayer.relationship_to_head`: 世帯主との続柄（本人/妻/夫/子等）
60
61	### 2.5-3. マイナンバー
62
63	- `taxpayer.my_number`: マイナンバー12桁（取扱注意 — config に保存するが、ツール出力やログには一切表示しない）
64
65	### 2.5-4. 人的控除に関する状態（任意）
66
67	- `taxpayer.widow_status`: 寡婦/ひとり親の区分（none / widow / single_parent）
68	- `taxpayer.disability_status`: 障害者の区分（none / general / special）
69	- `taxpayer.working_student`: 勤労学生に該当するか（true / false）
70
71	## ステップ2.6: 住所情報のヒアリング
72
73	### 2.6-1. 自宅住所
74
75	- `address.postal_code`: 郵便番号
76	- `address.prefecture`: 都道府県
77	- `address.city`: 市区町村
78	- `address.street`: 番地
79	- `address.building`: 建物名・部屋番号（任意）
80
81	### 2.6-2. 1月1日時点の住所（異なる場合のみ）
82
83	- `address.jan1_address`: 1/1 時点の住所（住民税の課税自治体判定に使用）
84
85	### 2.6-3. 事業所住所（事業所得がある場合のみ。自宅と異なる場合のみ）
86
87	- `business_address.postal_code` 〜 `business_address.building`
88
89	## ステップ2.7: 事業情報のヒアリング
90
91	事業所得がある場合に確認する。
92
93	- `business.trade_name`: 屋号
94	- `business.industry_type`: 業種
95	- `business.business_description`: 事業内容
96	- `business.establishment_year`: 開業年
97
98	## ステップ2.8: 申告方法の確認
99
100	以下の項目を順に確認し、青色申告特別控除額を自動判定する。
101
102	### ヒアリング項目
103
104	- `filing.submission_method`: 提出方法（e-tax / mail / in-person）
105	- mail / in-person を選択した場合、選択直後に以下を伝える:
106	> このプラグインの帳簿管理・税額計算機能はご利用いただけますが、確定申告書等作成コーナーへの自動入力（`/e-tax` スキル）は e-Tax 提出専用のため利用できません。作成コーナーへの入力はご自身で行っていただく必要があります。
107	- e-tax を選択した場合は通知不要（フルサポート）
108	- `filing.return_type`: 申告の種類（blue / white）— 事業所得がある場合のみ質問する（事業所得がない場合はスキップ）
109	- white を選択した場合、選択直後に以下を伝える:
110	> 白色申告に対応しています。決算書コーナーでは収支内訳書を使用します。なお、帳簿機能は複式簿記ベースで設計されているため、白色申告に必要な水準以上の記帳が行われます。
111	- blue を選択した場合は通知不要
112	- `filing.tax_office_name`: 所轄税務署名
113
114	### 青色申告特別控除の自動判定フロー
115
116	`return_type` が `blue` の場合、以下のフローで控除額を判定する:
117
118	1. 記帳方法を聞く（複式簿記 / 簡易帳簿）
119	2. 簡易帳簿の場合 → `simple_bookkeeping: true`、控除額 = 100,000円で確定
120	3. 複式簿記の場合:
121	- e-Tax提出 (`submission_method: e-tax`) → 控除額 = 650,000円で確定（`electronic_bookkeeping` は不問）
122	- 書面提出 (`submission_method: mail` or `in-person`) → `electronic_bookkeeping` を聞く
123	- `true`（優良な電子帳簿保存あり） → 控除額 = 650,000円
124	- true を選択した場合、選択直後に以下を伝える:
125	> 優良な電子帳簿保存の適用には、あらかじめ「国税関係帳簿の電磁的記録等による保存等に係る届出書」を所轄税務署に提出する必要があります。届出書の様式は国税庁ウェブサイトからダウンロードできます。
126	> 令和9年分から適用する場合は、令和8年中に届出書を提出してください。
127	> なお、届出済みかどうかの確認や、システムの要件充足状況の診断は `/e-bookkeeping-compliance` スキルで実行できます。
128	- `false` → 控除額 = 550,000円
129
130	4. 判定結果をユーザーに表示して確認する
131
132	### 関連フィールド
133
134	- `filing.blue_return_deduction`: 青色申告特別控除額（自動判定される。手動指定も可）
135	- 650,000: 複式簿記 + (e-Tax提出又は電子帳簿保存) + 期限内申告
136	- 550,000: 複式簿記 + 書面提出 + 期限内申告（e-Tax/電子帳簿保存なし）
137	- 100,000: 簡易帳簿又は期限後申告
138	- `filing.simple_bookkeeping`: 簡易帳簿かどうか（true / false、デフォルト: false）
139	- `filing.electronic_bookkeeping`: 優良な電子帳簿保存の有無（true / false）。e-Tax提出の場合は不問（65万円控除にはe-Taxだけで十分）
140
141	## ステップ2.9: 控除・申告に影響する重要事項の確認（スキップ不可）
142
143	以下の項目は所得税額・住民税に大きく影響するため、全項目について必ず確認する。
144	「該当なし」も含め、明示的な回答を得ること。未確認のまま次のステップに進んではならない。
145
146	### 2.9-1. 家族構成（配偶者・扶養親族）
147
148	以下を確認し、config に保存する。詳細（所得金額・障害区分等）は `/income-tax` で登録する。
149
150	- `family.has_spouse`: 配偶者の有無（true / false）
151	- true の場合:
152	- 配偶者の年間所得（概算）を確認し、配偶者控除/特別控除の適用可能性を把握する
153	- 所得48万円以下 → 配偶者控除、48万〜133万円 → 配偶者特別控除
154	- 事業専従者かどうか: 青色事業専従者として給与を受けている配偶者は配偶者控除の対象外
155	- `family.has_dependents`: 扶養親族の有無（true / false）
156	- true の場合: 人数と概要（子・親など）を確認する
157	- 16歳未満の子供も含める: 扶養控除は対象外だが、住民税の非課税判定・均等割判定に
158	必要なため、申告書第二表「住民税に関する事項」に記載が必要
159	- 事業専従者は除外: 青色事業専従者・白色事業専従者は扶養親族に該当しない
160	- `family.dependent_count`: 扶養親族の人数（16歳未満を含む）
161
162	※ 配偶者・扶養親族のマイナンバーは `/income-tax` スキルのステップ1.5 で収集する。
163
164	### 2.9-2. 住宅ローン控除
165
166	- `housing_loan.applicable`: 住宅ローン控除の適用有無（true / false）

People who liked this also viewed

6 picks

Type