trader-alerts 是一个价格提醒工具，用于在价格目标、止损位或纽约证券交易所开盘钟声触发时发出提醒。它只提供提醒信息，不会执行任何交易操作。
用途： 监控用户关心的股票价格条件，包括价格高于或低于目标价、止损、较前收盘价的百分比变动，以及交易所开盘提醒。
主要能力：
- 支持多种规则类型：above（价格达到或高于设定值）、below/stop（价格达到或低于设定值）、pct_move（较前收盘价或参考价变动指定百分比，可选方向）、opening_bell（纽约证券交易所开盘）。
- 通过命令行脚本 alerts.py 管理提醒：clock 查看交易所开闭状态、quote 获取报价并写入 trader/prices.json、add 添加规则、check 检查触发、list 列出规则、reset 重置规则。
- 报价来源：默认使用 Yahoo Finance 的非官方免费 JSON 接口，每只股票一次请求，间隔半秒；也可尝试 Stooq 的免费 CSV 接口（使用 --source stooq）。免费报价有延迟，适合提醒和检查仓位，不适合精确择时。
- 读写文件：trader/alerts.json 保存规则，trader/state/alerts.json 记录已触发规则及时间，trader/prices.json 保存最新报价并可合并供其他交易工具使用。
- 内置纽约证券交易所交易日历，包含 2026 年和 2027 年的节假日及提前收盘日，并自动处理夏令时。
使用方式： 通过 python3 "${CLAUDE_SKILL_DIR}/alerts.py" 加子命令运行。例如：add --symbol AAPL --above 350 添加价格高于提醒；add --symbol BAC --stop 50 --note "my stop" 添加止损提醒；add --symbol KO --pct 3 添加百分比变动提醒；add --opening-bell 添加开盘提醒；check 检查是否触发（退出码 0 表示有提醒触发）；list 列出规则；reset 重置指定规则。用户可用自然语言描述需求，工具将其转为规则并确认。
适用场景： 适合需要监控股票价格条件、止损位或开盘时刻的个人交易者，尤其适合与 trader-budget、trader-risk、trader-tax、trader-rebalance 等工具配合使用，将最新报价写入 trader/prices.json 供其他工具读取。
限制：
- 不执行下单、取消或修改订单，不声称报价为实时，不预测价格走势。
- 免费报价存在延迟，实际成交价以券商为准。
- 若 Yahoo 和 Stooq 均不可用，需从券商连接器获取价格并手动写入 trader/prices.json。
- 纽约证券交易所节假日列表仅覆盖 2026 年和 2027 年，其他年份会提示未知。
- 默认使用模拟交易（paper: true），实盘交易由用户自行决定并在配置中开启。
- 本工具仅为教育和工具性质，不构成财务建议。