okane-skills

name	okane-skills
description	家計簿の残高予測・シミュレーションスキル。「残高予測」「何ヶ月後にいくら」「この出費大丈夫？」「お金足りる？」「貯金シミュレーション」「ログ圧縮」「危険ポイント検出」などの依頼時に使用。okane-backup-*.json形式のファイルを読み込み、将来の残高推移予測、大きな出費の可否判定、残高不足警告を行う。

Okane Skills - 残高予測・シミュレーション

概要

okaneのエクスポートJSONを分析し:

• 将来の残高予測 - Xヶ月後にいくらになるか
• 出費可否チェック - 大きな出費が間に合うか
• 危険ポイント検出 - 残高不足になる日を警告
• ログ圧縮 - 古いデータを月次サマリーに圧縮

主要機能

1. 残高予測 (--forecast N)

Nヶ月後までの残高推移と、各月の大きな出入り（10万円以上）を表示。

python scripts/okane_analyzer.py data.json --forecast 6

出力例:

月	残高	大きな出入り
2026-01	¥1,500,000	給与(+¥300,000), カード(-¥150,000)
2026-02	¥1,200,000	家賃(-¥100,000)

2. 出費可否チェック (--check AMOUNT)

「この日にこの金額使って大丈夫？」を判定。

python scripts/okane_analyzer.py data.json --check 1000000 --date 2026-02-01

出力:

• 判定（✅可能 / ⚠️ギリギリ / ❌不足）
• 出費前後の残高
• その後の予定支出一覧

3. 危険ポイント検出 (--danger)

残高が閾値を下回る日を検出。

python scripts/okane_analyzer.py data.json --danger --threshold 100000

4. ログ圧縮 (--compress)

古い取引を月次サマリーに圧縮してファイルサイズを削減。

python scripts/okane_analyzer.py data.json --compress --keep-months 3 -o compressed.json

• --keep-months N: 直近Nヶ月は詳細を保持（デフォルト: 3）
• 圧縮前: 各取引が個別レコード
• 圧縮後: 月ごとの収入合計・支出合計に集約

5. グラフ生成 (--chart)

残高推移グラフをPNG画像で出力。

python scripts/okane_analyzer.py data.json --chart --chart-months 6 -o chart.png

グラフの内容:

• 青線: 残高推移
• 緑縦線: 今日
• ▲緑マーカー: 大きな収入（20万円以上）
• ▼赤マーカー: 大きな支出（20万円以上）

JSONデータ形式

{
  "version": "1.0",
  "initialBalance": 0,
  "transactions": [
    {
      "id": "unique-id",
      "date": "YYYY-MM-DD",
      "type": "income" | "expense",
      "amount": number,
      "description": "説明"
    }
  ]
}

典型的な使い方

1. 「3月に100万使いたいけど大丈夫？」 → --check 1000000 --date 2026-03-01

2. 「半年後の貯金いくら？」 → --forecast 6

3. 「お金やばくなる時ある？」 → --danger

4. 「JSONが重くなってきた」 → --compress

5. 「グラフで見せて」 → --chart -o chart.png