settlement

決算整理・決算書作成（Year-End Settlement）

会計年度末の決算整理仕訳を登録し、残高試算表・損益計算書・貸借対照表を確認するスキル。 journal スキルで日常仕訳の入力が完了していることを前提とする。

設定の読み込み（最初に実行）

1. shinkoku.config.yaml を Read ツールで読み込む
2. ファイルが存在しない場合は /setup スキルの実行を案内して終了する
3. 設定値を把握し、相対パスは CWD を基準に絶対パスに変換する:
   • db_path: CLI スクリプトの --db-path 引数に使用
   • output_dir: 進捗ファイル等の出力先ベースディレクトリ
   • 各ディレクトリ: ファイル参照時に使用

パス解決の例

config の db_path が ./shinkoku.db、output_dir が ./output で CWD が /home/user/tax-2025/ の場合:

• ledger.py trial-balance --db-path /home/user/tax-2025/shinkoku.db --input query.json
• shinkoku ledger bs --db-path /home/user/tax-2025/shinkoku.db --input query.json

進捗情報の読み込み

設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。

1. .shinkoku/progress/progress-summary.md を Read ツールで読み込む（存在する場合）
2. 以下の引継書を Read ツールで読み込む（存在する場合）:
   • .shinkoku/progress/04-journal.md
   • .shinkoku/progress/02-assess.md
3. 読み込んだ情報を以降のステップで活用する（ユーザーへの再質問を避ける）
4. ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する

基本方針

• journal スキルでの仕訳入力が完了しているか確認してから開始する
• 残高試算表で勘定残高を確認し、決算整理仕訳の必要性を判定する
• 減価償却は references/depreciation-rules.md のルールに基づいて計算する
• 決算整理仕訳も登録前に必ずユーザーに確認する
• 最終的に貸借対照表の貸借一致を検証する

前提条件の確認

決算処理を開始する前に以下を確認する:

1. 日常仕訳が完了しているか: 未記帳の取引がないか確認を促す
2. 会計年度: 対象年度を確認する（例: 2025年1月1日〜12月31日）
3. 青色申告の種類: 65万円控除（複式簿記 + e-Tax/電子帳簿保存）、55万円控除（複式簿記 + 書面提出）、10万円控除（簡易帳簿）
4. 前年確定申告の確認: 以下を assess の結果または前年の申告書から確認する
   • 予定納税の有無と金額（所得税の前払い）
   • 純損失の繰越控除の有無
   • 前年の期末残高（当年の期首残高と一致するか）
   • 前年の減価償却累計額（固定資産がある場合）

※ 前年データが未確認の場合は、先に assess スキルで確認するか、 ユーザーに前年の確定申告書を提示してもらう。

0-1. 期首残高の確認・設定

1. ledger.py ob-list --db-path DB --fiscal-year YEAR で期首残高が設定済みか確認
2. 未設定の場合、ユーザーに以下を確認:
   • 開業初年度か？（→ 期首残高なし、スキップ）
   • 前年の確定申告書（青色申告決算書の貸借対照表）の期末列を提示してもらう
   • 画像/PDFの場合は OCR で読み取り
3. 前年の期末残高を ob-set-batch で一括登録
4. 登録後、ob-list で内容を確認し、ユーザーに承認を得る

ステップ1: 残高試算表の確認

ledger.py trial-balance の呼び出し

shinkoku ledger trial-balance --db-path DB_PATH --input query.json

入力 JSON:

{
  "fiscal_year": 2025
}

出力:

• accounts: 各勘定科目の借方合計・貸方合計・残高
• total_debit: 借方合計
• total_credit: 貸方合計