Jakeschincariol/trader-skill

它是什么

Trader‑skill 是一组用纯 Python 编写的 Claude 技能（插件），让 Claude 帮助您构建和管理纸面交易组合。每个技能执行一个单一、明确定义的任务——例如复制对冲基金的 13‑F 文件、监控新闻、预算仓位、检查风险、生成券商订单、跟踪国会交易等。这些工具只读取公共数据源（SEC EDGAR、众议院书记 PTR PDF、新闻 RSS、雅虎财经），并且从不自动下单；每笔交易必须由人工确认。

如何获取

1. 在 Claude 中 – 粘贴 GitHub URL 并运行 install skill。
2. 作为 Claude Code 插件 – 使用 README 中显示的市场命令。
3. 手动 – 克隆仓库并将 trader‑* 文件夹复制到 ~/.claude/skills/（或项目的 .claude/skills/）。

代码运行在 Python 3.8+ 上，无外部依赖；只需在 trader/config.json 或通过 SEC_USER_AGENT 设置您的 SEC 用户代理。

核心能力（十一个命令）

命令	目的	功能
/trader-copycat	逆向工程一个申报者	下载 13‑F‑HR，提取持仓，计算权重变化，写入 targets.json。
/trader-news	新闻监控	为您持有的每个股票代码拉取头条和 8‑K 文件，标记相关项目。
/trader-budget	预算管理	为每个目标分配美元金额，强制执行现金缓冲和每只股票上限，输出 orders.json。
/trader-pelosi	国会交易跟踪	一旦出现众议院 PTR PDF 就获取，解析为行，对新文件发出警报。
/trader-analyst	收益数据提取器	检索 XBRL 事实（收入、每股收益、利润率、增长）和最新收益发布。
/trader-screener	自定义筛选器	将用户定义的规则（rules.json）应用于指标（metrics.json），并对通过的股票进行排名。
/trader-risk	风险门	根据用户限制（规模、仓位、现金、阻止的股票代码）验证每个提议的订单，并返回 PASS/BLOCK。
/trader-broker	订单执行器（手动）	格式化券商兼容订单，显示给用户，并在“是”后发送到配置的券商连接器（默认 Alpaca MCP，纸面账户）。
/trader-tax	税收损失收割助手	跟踪成本基础批次，识别损失收割候选，尊重洗售窗口。
/trader-alerts	价格警报服务	当价格目标、止损或市场开盘/收盘发生时触发，使用 NYSE 日历。
/trader-rebalance	组合再平衡器	检测与目标权重的偏差（超出用户定义的区间），并提出纠正交易。

典型工作流程

1. 复制基金 – /trader-copycat → targets.json。
2. 调整仓位规模 – /trader-budget → orders.json。
3. 风险检查 – /trader-risk（阻止任何违规订单）。
4. 确认并发送 – /trader-broker 显示订单；您输入 yes；Claude 调用您的券商。
5. 持续进行 – 安排 /trader-news、/trader-pelosi、/trader-alerts。
6. 每季度 – 重复 copycat 并运行 /trader-rebalance。

直接运行代码

仓库附带小型离线测试夹具，因此您可以本地尝试命令，例如：

python3 trader-copycat/edgar13f.py find buffett
python3 trader-news/news.py --tickers AAPL GOOGL --hours 24
python3 trader-pelosi/ptr.py index --member pelosi
python3 -m unittest discover -s tests -v

所有脚本仅使用 Python 标准库。

限制与安全说明

• 非财务建议 – 这些工具仅执行数据检索和算术。
• 纸面优先 – 默认配置使用 Alpaca 的纸面交易端点；真实资金密钥必须通过环境变量提供。
• 数据延迟 – 13‑F 文件最多 45 天旧；国会 PTR 在交易后 45 天内披露。
• 无自动执行 – 订单仅在 Claude 中用户明确确认后发送。
• 公共源脆弱性 – 依赖 SEC EDGAR、众议院书记 PDF、RSS 源和非官方雅虎财经端点；任何更改都可能破坏脚本。

许可证与作者

MIT 许可，作者 Jake Schincariol (https://opusjake.ai)。