mcpField
D
debt-management

debt-management

github.com/joellewisその他218748 回インストール15 週間前に更新
リポジトリ

debt-management について

debt-managementは、債務返済方法の理解と比較に使うファイナンシャルプランニング用スキルです。債務比率、借り換え、債務の一本化、返済計算を扱い、実行可能なPythonデモも含みます。

主な機能

  1. 01Avalancheとsnowballの返済戦略
  2. 02債務収入比率の分析
  3. 03借り換え損益分岐点の計算
  4. 04債務一本化のコスト比較
  5. 05追加返済後の完済期間の推定

活用シーン

  1. 01金利順と残高順の返済を比較
  2. 02住宅ローン借り換えの採算を評価
  3. 03追加返済後の完済時期を推定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/joellewis/finance_skills --skill debt-management

インストール後、Claude Code で/debt-managementを入力して読み込まれたか確認します。

同梱ファイルscripts/debt_management.py

詳細

債務管理

基本概念

債務アバランチ法

すべての債務に最低返済額を支払い、それ以外の返済額はまず金利が最も高い債務に充てます。

  • **数学的に最適です:**すべての債務の返済期間を通じて支払う利息の合計を最小限に抑えます
  • 金利が最も高い債務を完済すると、その返済額を次に金利が高い債務に回します
  • 規律が必要です。金利が最も高い債務の残高も最大の場合、最初のうちは目に見える進捗が遅くなることがあります
  • スノーボール法と比べて常に節約になりますが、その差は債務の状況によって異なります
債務スノーボール法

すべての債務に最低返済額を支払い、それ以外の返済額はまず残高が最も少ない債務に充てます。

  • **心理的に効果的です:**早期に成果を得ることで、勢いとモチベーションが高まります
  • 研究(Kellogg School)によると、スノーボール法のほうが継続しやすく、実際に債務を完済できる可能性が高くなります
  • アバランチ法より利息の合計が増える場合がありますが、継続率は高くなります
  • 返済を続けるために、モチベーションにつながる成功体験が必要な人に最適です
債務所得比率(DTI)

総月収に占める毎月の債務返済額の割合です。

  • **フロントエンドDTI(住宅費比率):**毎月の住宅費(PITI:元金、利息、税金、保険)/総月収
    • 目安:28%未満
  • **バックエンドDTI(総債務比率):**毎月のすべての債務返済額(住宅費+自動車ローン+学生ローン+クレジットカード+その他)/総月収
    • 目安:36%未満(従来型)、最大43%(FHA)。条件を満たす借り手には、50%まで認める貸し手もあります
  • DTIは、住宅ローンの審査や総合的な財務状況の評価における重要な要素です
借り換えの分析

諸費用を考慮して、既存ローンと新しいローンの総費用を比較します。

  • **毎月の節約額:**旧返済額-新返済額
  • **損益分岐までの月数:**諸費用の合計/毎月の節約額
  • **総費用の比較:**旧ローンの残りの返済額の合計と、新ローンの返済額の合計+諸費用を比較します
  • 損益分岐点を超える期間、ローンを保有する予定がある場合、借り換えによって費用を節約できます
  • 検討事項:残りの返済期間、償却期間のリセット、キャッシュアウトによる影響
債務の一本化

複数の債務を、できれば金利の低い単一のローンにまとめます。

  • **考えられるメリット:**金利の低下、返済の一本化、管理の簡素化
  • **リスク:**金利が低くても返済期間が長くなると、利息の合計が増える可能性があります。利用枠に余裕ができることで、新たな借り入れをしたくなる場合もあります
  • **評価方法:**個別に返済した場合の利息の合計と、一本化したローンの利息の合計を比較します
  • 0%の導入金利が適用される残高移行カードは有効な場合がありますが、金利が適用される前に完済する必要があります
良い債務と悪い債務
  • **良い債務:**金利が低く、税控除の対象となる可能性があり、価値が上がる資産の取得や収入を得る力の向上につながるもの(住宅ローン、学生ローン、事業ローン)
  • **悪い債務:**金利が高く、価値が下がる資産や消費に充てられるもの(クレジットカード、ペイデイローン、高級車の自動車ローン)
  • 明確に線引きできるとは限りません。信頼できる通勤用の車を購入するための低金利の自動車ローンは、妥当な場合があります
機会費用の分析

債務の金利が低い場合、積極的に返済することが最善とは限りません。

  • **判断基準:**税引き後の期待投資収益率が税引き後の債務金利を上回るなら、余剰資金を投資に回すことで、より多くの資産を築ける可能性があります
  • **例:**金利3.5%の住宅ローン(税控除後は2.5%)と、期待株式リターン7~10%を比べると、数学的には投資が有利と考えられます
  • **注意点:**投資収益は不確実ですが、債務の返済による効果は確実です。債務のない状態になる心理的なメリットにも、実質的な価値があります
  • リスク許容度を考慮してください。確実な3.5%のリターン(債務の返済)と、変動する7~10%のリターン(投資)のどちらを選ぶか検討します
債務の完済までの期間

追加返済を考慮した償却計算です。

  • 標準的な償却:n = -ln(1 - (P×r)/PMT) / ln(1+r)
  • 追加返済がある場合:PMTをPMT + 追加返済額に置き換えて、nを再計算します
  • 利息の合計 = (n × PMT) - P(追加返済分を調整)

主な計算式

計算式式用途
フロントエンドDTI住宅費の支払い額 / 月間総収入住宅ローンの審査
バックエンドDTIすべての債務の支払い額 / 月間総収入債務全体の健全性
借り換えの損益分岐点諸費用 / 月々の節約額借り換え費用を回収するまでの月数
完済までの月数n = -ln(1 - Pr/PMT) / ln(1+r)債務返済の期間
支払利息の合計(n × PMT) - 元金借入コスト
実効金利(税引後)r × (1 - marginal_tax_rate)税控除対象債務の比較

計算例

例1:アバランチ方式とスノーボール方式の比較

条件: 最低返済額に加えて、毎月500ドルを追加返済に充てられる債務が3件あるとします。

  • クレジットカード:残高5,000ドル、年利22%、最低返済額100ドル
  • 学生ローン:残高12,000ドル、年利6%、最低返済額200ドル
  • 個人ローン:残高3,000ドル、年利15%、最低返済額75ドル

計算する内容: 各返済戦略の返済順序、合計月数、支払利息の合計(月ごとのシミュレーション。scripts/debt_management.pyを参照)。 解答 — アバランチ方式(金利の高い順:22% → 15% → 6%):

  1. すべての債務で最低返済額を支払います(月375ドル)。追加の500ドルはクレジットカードに充てます(カードへの合計返済額は月600ドル)。
  2. クレジットカード(残高5,000ドル、年利22%、月600ドル):10か月目に完済し、支払利息は約476ドルです。
  3. 完済後に浮いた返済額を個人ローンに回します(月75ドル + 600ドル = 個人ローンへの返済額は月675ドル)。14か月目に完済し、支払利息は約408ドルです。
  4. すべての返済額を学生ローンに回します(月200ドル + 675ドル = 月875ドル)。26か月目に完済し、支払利息は約1,062ドルです(年利6%のローンには、最後だけでなく、先行する返済期間中も残高12,000ドル全額に利息が発生します)。
  5. 合計:26か月、支払利息は約1,946ドルです。

解答 — スノーボール方式(残高の少ない順:3,000ドル → 5,000ドル → 12,000ドル):

  1. 追加の500ドルを個人ローンに充てます(個人ローンへの合計返済額は月575ドル)。
  2. 個人ローン(残高3,000ドル、年利15%、月575ドル):6か月目に完済し、支払利息は約123ドルです。
  3. 完済後に浮いた返済額をクレジットカードに回します(月100ドル + 575ドル = カードへの返済額は月675ドル)。14か月目に完済し、支払利息は約911ドルです。
  4. すべての返済額を学生ローンに回します。26か月目に完済し、支払利息は約1,071ドルです。
  5. 合計:26か月、支払利息は約2,104ドルです。

比較: アバランチ方式では支払利息を約158ドル節約できます。どちらの方式でも26か月で完済します。最も金利の高い債務が最大の債務ではないため、差はわずかです。スノーボール方式では最初の完済がより早く訪れます(最初の完済まで6か月、アバランチ方式では10か月です)。多くの人にとって、このモチベーション面の違いには158ドルを支払う価値があります。

例2:借り換えの損益分岐点

条件: 現在の住宅ローン:残高300,000ドル、金利6.5%、残り25年、月々の返済額2,028ドル。新しい借り換え案:金利5.5%、期間25年、諸費用6,000ドル、月々の返済額1,838ドル。 計算する内容: 損益分岐点までの期間と、支払利息の節約額の合計。 解答:

  1. 月々の節約額:2,028ドル - 1,838ドル = 月190ドル。
  2. 損益分岐点:6,000ドル / 190ドル = 31.6か月 ≈ 32か月(2年8か月)。
  3. 32か月を超えてその家に住み続ける場合、借り換えによって費用を節約できます。
  4. 旧ローンの総支払額:25 × 12 × 2,028ドル = 608,400ドル → 支払利息の合計 = 608,400ドル - 300,000ドル = 308,400ドル。
  5. 新ローンの総支払額:25 × 12 × 1,838ドル + 6,000ドル = 557,400ドル → 支払利息の合計 = 557,400ドル - 300,000ドル = 257,400ドル。
  6. 支払利息の節約額の合計:308,400ドル - 257,400ドル = 51,000ドル。

よくある落とし穴

  • 心理的な要因を無視すること — 支払利息が多少増えても、多くの人にはスノーボール方式のほうが効果的です
  • 借り換えの分析にすべての諸費用を含めないこと(融資手数料、鑑定費用、権原保険、ポイント)
  • 金利が低くても返済期間が長い債務に一本化すると、支払利息の合計が増える場合があります — 必ず総コストを比較してください
  • リスク許容度や、確実なリターンと不確実なリターンの違いを考慮せず、投資する代わりに低金利の債務を返済すること(機会費用)
  • 実効金利を比較する際に、住宅ローンや学生ローンの利息が税控除の対象となるかを考慮しないこと
  • 低利回りの口座に貯蓄する一方で、高金利の債務は最低返済額しか支払わないこと
  • 債務を一本化して利用可能になった与信枠が、新たな債務の積み上がりにつながること
  • 償却期間のリセットを無視すること:新たに30年ローンへ借り換えると、完済時期が先延ばしになります

相互参照

  • lending(ウェルスマネジメントプラグイン):住宅ローンの分析、ローン条件、償却計算
  • emergency-fund(ウェルスマネジメントプラグイン):十分な緊急資金があれば、危機の際に新たな高金利の負債を負わずに済みます
  • savings-goals(ウェルスマネジメントプラグイン):負債の返済と貯蓄目標は、キャッシュフローの配分をめぐって競合します
  • tax-efficiency(ウェルスマネジメントプラグイン):特定の負債の利息が税控除の対象となるかどうかは、最適な返済順序に影響します
  • liquidity-management(ウェルスマネジメントプラグイン):負債の支払いは、キャッシュフロー計画における固定債務です
  • financial-planning-workflow(アドバイザリープラクティスプラグイン):ファイナンシャルプランニングのキャッシュフロー段階と提案段階で、負債の返済戦略を評価します
  • insurance-planning(ウェルスマネジメントプラグイン):未返済の負債残高は、生命保険の必要額分析に直接反映されます

スクリプトの実行

uv run scripts/debt_management.py            # run the demo (uses PEP 723 inline deps)
uv run scripts/debt_management.py --verify   # check demo outputs against the worked examples (exit 1 on mismatch)
python3 scripts/debt_management.py            # alternative (requires: pip install numpy)

デモでは、上記の計算結果が出力されます。値はこのスキルの計算例と一致します。クラスと関数の一覧を表示するには、--help を実行してください。プログラムから利用する場合は、スクリプトを実行するのではなく、モジュールをインポートしてください。デモが実行されるのは python debt_management.py を実行した場合のみです。

コメント