mcpField
T
tax-efficiency

tax-efficiency

github.com/joellewis其他218696 次安装15 周前更新
代码仓库

关于 tax-efficiency

tax-efficiency 是面向投资者和财务规划师的税务规划技能,涵盖账户配置、税损收割、税后回报、退休提款等策略,并提供 Python 示例和可导入的计算模块。

主要功能

  1. 01不同账户类型的资产配置
  2. 02税损收割与洗售规则
  3. 03税后回报与税务拖累计算
  4. 04税务批次选择方法
  5. 05Roth 转换盈亏平衡分析
  6. 06RMD 与提款顺序

适用场景

  1. 01在不同账户类型间配置债券与股票
  2. 02评估税损收割并跟踪洗售限制
  3. 03比较 Roth 转换的税率条件
  4. 04规划退休提款与 RMD

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/joellewis/finance_skills --skill tax-efficiency

安装后在 Claude Code 中输入/tax-efficiency确认已加载。

附带文件scripts/tax_efficiency.py

详细介绍

税务高效投资

核心概念

资产配置位置

将税务效率低的资产放入税收优惠账户,将税务效率高的资产放入应税账户:

  • 递延纳税账户(Traditional IRA、401k): 债券、REIT、高换手率基金、TIPS——产生普通收入的资产
  • 免税账户(Roth IRA、Roth 401k): 预期增长最高的资产——所有增长收益永久免税
  • 应税账户: 指数股票基金(低换手率、合格股息、可进行税损收割)、市政债券、税务管理型基金

普通收入税率与资本利得税率之间的差距越大,税收优惠账户相对于投资组合总规模越大,资产配置位置带来的收益就越高。

税损收割(TLH)

确认投资损失以抵消资本利得,在维持市场敞口的同时降低当前纳税义务:

  • 卖出亏损头寸,立即买入类似(但并非“实质上相同”)的替代资产
  • 收割的损失可按 1:1 抵消收益;净亏损每年最多可抵消 3,000 美元的普通收入;超出部分可无限期结转
  • 洗售规则(61 天窗口): 在 61 天窗口期内(卖出日前 30 天 + 卖出日 + 卖出日后 30 天),不得重新买入相同或实质上相同的证券——此规则适用于所有账户(包括配偶的账户和 IRA)
  • TLH 带来的税务超额收益: 在投资组合生命周期的早期,估计每年为 0.5%–1.5%;随着成本基础上升,这一收益会降低
  • 市场波动期间和投资的头几年最容易出现理想机会
税后回报

不同类型的收入适用不同税率:

  • 利息收入: 按普通收入税率征税
  • 合格股息: 按长期资本利得税率征税(0%、15% 或 20% + 3.8% NIIT)
  • 短期资本利得(持有时间 ≤ 1 年): 按普通收入税率征税
  • 长期资本利得(持有时间 > 1 年): 适用优惠税率(0%、15% 或 20% + 3.8% NIIT)
  • MAGI 超过 250,000 美元(MFJ)时适用 3.8% NIIT——这一法定门槛不按通胀调整
  • 收入的税后回报:R_at = R × (1 - t)
  • 资本利得仅在实现时征税,因此可以享受递延纳税的好处
税务拖累

税收对投资回报造成的年度成本:

  • 税务拖累 = 税前回报 - 税后回报
  • 高换手率基金会产生更多短期收益 → 税务拖累更高
  • 低换手率指数基金可最大限度降低税务拖累
  • ETF 通常比共同基金税务效率更高(通过实物申购/赎回流程)
税务批次管理

卖出部分头寸时,选择卖出哪些批次会影响纳税义务:

  • 特定识别法: 精确选择要卖出的批次
  • HIFO(最高成本先出): 优先卖出成本基础最高的批次,以尽量减少收益
  • FIFO(先进先出): 默认方法;可能在较早买入的批次上实现较大收益
  • 税务最优: 综合持有期和收益/损失,选择可最大限度降低本纳税年度纳税义务的批次
Roth 转换

将 Traditional IRA/401k 资产转换为 Roth 资产,现在缴纳普通所得税,以换取日后的免税增长和提款:

  • 盈亏平衡分析: 如果当前边际税率 < 预期未来边际税率,转换就有利
  • 有利于转换的因素: 投资期限较长、当前收入较低的年份、预期未来税率上升、希望降低未来 RMD、遗产规划方面的好处
  • 部分转换: 仅转换足以填满当前税级的金额(“填满税级”)
  • 转换税额:转换金额 × 当前边际税率
法定最低分配额(RMD)

从 73 岁开始,必须每年从税收递延账户(Traditional IRA、401k)提取资金(根据 SECURE 2.0,2033 年起提高到 75 岁):

  • RMD = 账户余额(上一年 12 月 31 日)/ 分配期(参照 IRS 统一预期寿命表)
  • 未足额提取的罚金:对短缺金额征收 25% 的消费税(此前为 50%)
  • RMD 按普通收入征税,可能使退休人员进入更高的税率档
  • 账户持有人在世期间,Roth IRA 无 RMD
提取顺序

退休后从不同类型账户提取资金的顺序:

  • 一般规则: 应税账户 → 税收递延账户 → Roth(尽可能长时间保留免税增长)
  • 优化方法: 先从应税账户提取,然后通过从税收递延账户提取资金填满较低税率档,使用 Roth 避免跨入更高税率档
  • 动态策略: 根据每年的收入、扣除额和税率档门槛调整
慈善捐赠策略
  • 捐赠增值股票: 避免资本利得税,并按完整公允市值扣除(持有时间必须超过 1 年)
  • 合格慈善分配(QCD): 每年直接从 IRA 向慈善机构捐赠最高 $111,000(2026 年限额,每年按指数调整)(计入 RMD,并从应税收入中排除);适用于 70½ 岁及以上人士
  • 捐赠者建议基金(DAF): 将多年的捐赠集中起来以申请分项扣除,免税投资,并在一段时间内向慈善机构分配

关键公式

公式表达式使用场景
税后收益率(收入)R_at = R × (1 - t)债券/利息收入的税后收益
税后收益率(递延收益)R_at = ((1 + R)^n × (1 - t_cg) + t_cg)^(1/n) - 1享有递延收益的未实现股票收益
税损收割价值TLH_value = loss × marginal_tax_rate进行税损收割带来的即时税收优惠
Roth 转换盈亏平衡t_now < t_future当前税率低于未来税率时进行转换
RMD 金额RMD = balance_Dec31 / distribution_period法定最低分配额
捐赠增值股票的优惠节税额 = FMV × t_income + gain × t_cg_avoided捐赠增值股票的税收优惠(扣除额 + 避免的资本利得税)

示例演算

示例 1:优化资产配置位置

已知: 应税经纪账户中有 $500K,Traditional IRA 中有 $500K。投资组合目标:50% 债券(收益率为 5%)和 50% 股票(预期总回报率为 10%,合格股息为 2%)。边际税率:普通收入为 32%,长期资本利得(LTCG)为 15%。 计算: 最优资产配置及相对于简单配置的年度节税额。 解答:

  1. 最优配置: IRA 中配置债券($500K);应税账户中配置股票($500K)。
  2. 简单配置(各账户均为 50/50): 应税账户中有 $250K 债券 + $250K 股票;IRA 中有 $250K 债券 + $250K 股票。
  3. 税务拖累 — 简单配置: 应税债券:$250K × 5% × 32% = $4,000。应税股票股息:$250K × 2% × 15% = $750。总税额 = $4,750。
  4. 税务拖累 — 最优配置: 仅对股票股息征税:$500K × 2% × 15% = $1,500。总税额 = $1,500。
  5. 年度节税额: $4,750 - $1,500 = $3,250/年(占投资组合总额的 0.325%)。
  6. 经过 20 年复利增长,这将显著增加税后财富。
示例 2:Roth 转换的盈亏平衡点

已知: 考虑将 $50,000 从 Traditional IRA 转入 Roth。当前边际税率:24%。转换税款由外部资金支付。投资期限:20 年。预期收益率:7%。 简化假设: 假设这 $12,000 若不用于支付转换税款,就会以同样的 7% 增长,且不产生税务拖累——也就是说,侧边资金本身的增长不纳税。 计算: 转换达到盈亏平衡时的未来边际税率。 解答:

  1. 当前转换成本: $50,000 × 24% = 今天缴纳 $12,000 的税款。
  2. Traditional IRA 路径: $50,000 增长至 $50,000 × (1.07)^20 = $193,484。提取时税后金额:$193,484 × (1 - t_future)。
  3. Roth 路径: $50,000 免税增长至 $193,484,但 $12,000 的侧边资金放弃了增长机会,原本可增长至 $12,000 × (1.07)^20 = $46,436。Roth 净值:$193,484 - $46,436 = $147,048。
  4. 盈亏平衡点: 令 Traditional 税后金额 = Roth 净值。$193,484 × (1 - t_future) = $193,484 - $46,436 → t_future = $46,436 / $193,484 = 24.0%。
  5. 结论: 在这一简化假设下,未来盈亏平衡税率等于当前税率(24%)——两边都按相同的 (1.07)^20 增长,因此投资期限和收益率相互抵消。实际上,应税侧边资金的股息和已实现收益会受到税务拖累,因此即使未来税率仅与当前税率持平,由外部资金支付转换税款仍会使比较结果倾向 Roth。

常见误区

  • 违反 TLH 洗售规则,包括在 61 天洗售窗口期内(出售前 30 天至出售后 30 天)在其他账户、IRA 或配偶账户中买入
  • 过度收割亏损,导致收益递延至之后更高的税档(成本基础下调会产生累积效应)
  • 在资产配置位置决策中未考虑州税——各州的税务处理差异很大
  • 忽视捐赠增值证券而非现金的税务优惠(可避免资本利得税并获得全额扣除)
  • 因 RMD 被迫在不利时机出售——应提前规划提取时间,避免错过截止日期
  • Roth 转换过于激进,导致转换当年进入更高税档
  • 忘记超过 $250,000 MAGI(MFJ)后需缴纳 3.8% 净投资所得税(NIIT)——该法定门槛不会按通胀调整,因此每年都会涵盖更多纳税人
  • 未统筹规划配偶双方账户的税务策略

交叉引用

  • investment-policy(wealth-management 插件):投资政策声明(IPS)中的税务限制决定资产配置位置和换手管理
  • performance-attribution(wealth-management 插件):税后收益归因需要采用税务感知计算
  • debt-management(wealth-management 插件):抵押贷款利息能否抵扣会影响税务规划
  • savings-goals(wealth-management 插件):账户类型选择(Roth 还是 Traditional)是核心税务决策
  • liquidity-management(wealth-management 插件):使用不同类型账户的税务影响会影响流动性规划
  • tax-loss-harvesting(wealth-management 插件):专门的 TLH 工作流技能,涵盖详细的候选标的识别、洗售跟踪和执行规划
  • financial-planning-workflow(advisory-practice 插件):税务感知策略是综合财务计划中核心的建议内容
  • financial-statements(wealth-management 插件):成本基础和内含资本利得的基础知识,是选择税务批次和推迟纳税决策的依据
  • insurance-planning(wealth-management 插件):保费支付方的选择会影响残疾福利、年金收入和人寿保险金的税务处理
  • estate-gifting(wealth-management 插件):负责遗产转移税相关事宜,包括终身免税额、年度免税额赠与、基础成本上调还是结转,以及遗产层面的慈善结构选择
  • retirement-decumulation(wealth-management 插件):将提款顺序和 RMD 机制应用于退休支出计划,包括护栏、补足空档年份税档和确定 Social Security 领取时间
  • equity-compensation(wealth-management 插件):RSU/期权税务处理、ISO 行权的 AMT,以及捐赠已升值雇主股票,将税务规划延伸至薪酬事件

运行脚本

使用 uv run scripts/tax_efficiency.py 运行(PEP 723 标头会自动解析依赖项),也可先运行 pip install numpy scipy,再使用 python3 scripts/tax_efficiency.py。直接运行会输出演示,涵盖税后收益、税务拖累、TLH 收益、资产配置位置和 Roth 转换盈亏平衡点。传入 --verify 可断言演示输出与此技能中的示例相符(打印 PASS/FAIL);传入 --help 可查看可用类的概述。该文件主要用于作为模块导入(例如,from tax_efficiency import AfterTaxReturn, AssetLocation, BreakevenAnalysis)。

评论

支持 Markdown