kanchi-dividend-us-tax-accounting

Kanchi 股息美国税务核算

概述

为股息投资者采用实用的美国税务工作流程，同时确保决策可审计。 重点关注账户配置和分类，而非替代法律或税务建议。

适用场景

在用户需要以下内容时使用此技能：

• 美国股息税务分类规划（符合条件与普通股息的假设）。
• 年末税务规划前的持有期检查。
• 股票／REIT／BDC／MLP 收益类持仓的账户配置决策。
• 标准化的年度股息税务备忘录格式。

前提条件

准备持仓级输入：

• ticker
• instrument_type
• account_type
• hold_days_in_window（如有）

预期 JSON 输入格式

{
  "holdings": [
    {
      "ticker": "JNJ",
      "instrument_type": "stock",
      "account_type": "taxable",
      "security_type": "common",
      "hold_days_in_window": 75
    },
    {
      "ticker": "O",
      "instrument_type": "reit",
      "account_type": "ira",
      "hold_days_in_window": 100
    }
  ]
}

如需生成确定性的输出文件，请提供 JSON 输入并运行：

python3 skills/kanchi-dividend-us-tax-accounting/scripts/build_tax_planning_sheet.py \
  --input /path/to/tax_input.json \
  --output-dir reports/

注意事项

务必明确说明：税务结果取决于个人情况和司法管辖区。 将此技能视为规划支持，并将最终申报决策交由税务专业人士处理。

工作流程

1) 对每项分配收入流进行分类

对每项持仓，将预期现金流分类为：

• 可能符合条件的股息。
• 普通股息／不符合条件的分配。
• 适用时，REIT／BDC 特有的分配组成部分。

使用 references/qualified-dividend-checklist.md 检查持有期和分类。

2) 验证持有期资格假设

对于可能符合条件的税务处理：

• 检查除息日窗口。
• 检查衡量窗口内所需的最低持有天数。
• 标记可能无法满足持有期要求的仓位。

如果数据不完整，将状态标记为 ASSUMPTION-REQUIRED。

3) 映射至申报字段

将规划假设映射至预期税表类别：

• 普通股息总额。
• 符合条件的股息子集。
• 单独申报时的 REIT 相关组成部分。

始终使用统一的表格术语，以便年末对账。

4) 制定账户配置建议

使用 references/account-location-matrix.md，根据资产的税务特征进行配置：

• 将可能继续以符合条件的股息为主的持仓放入应税账户。
• 将普通收入型分配较高的持仓放入税收优惠账户。

当限制因素相互冲突（流动性、策略、集中度）时，明确说明其中的权衡。

5) 编制年度规划备忘录

使用 references/annual-tax-memo-template.md，并包含：

• 所用假设。
• 分配收入分类摘要。
• 已采取的账户配置措施。
• 需由 CPA／税务顾问审核的未决事项。

输出

始终输出：

1. 持仓级分配收入分类表。
2. 附带理由的账户配置建议表。
3. 未解决税务假设的未决风险清单。
4. 可选：由 skills/kanchi-dividend-us-tax-accounting/scripts/build_tax_planning_sheet.py 生成的文件。

周期

至少按以下频率进行：

• 每年（60 分钟）：完整的税务规划备忘录和账户配置审查。
• 每季度（15 分钟）：更新近期买入持仓的持有期状态。
• 临时：重大仓位变动、增持 REIT／BDC，或收到 kanchi-dividend-review-monitor 触发的审查时，重新运行。

多技能交接

• 从 kanchi-dividend-sop 接收候选标的和持仓列表。
• 从 kanchi-dividend-review-monitor 接收风险事件背景（WARN/REVIEW）。
• 在新增持仓前，将账户配置限制条件反馈给 kanchi-dividend-sop。

资源

• skills/kanchi-dividend-us-tax-accounting/scripts/build_tax_planning_sheet.py：税务规划表生成器。
• skills/kanchi-dividend-us-tax-accounting/scripts/tests/test_build_tax_planning_sheet.py：税务规划输出测试。
• references/qualified-dividend-checklist.md：分类和持有期检查清单。
• references/account-location-matrix.md：按账户类型和工具划分的配置矩阵。
• references/annual-tax-memo-template.md：可重复使用的备忘录结构。