mcpField
K
kanchi-dividend-us-tax-accounting

kanchi-dividend-us-tax-accounting

github.com/tradermonty其他3.4k3.4k 次安装2 天前更新
代码仓库

关于 kanchi-dividend-us-tax-accounting

面向美国股息投资者的税务规划技能,可分类分配收入、核查持有期假设并整理账户配置建议,形成可审计的年度备忘录;用于规划,不替代专业税务意见。

主要功能

  1. 01分类股息分配收入
  2. 02核查持有期资格
  3. 03映射至税表类别
  4. 04提供账户配置建议
  5. 05生成年度规划备忘录

适用场景

  1. 01年末前检查股息持仓
  2. 02比较应税与税优账户配置
  3. 03整理供 CPA 审阅的假设

安装

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

$npx skills add https://github.com/tradermonty/claude-trading-skills --skill kanchi-dividend-us-tax-accounting

安装后在 Claude Code 中输入/kanchi-dividend-us-tax-accounting确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

requirements.txt
agents/
openai.yaml
references/
account-location-matrix.md
annual-tax-memo-template.md
input-schema.md
qualified-dividend-checklist.md
scripts/
build_tax_planning_sheet.py
scripts/tests/
conftest.py
test_build_tax_planning_sheet.py

详细介绍

Kanchi 股息美国税务会计

概述

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

适用场景

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

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

前提条件

准备持仓级输入:

  • ticker
  • instrument_type
  • account_type
  • hold_days_in_window(如有)

使用 references/input-schema.md 中的准确 JSON 格式约定和示例。

如需生成确定性的输出文件,请提供 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:可复用的备忘录结构。

评论

支持 Markdown