margin-management

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Margin Management

保证金管理

Purpose

用途

Monitor and manage margin-living strategy by tracking margin balances, interest costs, dividend coverage ratios, and portfolio-to-margin safety thresholds. Provides data-driven scaling recommendations based on strategy milestones.
通过跟踪保证金余额、利息成本、股息覆盖比率和投资组合与保证金的安全阈值,监控和管理保证金生活策略。基于策略里程碑提供数据驱动的缩放建议。

When to Use

使用场景

Use this skill when:
  • Importing new Fidelity balances CSV
  • Updating margin balance or interest rate
  • Calculating coverage ratio (dividends ÷ interest)
  • User mentions: "margin dashboard", "margin balance", "coverage ratio", "margin strategy"
  • Assessing margin scaling decisions
  • Checking safety thresholds
在以下场景使用本技能:
  • 导入新的Fidelity余额CSV文件
  • 更新保证金余额或利率
  • 计算覆盖比率(股息 ÷ 利息)
  • 用户提及:"margin dashboard"、"margin balance"、"coverage ratio"、"margin strategy"
  • 评估保证金缩放决策
  • 检查安全阈值

Personal Strategy Inputs

个人策略输入

Real dollar amounts, dates, and private strategy targets must come from
.env
(see
.env.example
). Use
python-dotenv
or shell environment variables; do not hardcode personal numbers in this skill.
实际金额、日期和私有策略目标必须来自
.env
文件(参考
.env.example
)。使用
python-dotenv
或Shell环境变量;请勿在此技能中硬编码个人数据。

Required
.env
values

必填
.env
变量

  • FG_STRATEGY_START_DATE
  • FG_MARGIN_INTEREST_RATE
    ,
    FG_MARGIN_INTEREST_RATE_DECIMAL
  • FG_MARGIN_JUMP_ALERT_THRESHOLD
  • FG_CURRENT_MONTHLY_DRAW
    ,
    FG_MONTH6_DRAW_TARGET
    ,
    FG_MONTH12_DRAW_TARGET
    ,
    FG_MONTH18_DRAW_TARGET
  • FG_BUSINESS_INCOME_MONTHLY
    ,
    FG_BUSINESS_INJECTION_RED
    ,
    FG_BUSINESS_INJECTION_CRITICAL
  • Latest example/demo values:
    FG_PORTFOLIO_BASELINE_VALUE
    ,
    FG_MARGIN_BASELINE_BALANCE
    ,
    FG_DIVIDEND_MONTHLY_INCOME
  • FG_STRATEGY_START_DATE
  • FG_MARGIN_INTEREST_RATE
    FG_MARGIN_INTEREST_RATE_DECIMAL
  • FG_MARGIN_JUMP_ALERT_THRESHOLD
  • FG_CURRENT_MONTHLY_DRAW
    FG_MONTH6_DRAW_TARGET
    FG_MONTH12_DRAW_TARGET
    FG_MONTH18_DRAW_TARGET
  • FG_BUSINESS_INCOME_MONTHLY
    FG_BUSINESS_INJECTION_RED
    FG_BUSINESS_INJECTION_CRITICAL
  • 最新示例/演示值:
    FG_PORTFOLIO_BASELINE_VALUE
    FG_MARGIN_BASELINE_BALANCE
    FG_DIVIDEND_MONTHLY_INCOME

Core Workflow

核心工作流

1. Read Fidelity Balances CSV

1. 读取Fidelity余额CSV文件

Location:
notebooks/updates/Balances_for_Account_{account_id}.csv
Key Fields to Extract:
csv
Balance,Day change
Total account value,${FG_PORTFOLIO_BASELINE_VALUE_RAW},${FG_PORTFOLIO_DAY_CHANGE_RAW}      → Portfolio Value
Margin buying power,${FG_MARGIN_BUYING_POWER_RAW},${FG_MARGIN_BUYING_POWER_DAY_CHANGE_RAW}
Net debit,${FG_MARGIN_BASELINE_BALANCE_RAW},${FG_MARGIN_DAY_CHANGE_RAW}                 → Margin Balance (abs value)
Margin interest accrued this month,${FG_MARGIN_INTEREST_ACCRUED_THIS_MONTH_RAW},    → Monthly Interest (actual)
Calculations:
  • Margin Balance: Absolute value of "Net debit" = ${FG_MARGIN_BASELINE_BALANCE}
  • Interest Rate: Default ${FG_MARGIN_INTEREST_RATE} (Fidelity $1k-$24.9k tier) unless specified
  • Monthly Interest Cost: Balance × Rate ÷ 12 = ${FG_MARGIN_BASELINE_BALANCE} × ${FG_MARGIN_INTEREST_RATE_DECIMAL} ÷ 12 = ${FG_MARGIN_MONTHLY_INTEREST_COST}
位置
notebooks/updates/Balances_for_Account_{account_id}.csv
需提取的关键字段:
csv
Balance,Day change
Total account value,${FG_PORTFOLIO_BASELINE_VALUE_RAW},${FG_PORTFOLIO_DAY_CHANGE_RAW}      → Portfolio Value
Margin buying power,${FG_MARGIN_BUYING_POWER_RAW},${FG_MARGIN_BUYING_POWER_DAY_CHANGE_RAW}
Net debit,${FG_MARGIN_BASELINE_BALANCE_RAW},${FG_MARGIN_DAY_CHANGE_RAW}                 → Margin Balance (abs value)
Margin interest accrued this month,${FG_MARGIN_INTEREST_ACCRUED_THIS_MONTH_RAW},    → Monthly Interest (actual)
计算逻辑:
  • 保证金余额:"Net debit"的绝对值 = ${FG_MARGIN_BASELINE_BALANCE}
  • 利率:默认使用${FG_MARGIN_INTEREST_RATE}(Fidelity 1000-24999美元档位),除非另有指定
  • 月度利息成本:余额 × 利率 ÷ 12 = ${FG_MARGIN_BASELINE_BALANCE} × ${FG_MARGIN_INTEREST_RATE_DECIMAL} ÷ 12 = ${FG_MARGIN_MONTHLY_INTEREST_COST}

2. Safety Check: Margin Jump Alert

2. 安全检查:保证金大幅变动警报

Rule: If new margin balance > previous balance + ${FG_MARGIN_JUMP_ALERT_THRESHOLD}, STOP
Reason: Large draws should be intentional per margin-living strategy
Example:
Previous: ${FG_MARGIN_BASELINE_BALANCE}
Current: ${FG_MARGIN_JUMP_EXAMPLE_CURRENT} (+${FG_MARGIN_JUMP_EXAMPLE_DIFF}) → 🚨 ALERT - Confirm intentional draw
Action:
  • Alert user immediately
  • Show diff: "Margin increased by ${FG_MARGIN_JUMP_EXAMPLE_DIFF} - Confirm this was intentional"
  • Wait for user confirmation before proceeding
规则:如果新保证金余额 > 之前余额 + ${FG_MARGIN_JUMP_ALERT_THRESHOLD},立即停止操作
原因:根据保证金生活策略,大额提取需是有意为之
示例:
Previous: ${FG_MARGIN_BASELINE_BALANCE}
Current: ${FG_MARGIN_JUMP_EXAMPLE_CURRENT} (+${FG_MARGIN_JUMP_EXAMPLE_DIFF}) → 🚨 警报 - 确认提取是有意操作
操作:
  • 立即向用户发出警报
  • 显示差额:"保证金增加了${FG_MARGIN_JUMP_EXAMPLE_DIFF} - 确认此操作是有意为之"
  • 等待用户确认后再继续

3. Add Entry to Margin Dashboard

3. 向保证金仪表板添加条目

Insert new row with:
  • Date: Current date (use
    date +"%Y-%m-%d"
    )
  • Margin Balance: From Balances CSV (Net debit absolute value)
  • Interest Rate: ${FG_MARGIN_INTEREST_RATE} (or updated rate from CSV if available)
  • Monthly Interest Cost: Calculate (Balance × Rate ÷ 12)
  • Notes: Auto-generate based on elapsed time since ${FG_STRATEGY_START_DATE}
Example Entry:
Date: ${FG_MARGIN_EXAMPLE_DATE}
Margin Balance: ${FG_MARGIN_BASELINE_BALANCE}
Interest Rate: ${FG_MARGIN_INTEREST_RATE}
Monthly Interest Cost: ${FG_MARGIN_MONTHLY_INTEREST_COST}
Notes: Month 1 - Building foundation, on track per strategy
Notes Generation Logic:
python
import os
from datetime import datetime

months_elapsed = (current_date - datetime.fromisoformat(os.getenv("FG_STRATEGY_START_DATE"))).days // 30

if months_elapsed < 6:
    note = f"Month {months_elapsed} - Building foundation, on track per strategy"
elif months_elapsed < 12:
    note = f"Month {months_elapsed} - Approaching Month 6 milestone"
elif months_elapsed < 18:
    note = f"Month {months_elapsed} - Approaching break-even milestone"
else:
    note = f"Month {months_elapsed} - Mature strategy, monitor scaling"
插入新行包含以下内容:
  • 日期:当前日期(使用
    date +"%Y-%m-%d"
    命令)
  • 保证金余额:来自余额CSV文件(Net debit的绝对值)
  • 利率:${FG_MARGIN_INTEREST_RATE}(或CSV文件中的更新利率,如果可用)
  • 月度利息成本:计算得出(余额 × 利率 ÷ 12)
  • 备注:根据距离${FG_STRATEGY_START_DATE}的时间自动生成
示例条目:
Date: ${FG_MARGIN_EXAMPLE_DATE}
Margin Balance: ${FG_MARGIN_BASELINE_BALANCE}
Interest Rate: ${FG_MARGIN_INTEREST_RATE}
Monthly Interest Cost: ${FG_MARGIN_MONTHLY_INTEREST_COST}
Notes: Month 1 - Building foundation, on track per strategy
备注生成逻辑:
python
import os
from datetime import datetime

months_elapsed = (current_date - datetime.fromisoformat(os.getenv("FG_STRATEGY_START_DATE"))).days // 30

if months_elapsed < 6:
    note = f"Month {months_elapsed} - Building foundation, on track per strategy"
elif months_elapsed < 12:
    note = f"Month {months_elapsed} - Approaching Month 6 milestone"
elif months_elapsed < 18:
    note = f"Month {months_elapsed} - Approaching break-even milestone"
else:
    note = f"Month {months_elapsed} - Mature strategy, monitor scaling"

4. Update Summary Section

4. 更新摘要部分

Recalculate Dashboard Metrics:
重新计算仪表板指标:

Current Margin Balance

当前保证金余额

= Latest entry from Margin Dashboard
Example: ${FG_MARGIN_BASELINE_BALANCE}
= 保证金仪表板中的最新条目
示例: ${FG_MARGIN_BASELINE_BALANCE}

Monthly Interest Cost

月度利息成本

= Latest calculated cost
Example: ${FG_MARGIN_MONTHLY_INTEREST_COST}/month
= 最新计算的成本
示例: ${FG_MARGIN_MONTHLY_INTEREST_COST}/月

Annual Interest Cost

年度利息成本

= Monthly Interest Cost × 12
Example: ${FG_MARGIN_MONTHLY_INTEREST_COST} × 12 = ${FG_MARGIN_ANNUAL_INTEREST_COST}/year
= 月度利息成本 × 12
示例: ${FG_MARGIN_MONTHLY_INTEREST_COST} × 12 = ${FG_MARGIN_ANNUAL_INTEREST_COST}/年

Dividend Income (from Dividend Tracker)

股息收入(来自股息追踪器)

= Pull from Dividend Tracker "TOTAL EXPECTED DIVIDENDS"
Example: ${FG_DIVIDEND_MONTHLY_INCOME}/month
= 从股息追踪器的"TOTAL EXPECTED DIVIDENDS"中提取
示例: ${FG_DIVIDEND_MONTHLY_INCOME}/月

Coverage Ratio

覆盖比率

= Dividend Income ÷ Monthly Interest Cost
Formula: =IFERROR(Dividends / Interest, 0)
Example: ${FG_DIVIDEND_MONTHLY_INCOME} ÷ ${FG_MARGIN_MONTHLY_INTEREST_COST} = ${FG_DIVIDEND_COVERAGE_RATIO} 🟢
Fix #DIV/0! if margin balance = $0:
Before: =B10 / B11  (causes #DIV/0! when margin = 0)
After: =IFERROR(B10 / B11, 0)  (returns 0 when no margin)
= 股息收入 ÷ 月度利息成本
公式: =IFERROR(Dividends / Interest, 0)
示例: ${FG_DIVIDEND_MONTHLY_INCOME} ÷ ${FG_MARGIN_MONTHLY_INTEREST_COST} = ${FG_DIVIDEND_COVERAGE_RATIO} 🟢
修复保证金余额为$0时的#DIV/0!错误:
修复前: =B10 / B11  (保证金为0时会导致#DIV/0!)
修复后: =IFERROR(B10 / B11, 0)  (无保证金时返回0)

5. Calculate Strategy Metrics

5. 计算策略指标

Portfolio-to-Margin Ratio

投资组合与保证金比率

= Total account value ÷ Margin Balance
Example: ${FG_PORTFOLIO_BASELINE_VALUE} ÷ ${FG_MARGIN_BASELINE_BALANCE} = ${FG_PORTFOLIO_MARGIN_RATIO} 🟢🟢🟢
Safety Thresholds:
  • 🟢 Green: Ratio > 4.0:1 (target - healthy margin usage)
  • 🟡 Yellow: Ratio 3.5-4.0:1 (warning - pause scaling)
  • 🔴 Red: Ratio < 3.0:1 (alert - stop draws, inject business income)
  • Critical: Ratio < 2.5:1 (emergency - inject ${FG_BUSINESS_INJECTION_CRITICAL}, consider selling)
= 账户总价值 ÷ 保证金余额
示例: ${FG_PORTFOLIO_BASELINE_VALUE} ÷ ${FG_MARGIN_BASELINE_BALANCE} = ${FG_PORTFOLIO_MARGIN_RATIO} 🟢🟢🟢
安全阈值:
  • 🟢 绿色:比率 > 4.0:1(目标值 - 保证金使用健康)
  • 🟡 黄色:比率 3.5-4.0:1(警告 - 暂停缩放)
  • 🔴 红色:比率 < 3.0:1(警报 - 停止提取,注入业务收入)
  • 紧急:比率 < 2.5:1(紧急情况 - 注入${FG_BUSINESS_INJECTION_CRITICAL},考虑出售资产)

Current Draw vs Fixed Expenses

当前提取金额与固定支出对比

Current monthly draw: ${FG_CURRENT_MONTHLY_DRAW} (fixed expenses only)
Target: Start with ${FG_CURRENT_MONTHLY_DRAW}, scale to ${FG_MONTH6_DRAW_TARGET}, ${FG_MONTH12_DRAW_TARGET}, ${FG_MONTH18_DRAW_TARGET} based on data
当前月度提取金额: ${FG_CURRENT_MONTHLY_DRAW}(仅固定支出)
目标: 从${FG_CURRENT_MONTHLY_DRAW}开始,根据数据逐步扩展至${FG_MONTH6_DRAW_TARGET}、${FG_MONTH12_DRAW_TARGET}、${FG_MONTH18_DRAW_TARGET}

6. Scaling Alerts (Time-Based)

6. 缩放警报(基于时间)

Strategy Start Date: ${FG_STRATEGY_START_DATE}
Calculate months elapsed:
python
import os
from datetime import datetime

start = datetime.fromisoformat(os.getenv("FG_STRATEGY_START_DATE"))
current = datetime.now()
months_elapsed = (current - start).days // 30
策略开始日期: ${FG_STRATEGY_START_DATE}
计算已过月数:
python
import os
from datetime import datetime

start = datetime.fromisoformat(os.getenv("FG_STRATEGY_START_DATE"))
current = datetime.now()
months_elapsed = (current - start).days // 30

Month 6 Alert

第6个月警报

📊 MONTH 6 MILESTONE CHECK:
✅ Dividends: ${FG_DIVIDEND_MONTHLY_INCOME}/month (need ${FG_MONTH6_DIVIDEND_MINIMUM})
✅ Portfolio-to-Margin Ratio: ${FG_PORTFOLIO_MARGIN_RATIO} (need 4:1+)
✅ Dividend Growth: On track

🎯 RECOMMENDATION: Scale margin draw to ${FG_MONTH6_DRAW_TARGET}/month (add mortgage)
- Current: ${FG_CURRENT_MONTHLY_DRAW} (fixed expenses only)
- New: ${FG_MONTH6_DRAW_TARGET} (fixed + mortgage)
- Safety margin: Excellent
📊 第6个月里程碑检查:
✅ 股息: ${FG_DIVIDEND_MONTHLY_INCOME}/月(需达到${FG_MONTH6_DIVIDEND_MINIMUM})
✅ 投资组合与保证金比率: ${FG_PORTFOLIO_MARGIN_RATIO}(需达到4:1+)
✅ 股息增长: 符合预期

🎯 建议: 将保证金提取金额扩展至${FG_MONTH6_DRAW_TARGET}/月(增加房贷支出)
- 当前: ${FG_CURRENT_MONTHLY_DRAW}(仅固定支出)
- 新金额: ${FG_MONTH6_DRAW_TARGET}(固定支出+房贷)
- 安全边际: 极佳

Month 12 Alert

第12个月警报

📊 MONTH 12 BREAK-EVEN CHECK:
Expected Dividends: ${FG_MONTH12_DIVIDEND_TARGET}/month (goal: break-even with margin interest)
✅ IF achieved: Consider scaling to ${FG_MONTH12_DRAW_TARGET}/month (add some variable expenses)
⚠️ IF not: Hold at ${FG_MONTH6_DRAW_TARGET}, assess strategy
📊 第12个月收支平衡检查:
预期股息: ${FG_MONTH12_DIVIDEND_TARGET}/月(目标:与保证金利息收支平衡)
✅ 若达成: 考虑扩展至${FG_MONTH12_DRAW_TARGET}/月(增加部分可变支出)
⚠️ 若未达成: 维持${FG_MONTH6_DRAW_TARGET},重新评估策略

Month 18 Alert

第18个月警报

📊 MONTH 18 MATURE STRATEGY CHECK:
Expected Dividends: ${FG_MONTH18_DIVIDEND_TARGET}/month
Expected Margin: Declining (dividends paying down debt)
✅ IF achieved: Consider scaling to ${FG_MONTH18_DRAW_TARGET}/month (most variable expenses)
⚠️ IF not: Hold current level, reassess timeline
📊 第18个月成熟策略检查:
预期股息: ${FG_MONTH18_DIVIDEND_TARGET}/月
预期保证金: 逐步减少(股息用于偿还债务)
✅ 若达成: 考虑扩展至${FG_MONTH18_DRAW_TARGET}/月(大部分可变支出)
⚠️ 若未达成: 维持当前水平,重新评估时间线

7. Alert Thresholds

7. 警报阈值

Generate alerts based on conditions:
根据条件生成警报:

Green (Healthy)

绿色(健康)

✅ Ratio > 4:1 AND dividends covering interest
Status: On track, continue per strategy
✅ 比率 > 4:1 且股息覆盖利息
状态: 符合预期,继续执行策略

Yellow (Caution)

黄色(谨慎)

⚠️ Ratio 3.5-4:1 OR dividend coverage declining
Action: Pause scaling, monitor weekly
⚠️ 比率 3.5-4:1 或股息覆盖能力下降
操作: 暂停缩放,每周监控

Red (Alert)

红色(警报)

🚨 Ratio < 3:1 OR dividend cuts detected
Action: STOP draws, inject ${FG_BUSINESS_INJECTION_RED} business income
🚨 比率 < 3:1 或检测到股息削减
操作: 停止提取,注入${FG_BUSINESS_INJECTION_RED}业务收入

Critical (Emergency)

紧急(危急)

⛔ Ratio < 2.5:1 OR margin call risk
Action: STOP draws, inject ${FG_BUSINESS_INJECTION_CRITICAL} business income, consider selling hedge (SQQQ)
⛔ 比率 < 2.5:1 或面临追加保证金风险
操作: 停止提取,注入${FG_BUSINESS_INJECTION_CRITICAL}业务收入,考虑对冲卖出(SQQQ)

Critical Rules

关键规则

WRITABLE Columns (Margin Dashboard)

可编辑列(保证金仪表板)

  • ✅ Date (Column A)
  • ✅ Margin Balance (Column B)
  • ✅ Interest Rate (Column C)
  • ✅ Monthly Interest Cost (Column D - calculated but writeable)
  • ✅ Notes (Column E)
  • ✅ Date(A列)
  • ✅ Margin Balance(B列)
  • ✅ Interest Rate(C列)
  • ✅ Monthly Interest Cost(D列 - 计算得出但可编辑)
  • ✅ Notes(E列)

SACRED Formulas (NEVER TOUCH)

不可修改公式(绝对禁止触碰)

  • ❌ Coverage Ratio (unless adding IFERROR wrapper)
  • ❌ Summary section totals (unless fixing #DIV/0!)
  • ❌ Coverage Ratio(除非添加IFERROR包装)
  • ❌ 摘要部分总计(除非修复#DIV/0!错误)

Margin Strategy Philosophy

保证金策略理念

Core Principle: Confidence-based scaling, not time-based mandates
Decision Framework:
  1. Data-driven: Decisions backed by actual dividend income, not projections
  2. Safety-first: Never scale if ratio drops below 3.5:1
  3. Business income as insurance: Available ${FG_BUSINESS_INCOME_MONTHLY}/month, not primary strategy
  4. Monte Carlo backstop: ${FG_BUSINESS_BACKSTOP_PROBABILITY} of scenarios used business income at some point
核心原则: 基于信心的缩放,而非时间强制要求
决策框架:
  1. 数据驱动: 决策基于实际股息收入,而非预测
  2. 安全优先: 比率低于3.5:1时绝不缩放
  3. 业务收入作为保险: 每月可使用${FG_BUSINESS_INCOME_MONTHLY},而非主要策略
  4. 蒙特卡洛备份: ${FG_BUSINESS_BACKSTOP_PROBABILITY}的场景中会在某些时候使用业务收入

Business Income Backstop

业务收入备份

Available: ${FG_BUSINESS_INCOME_MONTHLY}/month from business operations
Usage Scenarios:
  1. Margin call (ratio < 3:1): MUST USE business income immediately
  2. ⚠️ Market correction (20-30% drop): OPTIONAL - assess need
  3. 🎯 Acceleration (reach FI faster): OPTIONAL - strategic choice
Current Philosophy: Insurance policy only, not active strategy component
可用额度: 每月从业务运营中获得${FG_BUSINESS_INCOME_MONTHLY}
使用场景:
  1. 追加保证金(比率 < 3:1): 必须立即使用业务收入
  2. ⚠️ 市场回调(下跌20-30%): 可选 - 评估需求
  3. 🎯 加速(更快实现财务独立): 可选 - 战略性选择
当前理念: 仅作为保险政策,而非主动策略组成部分

Example Calculations

示例计算

Scenario 1: Month 1 (Current State)

场景1: 第1个月(当前状态)

Portfolio Value: ${FG_PORTFOLIO_BASELINE_VALUE}
Margin Balance: ${FG_MARGIN_BASELINE_BALANCE}
Ratio: ${FG_PORTFOLIO_MARGIN_RATIO} 🟢🟢🟢

Monthly Interest: ${FG_MARGIN_MONTHLY_INTEREST_COST}
Dividend Income: ${FG_DIVIDEND_MONTHLY_INCOME}
Coverage: ${FG_DIVIDEND_COVERAGE_RATIO} 🟢

Status: Excellent - building foundation
投资组合价值: ${FG_PORTFOLIO_BASELINE_VALUE}
保证金余额: ${FG_MARGIN_BASELINE_BALANCE}
比率: ${FG_PORTFOLIO_MARGIN_RATIO} 🟢🟢🟢

月度利息: ${FG_MARGIN_MONTHLY_INTEREST_COST}
股息收入: ${FG_DIVIDEND_MONTHLY_INCOME}
覆盖比率: ${FG_DIVIDEND_COVERAGE_RATIO} 🟢

状态: 极佳 - 正在建立基础

Scenario 2: Month 6 (Projected)

场景2: 第6个月(预测)

Portfolio Value: ${FG_MONTH6_PROJECTED_PORTFOLIO} (projected with W2 contributions)
Margin Balance: ${FG_MONTH6_PROJECTED_MARGIN} (scaled to ${FG_MONTH6_DRAW_TARGET}/month draw)
Ratio: ${FG_MONTH6_PROJECTED_RATIO} 🟢

Monthly Interest: ${FG_MONTH6_PROJECTED_MONTHLY_INTEREST}
Dividend Income: ${FG_CURRENT_MONTHLY_DRAW} (projected)
Coverage: ${FG_MONTH6_PROJECTED_COVERAGE} 🟢

Status: Healthy - on track for break-even
投资组合价值: ${FG_MONTH6_PROJECTED_PORTFOLIO}(含W2供款预测)
保证金余额: ${FG_MONTH6_PROJECTED_MARGIN}(扩展至${FG_MONTH6_DRAW_TARGET}/月提取)
比率: ${FG_MONTH6_PROJECTED_RATIO} 🟢

月度利息: ${FG_MONTH6_PROJECTED_MONTHLY_INTEREST}
股息收入: ${FG_CURRENT_MONTHLY_DRAW}(预测)
覆盖比率: ${FG_MONTH6_PROJECTED_COVERAGE} 🟢

状态: 健康 - 符合收支平衡预期

Scenario 3: Month 15 (Break-Even)

场景3: 第15个月(收支平衡)

Portfolio Value: ${FG_MONTH15_PROJECTED_PORTFOLIO}
Margin Balance: ${FG_MONTH15_PROJECTED_MARGIN} (scaled to ${FG_MONTH12_DRAW_TARGET}/month draw)
Ratio: ${FG_MONTH15_PROJECTED_RATIO} 🟢

Monthly Interest: ${FG_MONTH15_PROJECTED_MONTHLY_INTEREST}
Dividend Income: ${FG_MONTH15_PROJECTED_DIVIDEND_INCOME}
Coverage: ${FG_MONTH15_PROJECTED_COVERAGE} 🟢

Status: Break-even achieved, dividends > interest
投资组合价值: ${FG_MONTH15_PROJECTED_PORTFOLIO}
保证金余额: ${FG_MONTH15_PROJECTED_MARGIN}(扩展至${FG_MONTH12_DRAW_TARGET}/月提取)
比率: ${FG_MONTH15_PROJECTED_RATIO} 🟢

月度利息: ${FG_MONTH15_PROJECTED_MONTHLY_INTEREST}
股息收入: ${FG_MONTH15_PROJECTED_DIVIDEND_INCOME}
覆盖比率: ${FG_MONTH15_PROJECTED_COVERAGE} 🟢

状态: 达成收支平衡,股息 > 利息

Google Sheets Integration

Google Sheets集成

Spreadsheet ID: Read from
fin-guru/data/user-profile.yaml
google_sheets.portfolio_tracker.spreadsheet_id
Use the mcp__gdrive__sheets tool:
javascript
// STEP 1: Read Spreadsheet ID from user profile
// Load fin-guru/data/user-profile.yaml
// Extract: google_sheets.portfolio_tracker.spreadsheet_id

// STEP 2: Read Margin Dashboard
mcp__gdrive__sheets(
    operation: "spreadsheets.values.get",
    params: {
        spreadsheetId: SPREADSHEET_ID,  // from user-profile.yaml
        range: "Margin Dashboard!A2:E50"
    }
)

// STEP 3: Add new margin entry
mcp__gdrive__sheets(
    operation: "spreadsheets.values.update",
    params: {
        spreadsheetId: SPREADSHEET_ID,  // from user-profile.yaml
        range: "Margin Dashboard!A2:E2",
        valueInputOption: "USER_ENTERED",
        requestBody: {
            values: [[date, balance, rate, monthly_cost, notes]]
        }
    }
)
电子表格ID: 从
fin-guru/data/user-profile.yaml
读取 →
google_sheets.portfolio_tracker.spreadsheet_id
使用mcp__gdrive__sheets工具:
javascript
// STEP 1: 从用户配置文件读取电子表格ID
// 加载fin-guru/data/user-profile.yaml
// 提取: google_sheets.portfolio_tracker.spreadsheet_id

// STEP 2: 读取保证金仪表板
mcp__gdrive__sheets(
    operation: "spreadsheets.values.get",
    params: {
        spreadsheetId: SPREADSHEET_ID,  // 来自user-profile.yaml
        range: "Margin Dashboard!A2:E50"
    }
)

// STEP 3: 添加新保证金条目
mcp__gdrive__sheets(
    operation: "spreadsheets.values.update",
    params: {
        spreadsheetId: SPREADSHEET_ID,  // 来自user-profile.yaml
        range: "Margin Dashboard!A2:E2",
        valueInputOption: "USER_ENTERED",
        requestBody: {
            values: [[date, balance, rate, monthly_cost, notes]]
        }
    }
)

Agent Permissions

Agent权限

Margin Specialist (Write-enabled):
  • Can add new entries to Margin Dashboard
  • Can update margin balance, rate, cost
  • Can generate scaling alerts
  • CANNOT modify summary formulas (without formula-protection skill)
Builder (Write-enabled):
  • Can repair broken formulas (#DIV/0!)
  • Can update summary section calculations
  • Can add new metrics
All Other Agents (Read-only):
  • Market Researcher, Quant Analyst, Strategy Advisor
  • Can read margin data for analysis
  • Cannot write to spreadsheet
  • Must defer to Margin Specialist or Builder
Margin Specialist(可写入):
  • 可向保证金仪表板添加新条目
  • 可更新保证金余额、利率、成本
  • 可生成缩放警报
  • 不可修改摘要公式(除非使用公式保护技能)
Builder(可写入):
  • 可修复损坏的公式(#DIV/0!)
  • 可更新摘要部分计算
  • 可添加新指标
所有其他Agent(只读):
  • Market Researcher、Quant Analyst、Strategy Advisor
  • 可读取保证金数据用于分析
  • 不可写入电子表格
  • 必须听从Margin Specialist或Builder的指示

Reference Files

参考文件

For complete strategy details, see:
  • Margin Strategy:
    fin-guru-private/fin-guru/strategies/active/margin-living-master-strategy.md
  • Portfolio Strategy:
    fin-guru-private/fin-guru/strategies/active/portfolio-master-strategy.md
  • User Profile:
    fin-guru/data/user-profile.yaml
  • Spreadsheet Architecture:
    fin-guru/data/spreadsheet-architecture.md
如需完整策略细节,请查看:
  • 保证金策略:
    fin-guru-private/fin-guru/strategies/active/margin-living-master-strategy.md
  • 投资组合策略:
    fin-guru-private/fin-guru/strategies/active/portfolio-master-strategy.md
  • 用户配置文件:
    fin-guru/data/user-profile.yaml
  • 电子表格架构:
    fin-guru/data/spreadsheet-architecture.md

Pre-Flight Checklist

预检查清单

Before updating Margin Dashboard:
  • Fidelity Balances CSV is latest by date
  • CSV is in
    notebooks/updates/
    directory
  • Margin Dashboard sheet exists in Google Sheets
  • Previous margin balance known (for jump detection)
  • Dividend Tracker is up-to-date (for coverage ratio)
  • Current date retrieved via
    date
    command
更新保证金仪表板前:
  • Fidelity余额CSV文件是最新日期
  • CSV文件位于
    notebooks/updates/
    目录
  • Google Sheets中存在保证金仪表板工作表
  • 已知之前的保证金余额(用于检测大幅变动)
  • 股息追踪器已更新(用于计算覆盖比率)
  • 通过
    date
    命令获取当前日期

Example Scenario

示例场景

Trigger: User downloads new Fidelity balances CSV
Agent workflow:
  1. ✅ Read Balances CSV - Portfolio: ${FG_PORTFOLIO_BASELINE_VALUE}, Margin: ${FG_MARGIN_BASELINE_BALANCE}
  2. ✅ Safety check - Previous: $0, Current: ${FG_MARGIN_BASELINE_BALANCE} (+${FG_MARGIN_BASELINE_BALANCE} < ${FG_MARGIN_JUMP_ALERT_THRESHOLD} threshold) - PASS
  3. ✅ Calculate metrics:
    • Monthly interest: ${FG_MARGIN_MONTHLY_INTEREST_COST}
    • Portfolio-to-margin ratio: ${FG_PORTFOLIO_MARGIN_RATIO}
    • Coverage ratio: ${FG_DIVIDEND_COVERAGE_RATIO} (dividends ÷ interest)
  4. ✅ Add entry to Margin Dashboard:
    • Date: ${FG_MARGIN_EXAMPLE_DATE}
    • Balance: ${FG_MARGIN_BASELINE_BALANCE}
    • Rate: ${FG_MARGIN_INTEREST_RATE}
    • Cost: ${FG_MARGIN_MONTHLY_INTEREST_COST}
    • Notes: "Month 1 - Building foundation, on track"
  5. ✅ Update summary section:
    • Current balance: ${FG_MARGIN_BASELINE_BALANCE}
    • Monthly cost: ${FG_MARGIN_MONTHLY_INTEREST_COST}
    • Annual cost: ${FG_MARGIN_ANNUAL_INTEREST_COST}
    • Dividend income: ${FG_DIVIDEND_MONTHLY_INCOME}
    • Coverage: ${FG_DIVIDEND_COVERAGE_RATIO}
  6. ✅ Generate status: "🟢 Excellent health - Ratio ${FG_PORTFOLIO_MARGIN_RATIO}, Coverage ${FG_DIVIDEND_COVERAGE_RATIO}"
  7. ✅ LOG: "Updated Margin Dashboard - Month 1, ${FG_MARGIN_BASELINE_BALANCE} balance, ${FG_PORTFOLIO_MARGIN_RATIO} ratio"

Skill Type: Domain (workflow guidance) Enforcement: BLOCK (financial risk critical) Priority: Critical Line Count: < 400 (following 500-line rule) ✅
触发条件: 用户下载新的Fidelity余额CSV文件
Agent工作流:
  1. ✅ 读取余额CSV文件 - 投资组合: ${FG_PORTFOLIO_BASELINE_VALUE}, 保证金: ${FG_MARGIN_BASELINE_BALANCE}
  2. ✅ 安全检查 - 之前余额: $0, 当前余额: ${FG_MARGIN_BASELINE_BALANCE}(增加${FG_MARGIN_BASELINE_BALANCE} < ${FG_MARGIN_JUMP_ALERT_THRESHOLD}阈值) - 通过
  3. ✅ 计算指标:
    • 月度利息: ${FG_MARGIN_MONTHLY_INTEREST_COST}
    • 投资组合与保证金比率: ${FG_PORTFOLIO_MARGIN_RATIO}
    • 覆盖比率: ${FG_DIVIDEND_COVERAGE_RATIO}(股息 ÷ 利息)
  4. ✅ 向保证金仪表板添加条目:
    • 日期: ${FG_MARGIN_EXAMPLE_DATE}
    • 余额: ${FG_MARGIN_BASELINE_BALANCE}
    • 利率: ${FG_MARGIN_INTEREST_RATE}
    • 成本: ${FG_MARGIN_MONTHLY_INTEREST_COST}
    • 备注: "Month 1 - Building foundation, on track"
  5. ✅ 更新摘要部分:
    • 当前余额: ${FG_MARGIN_BASELINE_BALANCE}
    • 月度成本: ${FG_MARGIN_MONTHLY_INTEREST_COST}
    • 年度成本: ${FG_MARGIN_ANNUAL_INTEREST_COST}
    • 股息收入: ${FG_DIVIDEND_MONTHLY_INCOME}
    • 覆盖比率: ${FG_DIVIDEND_COVERAGE_RATIO}
  6. ✅ 生成状态: "🟢 健康状况极佳 - 比率${FG_PORTFOLIO_MARGIN_RATIO}, 覆盖比率${FG_DIVIDEND_COVERAGE_RATIO}"
  7. ✅ 日志: "Updated Margin Dashboard - Month 1, ${FG_MARGIN_BASELINE_BALANCE} balance, ${FG_PORTFOLIO_MARGIN_RATIO} ratio"

Skill Type: Domain (workflow guidance) Enforcement: BLOCK (financial risk critical) Priority: Critical Line Count: < 400 (following 500-line rule) ✅