| 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": "説明"
}
]
}
典型的な使い方
-
「3月に100万使いたいけど大丈夫？」
→ --check 1000000 --date 2026-03-01
-
「半年後の貯金いくら？」
→ --forecast 6
-
「お金やばくなる時ある？」
→ --danger
-
「JSONが重くなってきた」
→ --compress
-
「グラフで見せて」
→ --chart -o chart.png
