trader-tax 是一个名为 Tax Optimizer 的技能，用于对持仓批次（lots）做算术层面的税务辅助。根据资料，它只做数字计算，帮助用户在卖出前看清可能实现的盈亏，但绝不替用户决定税务上是否合适。资料明确声明：这不是税务建议，涉及税务的问题应由税务专业人士判断，并且在使用该技能的每个回答中都应尽早说明这一点。
用途 该技能面向需要按成本批次管理股票持仓并评估卖出、亏损收割影响的用户。它跟踪每个持仓的成本批次，支持 FIFO（先进先出，多数券商默认）、HIFO（最高成本优先）和 specific（指定批次）三种批次方法，并展示各批次的未实现盈亏以及属于短期还是长期。
主要能力
- 批次报告：通过 lots.py report --lots 列出每一批次及其盈亏和期限属性，并显示每个批次变为长期持有的日期。
- 卖出测算：通过 lots.py sell 命令，按计划卖出的股数和批次方法，测算该笔卖出将实现的盈亏；可用 --method specific --lots 指定具体批次。
- 亏损收割候选：通过 lots.py harvest --min-loss 指定最小亏损额（也可用 --min-pct 指定百分比阈值）筛选候选，展示估算亏损、短长期拆分、洗售冲突以及最早可买回日期；存在冲突的候选不会被提议。
- 洗售检查：通过 lots.py wash 检查当天买入某股票是否构成洗售。
- 成交记录：卖出成交后，用 lots.py sell ... --record 更新批次并记录当年已实现结果。
使用方式 该技能以命令行脚本方式使用，命令形如 python3 "${CLAUDE_SKILL_DIR}/lots.py" report --lots、sell KO 2 --price 90.11、harvest --min-loss 100、harvest --min-loss 100 --write、wash KO 等。它读取 trader/portfolio.json（持仓及批次：id、date、shares、cost，其中 cost 为总成本基础）、trader/prices.json（当前价格）、trader/orders.json（计划买入，用于洗售判断；harvest --write 会用卖出提案替换它）和 trader/state/tax.json（通过 sell --record 记录的已实现卖出）。批次来自 trader-broker 记录的成交或用户的券商对账单；如果持仓有股数但没有批次，需要向用户询问购买日期和成本，绝不编造成本基础。资料还给出使用步骤：先刷新价格并运行批次报告；任何卖出前先测算将实现的盈亏；收割时逐个候选展示估算亏损、短长期拆分、洗售冲突和最早买回日；只有在用户需要提案时才执行 harvest --write，再经 /trader-risk 和 /trader-broker，每笔订单一次确认；卖出成交后用 --record 更新并记录。
适用场景 适用于按批次管理美股持仓、评估卖出将实现的盈亏、筛选亏损收割候选、检查洗售冲突以及记录已实现卖出等场景。资料中的示例是一个 2026-10-13 买入的组合（AAPL、AXP、GOOGL、KO、BAC），每只股票一个批次，均为短期直到 2027-10-14；若 BAC 跌破 600 美元成本基础，harvest --min-loss 25 会列出 BAC-1 批次及亏损和“在该日期前不要再次买入 BAC”的提示；若 orders.json 中还有 BAC 买入计划，则会标记洗售而不提议卖出。
限制 该技能不提交任何申报、不给出税率或税单、不告诉用户欠多少税、不下单，也不提议其能识别为洗售的收割方案。洗售检查只能看到仍持有的其他批次、orders.json 中的计划买入和已记录的亏损卖出，无法看到 IRA、配偶账户或其他券商，而这些也计入洗售，需要明确告知用户。批次方法中的 specific 依赖用户在券商自身的税务批次设置中选择，因为发给券商的订单不携带批次 id。资料强调默认模拟交易（"paper": true），实盘由用户自行决定；只有 trader-broker 会下单，且需同时满足三个条件：trader-risk 当天通过该笔订单、用户在聊天中明确输入 yes、用户因订单工具设为“需要批准”而点击允许一次，并特别说明不要把订单工具设为“始终允许”；除非配置允许且用户确认，否则不涉及期权、保证金、卖空或杠杆；券商密钥存放在环境变量或 Claude Desktop 配置中，绝不在聊天中传递。该技能不构成税务建议或财务建议，仅为教育与工具用途。