tax-aggregate

name: tax-aggregate description: 確定申告用に経費を勘定科目で分類し、家事按分・減価償却を適用して年次集計する。集計を CSV 化し freee MCP で取込できる形にする。トリガー - 確定申告, 経費集計, 年次集計, 勘定科目, 家事按分, 減価償却, freee 取込, tax disable-model-invocation: true argument-hint: "<経費データのディレクトリ> [--year YYYY]" allowed-tools: - Read - Glob - Grep - Write - Edit - Bash(python3:*) - mcp__freee-mcp__freee_get_current_company - mcp__freee-mcp__freee_api_get - mcp__freee-mcp__freee_api_post

確定申告 経費集計スキル

$ARGUMENTS で指定された経費データを勘定科目で分類し、家事按分・減価償却を適用して年次集計する。集計結果を CSV 化し、freee MCP (mcp__freee-mcp__...) で取込できる形にする。

引数

• $ARGUMENTS: 経費データを格納したディレクトリ。--year YYYY で対象年を指定する (省略時は対象年を確認してから進める)。

手順

1. 対象データの収集

1. 指定ディレクトリを Glob で列挙し、対象年 (--year) の経費データ (CSV/領収書/突合結果など) を読み込む。
2. 対象年の範囲 (会計期間) を確認する。年をまたぐ取引の扱いが不明な場合は確認する。
3. 入力は読み取り専用で扱い、加工結果は別ファイルへ出力する。

2. 勘定科目への分類

1. 各経費を勘定科目 (旅費交通費・通信費・消耗品費・地代家賃・減価償却費 など) に分類する。
2. 科目が判断できないものは「未分類 (要確認)」とし、勝手に確定しない。
3. 経費性が疑わしいもの (私的利用の可能性) は「要確認」として印を付ける。

3. 家事按分

1. 家賃・通信費・水道光熱費など、事業/家事が混在する科目に家事按分を適用する。
2. 按分率は勝手に決めない。ユーザーに確認のうえで適用し、適用した按分率を記録する。
3. 按分率が未確定のものは「要確認」として、按分前の金額を保持したまま残す。

4. 減価償却

1. 固定資産 (取得価額が基準以上のもの) を抽出する。
2. 取得日・取得価額・耐用年数・償却方法を確認し、当年の減価償却費を計算する。耐用年数や償却方法が不明なものは確定せず「要確認」とする。
3. 計算が必要な場合は python3 スクリプトを書いて算出してよい (計算過程を出力に残す)。

5. 年次集計と CSV 化

1. 勘定科目ごとに当年合計を集計し、CSV として 別ファイル に出力する。
2. freee 取込を見据え、後段でマッピングしやすい列 (日付/勘定科目/金額/摘要/区分) を持たせる。
3. 各行に確度 (確定 / 要確認) を付与する。

6. freee との整合確認

1. mcp__freee-mcp__freee_get_current_company で対象事業所を確認する。
2. mcp__freee-mcp__freee_api_get で勘定科目マスタを取得し、分類した科目名と突き合わせる。マスタに無い科目は対応表で解決し、解決できないものは「要確認」とする。
3. freee の科目 ID と集計データを対応付けた取込用データを作る。

7. freee へ取込 または 取込用 CSV 出力

• ユーザーが取込まで望む場合: mcp__freee-mcp__freee_api_post で登録する。要確認の行は除外し、確定分のみを対象とする。
• それ以外: freee 取込用 CSV をファイル出力するに留める。
• いずれの場合も、対象事業所・対象年・件数を実行前に確認する。

8. 検算

1. 取込前後 (または出力前後) で勘定科目合計・総合計が一致することを検算する。
2. 元データ件数と取込件数の差分を確認し、除外した行 (要確認) の内訳を明示する。
3. 不一致があればエラーを握りつぶさず原因を報告する。

注意事項

• CLAUDE.md のコーディング/対話規約に従う
• 税務上の判断 (勘定科目・按分率・経費性・耐用年数) は確定情報ではない。すべて「要確認」として明示し、最終判断はユーザー/税理士に委ねる
• 推測で確定申告額を断定しない。不明な金額・科目・按分率は「不明」または「要確認」と明記する
• 家事按分の按分率は勝手に決めず、必ず確認のうえで適用する
• 元データは変更しない。出力は必ず別ファイルに書き出す
• 金額など機密はチャットに垂れ流さず、ファイルへ出力する。チャットには件数・合計サマリーと確認事項のみを示す
• freee への api_post は確定分のみを対象とし、要確認の行は取り込まない
• 集計差分や科目マッピングで詰まったら o3 MCP に相談する