margin-management
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMargin 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 (see ). Use or shell environment variables; do not hardcode personal numbers in this skill.
.env.env.examplepython-dotenv实际金额、日期和私有策略目标必须来自文件(参考)。使用或Shell环境变量;请勿在此技能中硬编码个人数据。
.env.env.examplepython-dotenvRequired .env
values
.env必填.env
变量
.envFG_STRATEGY_START_DATE- ,
FG_MARGIN_INTEREST_RATEFG_MARGIN_INTEREST_RATE_DECIMAL FG_MARGIN_JUMP_ALERT_THRESHOLD- ,
FG_CURRENT_MONTHLY_DRAW,FG_MONTH6_DRAW_TARGET,FG_MONTH12_DRAW_TARGETFG_MONTH18_DRAW_TARGET - ,
FG_BUSINESS_INCOME_MONTHLY,FG_BUSINESS_INJECTION_REDFG_BUSINESS_INJECTION_CRITICAL - Latest example/demo values: ,
FG_PORTFOLIO_BASELINE_VALUE,FG_MARGIN_BASELINE_BALANCEFG_DIVIDEND_MONTHLY_INCOME
FG_STRATEGY_START_DATE- 、
FG_MARGIN_INTEREST_RATEFG_MARGIN_INTEREST_RATE_DECIMAL FG_MARGIN_JUMP_ALERT_THRESHOLD- 、
FG_CURRENT_MONTHLY_DRAW、FG_MONTH6_DRAW_TARGET、FG_MONTH12_DRAW_TARGETFG_MONTH18_DRAW_TARGET - 、
FG_BUSINESS_INCOME_MONTHLY、FG_BUSINESS_INJECTION_REDFG_BUSINESS_INJECTION_CRITICAL - 最新示例/演示值:、
FG_PORTFOLIO_BASELINE_VALUE、FG_MARGIN_BASELINE_BALANCEFG_DIVIDEND_MONTHLY_INCOME
Core Workflow
核心工作流
1. Read Fidelity Balances CSV
1. 读取Fidelity余额CSV文件
Location:
notebooks/updates/Balances_for_Account_{account_id}.csvKey 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 drawAction:
- 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 strategyNotes 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 // 30Month 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:
- Data-driven: Decisions backed by actual dividend income, not projections
- Safety-first: Never scale if ratio drops below 3.5:1
- Business income as insurance: Available ${FG_BUSINESS_INCOME_MONTHLY}/month, not primary strategy
- Monte Carlo backstop: ${FG_BUSINESS_BACKSTOP_PROBABILITY} of scenarios used business income at some point
核心原则: 基于信心的缩放,而非时间强制要求
决策框架:
- 数据驱动: 决策基于实际股息收入,而非预测
- 安全优先: 比率低于3.5:1时绝不缩放
- 业务收入作为保险: 每月可使用${FG_BUSINESS_INCOME_MONTHLY},而非主要策略
- 蒙特卡洛备份: ${FG_BUSINESS_BACKSTOP_PROBABILITY}的场景中会在某些时候使用业务收入
Business Income Backstop
业务收入备份
Available: ${FG_BUSINESS_INCOME_MONTHLY}/month from business operations
Usage Scenarios:
- ⛔ Margin call (ratio < 3:1): MUST USE business income immediately
- ⚠️ Market correction (20-30% drop): OPTIONAL - assess need
- 🎯 Acceleration (reach FI faster): OPTIONAL - strategic choice
Current Philosophy: Insurance policy only, not active strategy component
可用额度: 每月从业务运营中获得${FG_BUSINESS_INCOME_MONTHLY}
使用场景:
- ⛔ 追加保证金(比率 < 3:1): 必须立即使用业务收入
- ⚠️ 市场回调(下跌20-30%): 可选 - 评估需求
- 🎯 加速(更快实现财务独立): 可选 - 战略性选择
当前理念: 仅作为保险政策,而非主动策略组成部分
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.yamlgoogle_sheets.portfolio_tracker.spreadsheet_idUse 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.yamlgoogle_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 directory
notebooks/updates/ - 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 command
date
更新保证金仪表板前:
- Fidelity余额CSV文件是最新日期
- CSV文件位于目录
notebooks/updates/ - Google Sheets中存在保证金仪表板工作表
- 已知之前的保证金余额(用于检测大幅变动)
- 股息追踪器已更新(用于计算覆盖比率)
- 通过命令获取当前日期
date
Example Scenario
示例场景
Trigger: User downloads new Fidelity balances CSV
Agent workflow:
- ✅ Read Balances CSV - Portfolio: ${FG_PORTFOLIO_BASELINE_VALUE}, Margin: ${FG_MARGIN_BASELINE_BALANCE}
- ✅ Safety check - Previous: $0, Current: ${FG_MARGIN_BASELINE_BALANCE} (+${FG_MARGIN_BASELINE_BALANCE} < ${FG_MARGIN_JUMP_ALERT_THRESHOLD} threshold) - PASS
- ✅ 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)
- ✅ 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"
- ✅ 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}
- ✅ Generate status: "🟢 Excellent health - Ratio ${FG_PORTFOLIO_MARGIN_RATIO}, Coverage ${FG_DIVIDEND_COVERAGE_RATIO}"
- ✅ 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工作流:
- ✅ 读取余额CSV文件 - 投资组合: ${FG_PORTFOLIO_BASELINE_VALUE}, 保证金: ${FG_MARGIN_BASELINE_BALANCE}
- ✅ 安全检查 - 之前余额: $0, 当前余额: ${FG_MARGIN_BASELINE_BALANCE}(增加${FG_MARGIN_BASELINE_BALANCE} < ${FG_MARGIN_JUMP_ALERT_THRESHOLD}阈值) - 通过
- ✅ 计算指标:
- 月度利息: ${FG_MARGIN_MONTHLY_INTEREST_COST}
- 投资组合与保证金比率: ${FG_PORTFOLIO_MARGIN_RATIO}
- 覆盖比率: ${FG_DIVIDEND_COVERAGE_RATIO}(股息 ÷ 利息)
- ✅ 向保证金仪表板添加条目:
- 日期: ${FG_MARGIN_EXAMPLE_DATE}
- 余额: ${FG_MARGIN_BASELINE_BALANCE}
- 利率: ${FG_MARGIN_INTEREST_RATE}
- 成本: ${FG_MARGIN_MONTHLY_INTEREST_COST}
- 备注: "Month 1 - Building foundation, on track"
- ✅ 更新摘要部分:
- 当前余额: ${FG_MARGIN_BASELINE_BALANCE}
- 月度成本: ${FG_MARGIN_MONTHLY_INTEREST_COST}
- 年度成本: ${FG_MARGIN_ANNUAL_INTEREST_COST}
- 股息收入: ${FG_DIVIDEND_MONTHLY_INCOME}
- 覆盖比率: ${FG_DIVIDEND_COVERAGE_RATIO}
- ✅ 生成状态: "🟢 健康状况极佳 - 比率${FG_PORTFOLIO_MARGIN_RATIO}, 覆盖比率${FG_DIVIDEND_COVERAGE_RATIO}"
- ✅ 日志: "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) ✅