journallisted

# 仕訳入力・帳簿管理（Journal Entry & Ledger Management） CSV・レシート・請求書からデータを取り込み、ユーザー確認のうえ仕訳を登録するスキル。 帳簿の初期化、仕訳の検索・修正・削除も本スキルで対応する。 ## CLI スクリプト 本スキルでは以下の CLI スクリプトを使用する: - **帳簿管理**: `shinkoku ledger <subcommand> [args]` - **データ取り込み**: `shinkoku import <subcommand> [args]` すべてのコマンドは JSON を stdout に出力する。入力はコマンドライン引数または `--input <json_file>` で渡す。 ## 設定の読み込み（最初に実行） 1. `shinkoku.config.yaml` を Read ツールで読み込む 2. ファイルが存在しない場合は `/setup` スキルの実行を案内して終了する 3. 設定値を把握し、相対パスは CWD を基準に絶対パスに変換する: - `db_path`: CLI スクリプトの `--db-path` 引数に使用 - `output_dir`: 進捗ファイル等の出力先ベースディレクトリ - 各ディレクトリ: ファイル参照時に使用 ### パス解決の例（db_path） config の `db_path` が `./shinkoku.db` で CWD が `/home/user/tax-2025/` の場合、CLI スクリプトには絶対パス `/home/user/tax-2025/shinkoku.db` を `--db-path` で渡す。`init`, `journal-add`, `journal-batch-add`, `search`, `journal-update`, `journal-delete` すべてに同じ絶対パスを使用する。 ## 進捗情報の読み込み 設定の読み込み後、引継書ファイルを読み込んで前ステップの結果を把握する。 1. `.shinkoku/progress/progress-summary.md` を Read ツールで読み込む（存在する場合） 2. 以下の引継書を Read ツールで読み込む（存在する場合）: - `.shinkoku/progress/01-setup.md` 3. 読み込んだ情報を以降のステップで活用する（ユーザーへの再質問を避ける） 4. ファイルが存在しない場合はスキップし、ユーザーに必要情報を直接確認する ## 基本方針 - CSV取り込み → ユーザー確認 → 仕訳登録 の3ステップを基本フローとする - 勘定科目は references/account-master.md のマスタデータに準拠する - 仕訳登録前に必ずユーザーに内容を確認する（自動登録しない） - 消費税区分（課税/非課税/不課税/対象外）を正確に設定する - 日付・金額・勘定科目の整合性を検証してからツールを呼び出す - エラー発生時はエラー内容を日本語で分かりやすく伝え、修正方法を提案する ## 前提条件の確認 仕訳入力を開始する前に以下を確認する: 1. **帳簿が初期化済みか**: 未初期化の場合は `init` コマンドで初期化を案内する 2. **会計年度**: 対象の会計年度（例: 2025）を確認する 3. **青色申告 or 白色申告