setup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

Setup Wizard

shinkoku の初回セットアップを対話的に行うスキル。設定ファイル（

shinkoku.config.yaml

）の生成とデータベースの初期化を実施する。

This skill guides users through interactive initial setup of shinkoku. It generates the configuration file (

shinkoku.config.yaml

) and initializes the database.

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

Step 0: Verify CLI Installation

shinkoku

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

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

Check if the

shinkoku

command is available.

Run
```
shinkoku --version
```

If the command does not exist: Install it by running

uv tool install git+https://github.com/kazukinagata/shinkoku

If the command exists: Update to the latest version by running
```
uv tool upgrade shinkoku
```

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

Step 1: Check Existing Configuration

CWD の

shinkoku.config.yaml

を Read ツールで読み込む。

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

Read the

shinkoku.config.yaml

in the current working directory (CWD) using the Read tool.

If the file exists: Display its content and confirm if the user wants to update it. Exit the skill if no update is needed.
If the file does not exist: Start the setup wizard.

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

Step 2: Collect Basic Settings

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

Confirm the following items using the AskUserQuestion tool:

2-1. 対象年度

2-1. Target Tax Year

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

```
tax_year
```
: The target year for final tax return (default: 2025)

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

2-1b. Presence of Business Income

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

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

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

```
has_business_income
```
: Whether the user has business income (including side jobs) (true / false)

If there is no business income, skip the following steps:

2-2 (Invoice Registration Number)
2.6-3 (Business Address)
2.7 (Business Information)
Questions about return type (blue/white) and bookkeeping method in 2.8 (not required if only salary income)

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

2-2. Qualified Invoice Issuer Registration Number (Only if there is business income)

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

```
invoice_registration_number
```
: Number starting with T followed by 13 digits (optional, can be skipped)

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

Step 2.5: Collect Taxpayer Information

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

Confirm the following items step by step using the AskUserQuestion tool. All items are optional (can be skipped), but they are used for inputting data into the final tax return preparation corner and determining personal deductions.

2.5-1. 氏名

2.5-1. Full Name

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

```
taxpayer.last_name
```
: Last name
```
taxpayer.first_name
```
: First name
```
taxpayer.last_name_kana
```
: Last name (in katakana)
```
taxpayer.first_name_kana
```
: First name (in katakana)

2.5-2. 基本情報

2.5-2. Basic Information

```
taxpayer.gender
```
: 性別（male / female）
```
taxpayer.date_of_birth
```
: 生年月日（YYYY-MM-DD）
```
taxpayer.phone
```
: 電話番号
```
taxpayer.relationship_to_head
```
: 世帯主との続柄（本人/妻/夫/子等）

```
taxpayer.gender
```
: Gender (male / female)
```
taxpayer.date_of_birth
```
: Date of birth (YYYY-MM-DD)
```
taxpayer.phone
```
: Phone number
```
taxpayer.relationship_to_head
```
: Relationship to the head of household (self/wife/husband/child, etc.)

2.5-3. マイナンバー

2.5-3. My Number

```
taxpayer.my_number
```
: マイナンバー12桁（取扱注意 — config に保存するが、ツール出力やログには一切表示しない）

```
taxpayer.my_number
```
: 12-digit My Number (Note — stored in config, but never displayed in tool outputs or logs)

2.5-4. 人的控除に関する状態（任意）

2.5-4. Status Related to Personal Deductions (Optional)

```
taxpayer.widow_status
```
: 寡婦/ひとり親の区分（none / widow / single_parent）
```
taxpayer.disability_status
```
: 障害者の区分（none / general / special）
```
taxpayer.working_student
```
: 勤労学生に該当するか（true / false）

```
taxpayer.widow_status
```
: Widow/single parent status (none / widow / single_parent)
```
taxpayer.disability_status
```
: Disability status (none / general / special)
```
taxpayer.working_student
```
: Whether the user qualifies as a working student (true / false)

ステップ2.6: 住所情報のヒアリング

Step 2.6: Collect Address Information

2.6-1. 自宅住所

2.6-1. Home Address

```
address.postal_code
```
: 郵便番号
```
address.prefecture
```
: 都道府県
```
address.city
```
: 市区町村
```
address.street
```
: 番地
```
address.building
```
: 建物名・部屋番号（任意）

```
address.postal_code
```
: Postal code
```
address.prefecture
```
: Prefecture
```
address.city
```
: City/ward/town/village
```
address.street
```
: Street address
```
address.building
```
: Building name and room number (optional)

2.6-2. 1月1日時点の住所（異なる場合のみ）

2.6-2. Address as of January 1 (Only if different from home address)

```
address.jan1_address
```
: 1/1 時点の住所（住民税の課税自治体判定に使用）

```
address.jan1_address
```
: Address as of January 1 (used to determine the municipality for resident tax)

2.6-3. 事業所住所（事業所得がある場合のみ。自宅と異なる場合のみ）

2.6-3. Business Address (Only if there is business income and different from home address)

business_address.postal_code

〜

business_address.building

business_address.postal_code

business_address.building

ステップ2.7: 事業情報のヒアリング

Step 2.7: Collect Business Information

事業所得がある場合に確認する。

```
business.trade_name
```
: 屋号
```
business.industry_type
```
: 業種
```
business.business_description
```
: 事業内容
```
business.establishment_year
```
: 開業年

Confirm these items only if there is business income.

```
business.trade_name
```
: Trade name
```
business.industry_type
```
: Industry type
```
business.business_description
```
: Business description
```
business.establishment_year
```
: Year of establishment

ステップ2.8: 申告方法の確認

Step 2.8: Confirm Filing Method

以下の項目を順に確認し、青色申告特別控除額を自動判定する。

Confirm the following items in order and automatically determine the blue return special deduction amount.

ヒアリング項目

Collected Items

```
filing.submission_method
```
: 提出方法（e-tax / mail / in-person）
- mail / in-person を選択した場合、選択直後に以下を伝える:
  このプラグインの帳簿管理・税額計算機能はご利用いただけますが、確定申告書等作成コーナーへの自動入力（
  /e-tax
  スキル）は e-Tax 提出専用のため利用できません。作成コーナーへの入力はご自身で行っていただく必要があります。
- e-tax を選択した場合は通知不要（フルサポート）
```
filing.return_type
```
: 申告の種類（blue / white）— 事業所得がある場合のみ質問する（事業所得がない場合はスキップ）
- white を選択した場合、選択直後に以下を伝える:
  
  白色申告に対応しています。決算書コーナーでは収支内訳書を使用します。なお、帳簿機能は複式簿記ベースで設計されているため、白色申告に必要な水準以上の記帳が行われます。
- blue を選択した場合は通知不要
```
filing.tax_office_name
```
: 所轄税務署名

```
filing.submission_method
```
: Submission method (e-tax / mail / in-person)
- If mail / in-person is selected:
  You can use the bookkeeping and tax calculation functions of this plugin, but the automatic input to the final tax return preparation corner (the
  /e-tax
  skill) is only available for e-Tax submissions. You will need to manually input the data into the preparation corner.
- No notification is needed if e-tax is selected (full support provided)
```
filing.return_type
```
: Return type (blue / white) — Only ask this if there is business income (skip if no business income)
- If white is selected:
  
  White return is supported. The balance sheet corner uses the income and expense breakdown sheet. Note that the bookkeeping function is designed based on double-entry bookkeeping, so the level of bookkeeping will exceed what is required for white returns.
- No notification is needed if blue is selected
```
filing.tax_office_name
```
: Name of the competent tax office

青色申告特別控除の自動判定フロー

Automatic Determination Flow for Blue Return Special Deduction

return_type

が

blue

の場合、以下のフローで控除額を判定する:

記帳方法を聞く（複式簿記 / 簡易帳簿）
簡易帳簿の場合 →
```
simple_bookkeeping: true
```
、控除額 = 100,000円で確定
複式簿記の場合:
- e-Tax提出 (
```
submission_method: e-tax
```
  ) → 控除額 = 650,000円で確定（
```
electronic_bookkeeping
```
  は不問）
- 書面提出 (
```
submission_method: mail
```
  or
```
in-person
```
  ) →
```
electronic_bookkeeping
```
  を聞く
  - ```
  true
```
  （優良な電子帳簿保存あり） → 控除額 = 650,000円
- ```
false
```
    → 控除額 = 550,000円
判定結果をユーザーに表示して確認する

return_type

blue

, determine the deduction amount using the following flow:

Ask about the bookkeeping method (double-entry bookkeeping / simplified bookkeeping)
If simplified bookkeeping → set
```
simple_bookkeeping: true
```
, deduction amount = 100,000 JPY
If double-entry bookkeeping:
- If e-Tax submission (
```
submission_method: e-tax
```
  ) → deduction amount = 650,000 JPY (regardless of
```
electronic_bookkeeping
```
  )
- If paper submission (
```
submission_method: mail
```
  or
```
in-person
```
  ) → ask about
```
electronic_bookkeeping
```
  - ```
  true
```
  (with excellent electronic bookkeeping storage) → deduction amount = 650,000 JPY
- ```
false
```
    → deduction amount = 550,000 JPY
Display the determination result to the user for confirmation

Related Fields

```
filing.blue_return_deduction
```
: 青色申告特別控除額（自動判定される。手動指定も可）
- 650,000: 複式簿記 + (e-Tax提出又は電子帳簿保存) + 期限内申告
- 550,000: 複式簿記 + 書面提出 + 期限内申告（e-Tax/電子帳簿保存なし）
- 100,000: 簡易帳簿又は期限後申告
```
filing.simple_bookkeeping
```
: 簡易帳簿かどうか（true / false、デフォルト: false）
```
filing.electronic_bookkeeping
```
: 優良な電子帳簿保存の有無（true / false）。e-Tax提出の場合は不問（65万円控除にはe-Taxだけで十分）

```
filing.blue_return_deduction
```
: Blue return special deduction amount (automatically determined, can also be specified manually)
- 650,000: Double-entry bookkeeping + (e-Tax submission or electronic bookkeeping storage) + filed by deadline
- 550,000: Double-entry bookkeeping + paper submission + filed by deadline (no e-Tax/electronic bookkeeping storage)
- 100,000: Simplified bookkeeping or filed after deadline
```
filing.simple_bookkeeping
```
: Whether simplified bookkeeping is used (true / false, default: false)
```
filing.electronic_bookkeeping
```
: Whether excellent electronic bookkeeping storage is available (true / false). Not required for e-Tax submissions (e-Tax alone is sufficient for the 650,000 JPY deduction)

ステップ2.9: 控除・申告に影響する重要事項の確認（スキップ不可）

Step 2.9: Confirm Important Matters Affecting Deductions and Filing (Mandatory)

以下の項目は所得税額・住民税に大きく影響するため、全項目について必ず確認する。「該当なし」も含め、明示的な回答を得ること。未確認のまま次のステップに進んではならない。

The following items significantly impact income tax and resident tax amounts, so all items must be confirmed. Obtain an explicit response, including if the item is not applicable. Do not proceed to the next step without confirmation.

2.9-1. 家族構成（配偶者・扶養親族）

2.9-1. Family Composition (Spouse / Dependents)

以下を確認し、config に保存する。詳細（所得金額・障害区分等）は

/income-tax

で登録する。

```
family.has_spouse
```
: 配偶者の有無（true / false）
- true の場合:
  - 配偶者の年間所得（概算）を確認し、配偶者控除/特別控除の適用可能性を把握する
  - 所得48万円以下 → 配偶者控除、48万〜133万円 → 配偶者特別控除
  - 事業専従者かどうか: 青色事業専従者として給与を受けている配偶者は配偶者控除の対象外
```
family.has_dependents
```
: 扶養親族の有無（true / false）
- true の場合: 人数と概要（子・親など）を確認する
- 16歳未満の子供も含める: 扶養控除は対象外だが、住民税の非課税判定・均等割判定に必要なため、申告書第二表「住民税に関する事項」に記載が必要
- 事業専従者は除外: 青色事業専従者・白色事業専従者は扶養親族に該当しない
```
family.dependent_count
```
: 扶養親族の人数（16歳未満を含む）

※ 配偶者・扶養親族のマイナンバーは

/income-tax

スキルのステップ1.5 で収集する。

Confirm the following and save to config. Details (income amount, disability status, etc.) are registered using the

/income-tax

skill.

```
family.has_spouse
```
: Whether the user has a spouse (true / false)
- If true:
  - Confirm the spouse's approximate annual income to determine eligibility for spouse deduction/special spouse deduction
  - Income ≤ 480,000 JPY → Spouse deduction; 480,000 - 1,330,000 JPY → Special spouse deduction
  - Whether the spouse is a full-time business employee: Spouses receiving salaries as blue return full-time business employees are not eligible for spouse deduction
```
family.has_dependents
```
: Whether the user has dependents (true / false)
- If true: Confirm the number of dependents and their overview (children / parents, etc.)
- Include children under 16: Although they are not eligible for dependent deduction, they are required for non-taxable determination and flat-rate tax determination for resident tax, so must be listed in the second table of the tax return "Matters related to resident tax"
- Exclude full-time business employees: Blue return full-time business employees and white return full-time business employees do not qualify as dependents
```
family.dependent_count
```
: Number of dependents (including those under 16)

My Number of spouse and dependents is collected in Step 1.5 of the
/income-tax
skill.

2.9-2. 住宅ローン控除

2.9-2. Housing Loan Deduction

```
housing_loan.applicable
```
: 住宅ローン控除の適用有無（true / false）
- true の場合:
  - ```
  housing_loan.first_year
```
  : 初年度かどうか（true / false）
- 初年度 →
```
  /income-tax
```
  のステップ3.7 で計算明細書を作成する（添付書類が別途必要）
- 2年目以降 → 年末調整で適用済みなら確定申告での追加手続きは原則不要

```
housing_loan.applicable
```
: Whether housing loan deduction applies (true / false)
- If true:
  - ```
  housing_loan.first_year
```
  : Whether it is the first year (true / false)
- First year: Create a calculation statement in Step 3.7 of
```
  /income-tax
```
  (additional documents are required)
- From the second year onward: No additional procedures are generally required in the final tax return if the deduction was applied in year-end adjustment

2.9-3. 予定納税

2.9-3. Estimated Tax

```
estimated_tax.applicable
```
: 予定納税の有無（true / false）
- 判定基準: 前年の確定申告書の㊺欄（申告納税額）が 15万円以上 → 予定納税あり
- true の場合:
  - ```
  estimated_tax.amount
```
  : 予定納税の合計額（第1期 + 第2期、int 円）を確認する
- 減額申請をした場合は減額後の金額を記入する

```
estimated_tax.applicable
```
: Whether estimated tax is applicable (true / false)
- Criteria: If the declared tax amount in box ㊺ of the previous year's final tax return is 150,000 JPY or more → Estimated tax applies
- If true:
  - ```
  estimated_tax.amount
```
  : Total estimated tax amount (1st installment + 2nd installment, in JPY as integer)
- If a reduction application was submitted, enter the amount after reduction

2.9-4. 世帯主の氏名（本人でない場合）

2.9-4. Name of Head of Household (If not the user)

ステップ2.5-2 で

relationship_to_head

が「本人」以外の場合:

```
taxpayer.household_head_name
```
: 世帯主の氏名を確認する（申告書に記載が必要）

relationship_to_head

in Step 2.5-2 is not "self":

```
taxpayer.household_head_name
```
: Confirm the name of the head of household (required for the tax return)

ステップ3: パス設定

Step 3: Path Settings

以下のパスを確認する。デフォルト値を提示し、変更がなければそのまま採用する。

```
db_path
```
: データベースファイルのパス（デフォルト:
```
./shinkoku.db
```
）
```
output_dir
```
: 進捗ファイル等の出力先ディレクトリ（デフォルト:
```
./output
```
）

Confirm the following paths. Present default values and use them if no changes are requested.

```
db_path
```
: Path to the database file (default:
```
./shinkoku.db
```
)
```
output_dir
```
: Output directory for progress files, etc. (default:
```
./output
```
)

ステップ4: 書類ディレクトリの設定（任意）

Step 4: Set Document Directories (Optional)

以下のディレクトリを設定するか確認する。スキップ可能。

```
invoices_dir
```
: 請求書PDF等のディレクトリ
```
withholding_slips_dir
```
: 源泉徴収票のディレクトリ
```
receipts_dir
```
: レシート・領収書のディレクトリ
```
bank_statements_dir
```
: 銀行明細CSVのディレクトリ
```
credit_card_statements_dir
```
: クレジットカード明細CSVのディレクトリ
```
deductions_dir
```
: 控除関連書類のディレクトリ
```
past_returns_dir
```
: 過去の確定申告データのディレクトリ

Confirm whether to set up the following directories. Can be skipped.

```
invoices_dir
```
: Directory for invoice PDFs, etc.
```
withholding_slips_dir
```
: Directory for withholding slips
```
receipts_dir
```
: Directory for receipts
```
bank_statements_dir
```
: Directory for bank statement CSVs
```
credit_card_statements_dir
```
: Directory for credit card statement CSVs
```
deductions_dir
```
: Directory for deduction-related documents
```
past_returns_dir
```
: Directory for past final tax return data

ステップ5: 設定のプレビューと保存

Step 5: Preview and Save Configuration

収集した設定内容を YAML 形式でプレビュー表示する
ユーザーの確認を得る
Write ツールで CWD に
```
shinkoku.config.yaml
```
を保存する

YAML の形式は以下のテンプレートに従う:

yaml

undefined

Display a preview of the collected settings in YAML format
Obtain user confirmation
Save
```
shinkoku.config.yaml
```
to the CWD using the Write tool

Follow this YAML template:

yaml

undefined

shinkoku ユーザー設定ファイル

shinkoku user configuration file

/setup スキルで対話的に生成できます。

Can be generated interactively using the /setup skill.

対象年度

Target tax year

tax_year: {tax_year}

事業所得の有無（副業含む）

Presence of business income (including side jobs)

has_business_income: {has_business_income}

データベースファイルのパス

Path to database file

db_path: {db_path}

進捗ファイル等の出力先ディレクトリ

Output directory for progress files, etc.

output_dir: {output_dir}

適格請求書発行事業者の登録番号（T + 13桁）

Qualified invoice issuer registration number (T + 13 digits)

invoice_registration_number: {invoice_registration_number}

--- 納税者情報 ---

--- Taxpayer Information ---

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 ---

address: postal_code: {postal_code} prefecture: {prefecture} city: {city} street: {street} building: {building} jan1_address: {jan1_address}

--- 事業所住所（自宅と異なる場合のみ） ---

--- Business Address (Only if different from home address) ---

business_address: postal_code: prefecture: city: street: building:

--- 事業情報 ---

--- Business Information ---

business: trade_name: {trade_name} industry_type: {industry_type} business_description: {business_description} establishment_year: {establishment_year}

--- 申告方法 ---

--- Filing Method ---

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 Composition ---

family: has_spouse: {has_spouse} has_dependents: {has_dependents} dependent_count: {dependent_count}

--- 住宅ローン控除 ---

--- Housing Loan Deduction ---

housing_loan: applicable: {applicable} first_year: {first_year}

--- 予定納税 ---

--- Estimated Tax ---

estimated_tax: applicable: {applicable} amount: {amount}

--- 書類ディレクトリ（任意） ---

--- Document Directories (Optional) ---

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}


未設定の項目は値を空にする（`key:` のみ）。

**`my_number` の取扱い**: マイナンバーは config YAML に保存するが、`profile.py` の出力では `has_my_number: true/false` のみ返す。ログ・会話には出力しない。確定申告書等作成コーナーへの入力時のみ config から直接読み取る。

```bash
shinkoku profile --config PATH


Leave unconfigured items empty (only `key:`).

**Handling of `my_number`**: My Number is saved in the config YAML, but only `has_my_number: true/false` is returned in the output of `profile.py`. Do not output it in logs or conversations. It is only read directly from the config when inputting data into the final tax return preparation corner.

```bash
shinkoku profile --config PATH

ステップ6: データベースの初期化

Step 6: Initialize Database

```
db_path
```
の値を確認し、相対パスの場合は CWD を基準に絶対パスに変換する
```
ledger.py init
```
コマンドでデータベースを初期化する:
bash
```
shinkoku ledger init --db-path DB --fiscal-year YEAR
```
- ```
--fiscal-year
```
  : ステップ2 で設定した
```
tax_year
```
- ```
--db-path
```
  : 絶対パスに変換した値

Confirm the
```
db_path
```
value; convert relative paths to absolute paths based on the CWD

Initialize the database using the

ledger.py init

command:

bash

shinkoku ledger init --db-path DB --fiscal-year YEAR

```
--fiscal-year
```
:
```
tax_year
```
set in Step 2
```
--db-path
```
: Value converted to absolute path

ステップ7: 次のステップの案内

Step 7: Guide to Next Steps

セットアップ完了後、以下を案内する:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
セットアップ完了
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ 生成されたファイル:
  → shinkoku.config.yaml（設定ファイル）
  → {db_path}（データベース）

■ 次のステップ:
  1. /assess — 申告要否・種類の判定
  2. /gather — 必要書類の確認・収集
  3. /journal — 仕訳入力・帳簿管理
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

After setup is completed, provide the following guidance:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Setup Completed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ Generated Files:
  → shinkoku.config.yaml (configuration file)
  → {db_path} (database)

■ Next Steps:
  1. /assess — Determine if filing is required and return type
  2. /gather — Confirm and collect required documents
  3. /journal — Enter journal entries and manage bookkeeping
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

引継書の出力

Output Handover Document

サマリー提示後、以下のファイルを Write ツールで出力する。これにより、セッションの中断や Compact が発生しても次のステップで結果を引き継げる。

After presenting the summary, output the following file using the Write tool. This allows the results to be carried over to the next step even if the session is interrupted or compacted.

ステップ別ファイルの出力

Output Step-by-Step File

.shinkoku/progress/01-setup.md

に以下の形式で出力する:

---
step: 1
skill: setup
status: completed
completed_at: "{当日日付 YYYY-MM-DD}"
fiscal_year: {tax_year}
---

Output to

.shinkoku/progress/01-setup.md

in the following format:

---
step: 1
skill: setup
status: completed
completed_at: "{current date YYYY-MM-DD}"
fiscal_year: {tax_year}
---

セットアップ結果

Setup Results

設定内容

Configuration Details

対象年度: {tax_year}
データベースパス: {db_path}
出力ディレクトリ: {output_dir}
インボイス登録番号: {invoice_registration_number}

Target Tax Year: {tax_year}
Database Path: {db_path}
Output Directory: {output_dir}
Invoice Registration Number: {invoice_registration_number}

納税者情報

Taxpayer Information

氏名: {last_name} {first_name}
生年月日: {date_of_birth}
マイナンバー: {登録済み/未登録}
寡婦/ひとり親: {widow_status}
障害者区分: {disability_status}
勤労学生: {working_student}
世帯主との続柄: {relationship_to_head}

Full Name: {last_name} {first_name}
Date of Birth: {date_of_birth}
My Number: Registered/Not Registered
Widow/Single Parent: {widow_status}
Disability Status: {disability_status}
Working Student: {working_student}
Relationship to Head of Household: {relationship_to_head}

住所

Address

自宅: {postal_code} {prefecture}{city}{street}{building}
1/1時点の住所: {jan1_address}（同上/異なる住所）
事業所住所: {設定あり/自宅と同じ}

Home Address: {postal_code} {prefecture}{city}{street}{building}
Address as of January 1: {jan1_address} (Same as home address/Different address)
Business Address: Configured/Same as home address

事業情報

Business Information

屋号: {trade_name}
業種: {industry_type}
事業内容: {business_description}

Trade Name: {trade_name}
Industry Type: {industry_type}
Business Description: {business_description}

申告方法

Filing Method

提出方法: {submission_method}
申告の種類: {return_type}
青色申告特別控除: {blue_return_deduction}円
所轄税務署: {tax_office_name}

Submission Method: {submission_method}
Return Type: {return_type}
Blue Return Special Deduction: {blue_return_deduction} JPY
Competent Tax Office: {tax_office_name}

控除・申告に影響する重要事項

Important Matters Affecting Deductions and Filing

配偶者: {あり（概算所得: ○万円）/ なし}
扶養親族: {あり（○人、うち16歳未満○人）/ なし}
住宅ローン控除: {適用あり（初年度/2年目以降）/ 適用なし}
予定納税: {あり（合計○円）/ なし}
世帯主: {本人 / ○○（氏名）}

Spouse: Yes (Approximate Income: ○0,000 JPY)/No
Dependents: Yes (○ people, including ○ under 16)/No
Housing Loan Deduction: Applicable (First Year/From Second Year)/Not Applicable
Estimated Tax: Applicable (Total ○ JPY)/Not Applicable
Head of Household: Self / ○○ (Name)

書類ディレクトリ

Document Directories

請求書: {invoices_dir}
源泉徴収票: {withholding_slips_dir}
レシート: {receipts_dir}
銀行明細: {bank_statements_dir}
クレカ明細: {credit_card_statements_dir}
控除関連: {deductions_dir}
過去の申告: {past_returns_dir}

Invoices: {invoices_dir}
Withholding Slips: {withholding_slips_dir}
Receipts: {receipts_dir}
Bank Statements: {bank_statements_dir}
Credit Card Statements: {credit_card_statements_dir}
Deduction-Related Documents: {deductions_dir}
Past Returns: {past_returns_dir}

DB初期化

DB Initialization

初期化結果: 成功
勘定科目マスタ: 登録済み

Initialization Result: Success
Chart of Accounts: Registered

次のステップ

Next Steps

/assess で申告要否・種類を判定する


未設定の項目は「未設定」と記載する。

Use /assess to determine if filing is required and return type


Mark unconfigured items as "Not Configured".

進捗サマリーの更新

Update Progress Summary

.shinkoku/progress/progress-summary.md

を新規作成する:

YAML frontmatter: fiscal_year、last_updated（当日日付）、current_step: setup
テーブル: 全ステップの状態を記載（setup を completed に、他は pending に）
次のステップの案内を記載

Create a new

.shinkoku/progress/progress-summary.md

YAML frontmatter: fiscal_year, last_updated (current date), current_step: setup
Table: Status of all steps (mark setup as completed, others as pending)
Guidance to next steps

出力後の案内

Guidance After Output

ファイルを出力したらユーザーに以下を伝える:

「引継書を
```
.shinkoku/progress/
```
に保存しました。セッションが中断しても次のスキルで結果を引き継げます。」
次のステップの案内

After outputting the file, inform the user:

"Handover document saved to
```
.shinkoku/progress/
```
. Results can be carried over to the next skill even if the session is interrupted."
Guidance to next steps