day-trader-skill 实战指南:11 个 Claude 日内交易 Skill 的安装、编排与风控实现
day-trader-skill 实战指南:11 个 Claude 日内交易 Skill 的安装、编排与风控实现
day-trader-skill 把一次日内交易拆成 11 个可独立调用的 Claude Skill:从扫全市场图表、读突发新闻、逐根 K 线等入场、盘前定好止损止盈,到用 10,000 次重放估算胜率、按预算计算股数、逐条风控拦截,最后由用户逐单确认后才可能触达券商。本文以仓库 README.md 为主线,结合各 Skill 的 SKILL.md 与 Python 实现(如 trader-budget/size.py、trader-risk/check.py),把安装方式、交易流水线、配置字段、仓位公式、风控判定与测试方式讲清楚,读完后你应能独立跑通"扫描 → 新闻 → 入场 → 出场计划 → 重放 → 定仓 → 风控 → 下单 → 告警"这条完整链路。
一、项目定位:免费公开数据 + 纯标准库 Python
README 开篇给出的定位非常克制:11 个 Claude Skill,用于扫描成千上万张图表、跟踪突发新闻、为每次进出场定时,并在你真正冒一分钱风险之前重放结果。几条硬性事实:
- 免费、MIT、无需注册、无需 API Key。工具是普通 Python,只读公开数据:Yahoo Finance 图表、Nasdaq Trader 的股票代码目录、SEC EDGAR 以及美国众议院书记处(House Clerk)的披露文件。
- 默认纸面交易(
"paper": true),并且没有任何 Skill 能自行下单——下单必须由用户明确说"yes"。 - Python 3.8 或更新版本,无需 pip install。这一点在 tests/test_repo.py 中被固化成测试:脚本里不允许出现
zoneinfo、.removeprefix(、list[等 3.9+ 才有的写法,因此时区处理全部由工具自己实现(见下文的纽约时间计算)。 - 它是 Trader skill 的日内交易续作(v2),13F 跟单、选股器、税批次与再平衡留在 v1;本仓库的 11 个目录就是 v2 的全部内容,tests/test_repo.py 用一个断言把目录集合锁死为这 11 个。
一个重要的工程约束贯穿所有 Skill:每个工具只做一件事,并且只写"提案"。扫描器不选股,入场器不下单,预算器不调券商,风控器不改单,券商 Skill 在三个条件同时满足前不发出任何请求。
二、安装:三种落地方式
README 给了三条安装路径,选择依据是"你要不要 Python 工具"。
方式 1:在 Claude 对话里直接安装 Skill
把仓库地址贴进 Claude,再写一行 install skill:
https://github.com/Jakeschincariol/day-trader-skill
install skill
方式 2:作为 Claude Code 插件安装
/plugin marketplace add Jakeschincariol/day-trader-skill
/plugin install day-trader-skill@day-trader-skill
插件清单在 .claude-plugin/plugin.json 与 .claude-plugin/marketplace.json 中:name 为 day-trader-skill,skills 指向仓库根目录 ./,version 为 2.0.0,MIT 许可。
需要注意命名空间差异:以插件方式安装时 Claude Code 会给 Skill 加前缀,命令变成 /day-trader-skill:trader-scanner 这种形式。想要干净的 /trader-scanner,就改用方式 3 直接复制目录。
方式 3:克隆后复制目录
git clone https://gitcode.com/gh_mirrors/da/day-trader-skill.git
cp -r day-trader-skill/trader-* ~/.claude/skills/
- 项目级而非全局:把同样的
trader-*目录复制进你的仓库.claude/skills/。 - 完全没有 Claude Code:把任意一个
SKILL.md贴到对话开头,它就会作为一种"模式"运行。代价是失去 Python 工具,但方法论仍然成立。
环境准备与 SEC 身份标识
python3 -V # 需要 3.8 或更新
SEC 相关工具(trader-news/news.py、trader-analyst/facts.py)要求你表明身份,否则会拒绝调用:在 trader/config.json 中填 "sec_user_agent": "Your Name you@example.com",或设置环境变量 SEC_USER_AGENT。trader-budget/config.example.json 里已经预置了占位值 "Your Name you@example.com",直接改成真实姓名与邮箱即可。
trader/ 目录是整套 Skill 的共享工作区:每个 Skill 读上一个 Skill 写下的文件,路径默认都相对于你运行命令的当前项目根目录。
三、十一个 Skill 的分工
README 的表格是理解全局的骨架,完整继承如下:
| 命令 | 角色 | 做什么 |
|---|---|---|
/trader-scanner |
Chart Scanner | 扫描成千上万张图表找形态:开盘区间突破、旗形、超卖反弹。 |
/trader-news |
News Monitor | 跟踪你关注的每只股票的突发新闻,标出推动价格的消息。 |
/trader-entry |
Entry Timer | 逐根 K 线盯住形态,告诉你入场的那一刻。 |
/trader-exit |
Exit Planner | 在你入场前定好止损和目标,让你知道何时退出。 |
/trader-timemachine |
Time Machine | 在你冒一分钱风险前重放所有可能结果:10,000 次模拟交易日加每一次历史同形态。 |
/trader-risk |
Risk Manager | 用你的限额检查每笔交易,超标就拦下。 |
/trader-budget |
Budget Manager | 按预算和单笔最大亏损计算每个仓位的大小。 |
/trader-broker |
Order Executor | 把已批准的订单发给券商,默认纸面交易,永远需要你的 yes。 |
/trader-alerts |
Price Alerts | 价格、止损或开盘钟触发时响铃。 |
/trader-analyst |
Earnings Analyst | 读财报,总结变化了什么。 |
/trader-pelosi |
Pelosi Tracker | 国会股票交易披露一经提交就读取。 |
每个目录的结构都极简:一个 SKILL.md(带 YAML frontmatter,name 与 description 供 Claude 选择何时调用),加一个 Python 工具文件。三个目录额外带示例配置:trader-budget/config.example.json、trader-budget/targets.example.json、trader-broker/claude_desktop_config.example.json、trader-alerts/alerts.example.json、trader-analyst/metrics.example.json。
四、流水线:一次交易的文件接力
README 用一张 ASCII 图说明编排顺序,这是整个设计最关键的约定:
scanner -> news -> entry -> exit -> timemachine -> budget -> risk -> broker (one trade)
alerts: stop, target, flat by the close (while it is open)
news / analyst / pelosi (on a schedule)
三行分别对应三种节奏:
- 单笔交易主链:扫描器写
trader/watchlist.json→ 新闻读它 → 入场器写trader/entry.json→ 出场规划器写trader/plan.json→ 时间机器写trader/timemachine.json→ 预算器写trader/orders.json→ 风控写trader/state/risk.json→ 券商 Skill 写trader/state/broker.json与trader/portfolio.json。 - 持仓期监控:
trader-alerts从plan.json一次生成三条告警(止损、目标、收盘前平掉),并把行情写入trader/prices.json供定仓与风控复用。 - 定时任务:新闻、财报分析、国会交易披露不需要在交易链上,按
/loop或计划任务跑即可(例如/loop 15m /trader-news、众议院 PTR 每小时检查一次)。
从源码结构看,这种"文件即接口"的设计让每个工具都可以单独运行、单独测试:size.py 的 docstring 明确写着 "Standard library only, no network",ticket.py 则写明 "never talks to a broker"。只要有对应的 JSON 文件,任何一步都能在离线环境复现。
五、端到端实例:2026 年 10 月 19 日(周一)的 TSLA
README 给出的 reel 示例贯穿全篇,所有数字都可被离线 fixture 复现。下面按原文九步完整保留并补充实现细节。
第 1 步:/trader-scanner 在美东 10:15 扫描
在 reel 的 231 张图表扫描中,42 只在 15 分钟开盘区间上方收盘。TSLA 是其中之一:区间 354.47 到 362.18,10:10 那根 K 线收在 364.18,高出区间上沿 0.55%。
对应命令(离线 fixture 在 tests/fixtures/trader-scanner/wall5m-2026-10-19.json.gz):
python3 scan.py orb --offline wall5m-2026-10-19.json.gz --now "2026-10-19 10:15" --min-price 0
Fetched 233 of 234 charts (1 failed or had no data); 231 usable; 95 candidates, 95 confirmed with real highs and lows.
42 of 231 charts closed above their opening-range high by 10:15 AM:
9:50 AM AMC $2.97 range 2.90 to 2.96 +0.50% over
...
10:15 AM TSLA $364.18 range 354.47 to 362.18 +0.55% over
reel 的股票池没有价格下限(AMC 的 $2.97 也在 42 只里),所以加了 --min-price 0;用默认的 $5 下限则是 41 只。详见 trader-scanner/SKILL.md。
第 2 步:/trader-news 早间新闻
纽约时间 8:04 的标题 "Tesla-SpaceX Merger Mania Strikes Wall Street Ahead of Earnings" 被打上 earnings 与 deal 标签。关键判断:特斯拉本周财报,而日内交易在收盘前平掉,不暴露于财报。
第 3 步:/trader-entry 逐根等待
10:12 时说 waiting(10:10 那根还在形成);10:15 说 triggered:第一根收在区间上方的 5 分钟 K 线,364.18。
第 4 步:/trader-exit 入场前定计划
止损放在区间中点 358.32,每股风险 5.86;目标 1R = 370.04;无论输赢 15:55 前平仓。
第 5 步:/trader-timemachine 重放 10,000 次
用 TSLA 过去 59 个交易日同一时段的 5 分钟 K 线重建当天剩余时段(seed 19,任何人可复现):先到目标 29.4%,先到止损 25.5%,收盘仍持有 45.1%。同一规则在 59 个真实交易日里触发 33 次:13 次到目标、15 次到止损、5 次都不是。结论:接近抛硬币。
第 6 步:/trader-budget 定仓
$5,000 账户、单笔最大亏损 $50:50 / 5.86 = 8 股($2,913.44)。若止损在 358.32 成交,亏损 $46.88。写出一张括号单(bracket order):买入 8 股 TSLA,止损 358.32,止盈 370.04。
第 7 步:/trader-risk 逐条检查
最大亏损、日亏损上限、每日交易笔数、盈亏比、入场时间窗、仓位大小、现金——输出 PASS 或 BLOCK,并给出原因。
第 8 步:/trader-broker 人工确认
用大白话展示订单票据,你为这一张单输入 yes;Claude 调用你的券商连接器(默认 Alpaca 纸面账户);随后 Claude 自己的 "Allow once / Deny" 卡片再问一次。
第 9 步:/trader-alerts 三条告警
止损、目标,以及 15:55 平掉剩余持仓。
六、配置:一次设定你的交易规则
所有限额集中在 trader/config.json,模板是 trader-budget/config.example.json。README 说明把 config.example.json 复制为 trader/config.json,并用平实语言向用户确认每个值。完整字段如下:
{
"budget": 5000,
"cash_buffer_pct": 10,
"max_position_pct": 75,
"max_order_usd": 4000,
"min_order_usd": 5,
"max_loss_per_trade_usd": 50,
"max_daily_loss_usd": 150,
"max_trades_per_day": 3,
"max_orders_per_day": 10,
"min_reward_risk": 1.0,
"require_stop": true,
"no_entries_before": "09:45",
"no_entries_after": "15:30",
"flat_by": "15:55",
"fractional": false,
"broker": "alpaca",
"paper": true,
"blocked": [],
"allow_options": false,
"allow_margin": false,
"allow_short": false,
"pdt_guard": false,
"sec_user_agent": "Your Name you@example.com"
}
| 字段 | 默认值 | 作用与消费方 |
|---|---|---|
budget |
5000 |
这笔钱的总预算,只放你能承受亏损的部分;size.py 与 check.py 都以它为账户基准。 |
cash_buffer_pct |
10 |
始终留在现金里的比例,先从预算里扣掉。 |
max_position_pct |
75 |
单一持仓占预算上限(v2 默认 75%,weights 模式示例用 25%)。 |
max_order_usd / min_order_usd |
4000 / 5 |
单笔订单金额上下限,低于下限不发单("never place a $2 order")。 |
max_loss_per_trade_usd |
50 |
单笔在止损价成交时的最大亏损,是决定股数的第一约束。 |
max_daily_loss_usd |
150 |
当日累计风险上限;按每笔"满额最大亏损"累加,与输赢无关。 |
max_trades_per_day / max_orders_per_day |
3 / 10 |
每日开仓笔数与订单总数上限。 |
min_reward_risk |
1.0 |
盈亏比下限;exit.py 只提示,check.py 强制执行。 |
require_stop |
true |
要求每笔开仓必须带止损(括号单的 stop_loss_stop_price 或计划里的 stop)。 |
no_entries_before / no_entries_after |
09:45 / 15:30 |
新开仓时间窗,纽约时间;设为 null 可关闭。 |
flat_by |
15:55 |
最晚平仓时间,写进 plan.json,驱动告警与平仓票据。 |
fractional |
false |
是否允许碎股;括号单只接受整数股,所以 v2 默认关闭。 |
broker |
alpaca |
券商标识,IBKR 用 "ibkr"。 |
paper |
true |
纸面交易开关,orders.json 里会带上这个标记。 |
blocked |
[] |
永不交易的代码列表,定仓与风控都会先查。 |
allow_options / allow_margin / allow_short |
false |
期权、保证金、做空三个开关,默认全关。 |
pdt_guard |
false |
若你的券商仍执行旧的 $25,000 日内交易者规则,打开它让风控统计日内交易次数。 |
sec_user_agent |
占位值 | SEC 要求的身份标识,必须换成真实姓名与邮箱。 |
这些默认值在代码里还有第二份副本:size.py 顶部的 DEFAULTS 字典(trader-budget/size.py)。load_config() 先拷 DEFAULTS 再用用户 JSON 覆盖,所以缺键不会崩,缺失项一律回落到上表的值。这也解释了为什么 trader/config.json 可以只写你关心的几项。
七、定仓原理:四道限额取最小值
README 与 trader-budget/SKILL.md 给出的公式是同一个东西:只买整数股,股数取四个上限中的最小值。
| 限额 | 股数 |
|---|---|
| 最大亏损 | max_loss_per_trade_usd / 每股风险(entry − stop) |
| 仓位上限 | budget × max_position_pct / entry |
| 最大订单 | max_order_usd / entry |
| 现金 | (budget − 现金缓冲)/ entry,且不超过 trader/portfolio.json 里的现金 |
reel 的算例($5,000 预算、10% 现金缓冲、$50 单笔最大亏损、entry 364.18、stop 358.32、风险 5.86):
| 限额 | 算式 | 股数 |
|---|---|---|
| 最大亏损 | $50 / 5.86 | 8(决定项) |
| 仓位上限 | $5,000 的 75% = $3,750 / 364.18 | 10 |
| 最大订单 | $4,000 / 364.18 | 10 |
| 现金 | $5,000 − $500 = $4,500 / 364.18 | 12 |
8 股 = $2,913.44,止损处最大亏损 8 × 5.86 = $46.88。
源码里有几个容易被忽略但很关键的实现细节:
- 整数分运算:
shares_for(usd, per_share)把金额和价格都换算成整数分再整除(u // p),避免浮点误差多算一股;round_cent()用floor(x*100 + 0.5 + 1e-9)做半进位到分。 - 以哪个价格定仓:
size_trade()里limit(限价单)优先;否则取trader/prices.json的新鲜价与计划 entry 的较高者;都没有才用计划 entry。理由写在注释里:价格从计划之后涨上去,同一个止损意味着更大的风险,所以要更少股;而更低的价格永远不会缩小风险。FRESH_MINUTES = 15,超过 15 分钟的报价被弃用并打印说明。 - 谁决定了股数:结果里
bound_by记录最小值对应的限额名,bracket_order()会把原因写进why字段,例如 "bound by your $50 max loss per trade (8 x 5.86 = $46.88 at the stop)"。 - 拒单而不是缩水:
qty == 0时不会偷偷改成"1 股试试"。若最小值来自最大亏损,提示原文是"one share risks $5.86 ... more than your $50 max loss per trade. No order.";若来自其它限额,则指出一股的价格超过了哪个上限。 - 额外拒单条件:盈亏比低于
min_reward_risk、订单金额低于min_order_usd、止损不低于入场价、目标不高于入场价("the move has already happened")、计划不是今天的、代码在blocked里、计划是空头——全部直接拒绝,并在报告里用一行说明。
写在 trader/orders.json 里的票据形状严格对齐 Alpaca 的 place_stock_order 参数(价格与数量都是字符串,这是 Alpaca 的签名要求):
{"symbol": "TSLA", "side": "buy", "qty": "8", "type": "market", "time_in_force": "day",
"order_class": "bracket", "take_profit_limit_price": "370.04", "stop_loss_stop_price": "358.32",
"why": "opening-range breakout on TSLA: 8 shares, bound by your $50 max loss per trade (8 x 5.86 = $46.88 at the stop)",
"plan": {"entry": 364.18, "stop": 358.32, "target": 370.04, "risk_per_share": 5.86, "max_loss": 46.88,
"setup": "orb", "entry_time": "10:15 AM", "flat_by": "15:55"}}
why 与 plan 是本项目自己的注释字段,永不发给 Alpaca。同时 write_orders() 用 tmp + os.replace() 原子写入,文档头带 created_by、created_at、status: "proposed"、paper 与一句"Proposals only"的说明。
反例:两种必须拒绝的情形
- 止损放得太远:若 stop 改到 300.00,每股风险 64.18,超过 $50 上限 → 一张单都不写。
- 价格已经跑掉:10:52 的真实报价 366.48,同一个计划变成 6 股、每股风险 8.16,盈亏比掉到 0.44 → 拒绝,因为"它等的行情大部分已经发生"。
八、出场计划:先定止损与目标
trader-exit/SKILL.md 的核心主张是"止损是形态失败的地方,目标是你来取的东西,两者都在入场前写下"。
止损规则:
| 止损 | 位置 |
|---|---|
or-mid |
开盘区间中点(开盘区间突破的默认值) |
or-low |
开盘区间低点:更宽,同样的最大亏损只能买更少股 |
price:X |
你给的价格 |
pct:X |
入场价下方 X% |
atr:K |
入场价下方 K 倍的 14 根 K 线 ATR(用当日到入场那根为止的 K 线;不足 14 根就取全部并说明) |
目标默认 2R,也支持 1R、1.5R、price:X。取整规则:止损朝远离入场价的方向取到分(多头向下),目标 entry + R × risk 半进位到分。
exit.py 里几条可验证的实现约束:
MIN_RISK_PCT = Decimal("0.05"):风险小于价格的 0.05% 视为"太紧,撑不过点差",直接拒绝。- 拒绝的情形还包括:止损在入场价上方、目标在入场价下方、
entry.json尚未触发(除非用--entry指定)、以及做空计划(v2 只做多)。 flat_by默认 15:55,来自DEFAULTS = {"flat_by": "15:55", "min_reward_risk": 1.0};resolve_flat_by()会在 NYSE 提前收盘(13:00)时把时间前移到 12:55,并给出moved up for the 1:00 p.m. early close的说明;若flat_by落在收盘时刻之后则报错。
reel 的输出(可直接对照校验):
Exit plan: TSLA long, Mon 2026-10-19, opening-range breakout on 5-minute bars
Entry $364.18 at 10:15 AM (bar 8)
Stop $358.32 opening-range midpoint: ($362.18 + $354.47) / 2 = $358.325, rounded down
Target $370.04 1R (one times the risk)
Risk a share $5.86 (1.61% of the entry)
Reward:risk 1.0
Flat by 15:55 ET, win or lose: no overnight hold
默认 2R 目标则是 364.18 + 2 × 5.86 = 375.90。
九、时间机器:10,000 次重放到底怎么算
trader-timemachine/SKILL.md 是全套最有意思的部分,也是 README 强调"重放每一种结果"的落点。它的流程可以拆成五步:
- 样本池:只保留计划日期之前的完整交易日——美东 9:30 到 16:00 的全部 78 根 5 分钟 K 线。半日市、缺口日、当天全部剔除。每根 K 线转成相对前一根收盘的四个比率:open、high、low、close。
- 单次重放:从入场价出发,对当天剩余每根 K 线,从"同一时段(前后 2 根,即
--window 2)"的历史 K 线里随机抽一根,按当前价格缩放。逐根先查止损、再查目标;同一根同时触及两边算止损(保守处理)。 - 10,000 次重放给出四个概率:先到目标、先到止损、两者都没到(在
--until时仍未平仓,默认 16:00 收盘,提前收盘日为 13:00)、以及 green(先到目标,或--until时价格仍高于入场价)。R 的定义是:1R 目标达成 +1、止损 −1,其余按--until时相对入场的距离除以风险;跳空穿止损仍然记 −1R。 - 历史复盘:把同一套规则(同一开盘区间、同一止损规则、同一目标 R)在池中每一个历史交易日重跑一次。这是真实发生过的事,不是模拟。
- 一句话判词:只看真正触及某一侧的重放,问目标先到的比例。盈亏平衡点由 R 决定:
1 / (1 + R),即 1R 要 50%、2R 要 33%、3R 要 25%。
判词分档(原文定义):
- 距盈亏平衡 小于 5 个百分点:1R 时说 "Close to a coin flip",其它 R 说 "Close to break-even";
- 5 到 15 个百分点:
Leans toward the target或Leans toward the stop; - 15 个百分点以上:"Strongly toward" 某一侧。
判词下方还有两行补充条件:当超过 40% 的重放两边都没触及时(那部分由 --until 的价格决定)追加一行;当平均 R 的符号与倾向相反时也打印出来。
可复现性是硬要求:随机源是 Python 的 random.Random(seed),默认 seed 19,同样的计划、同样的数据、同样的 seed 在任何机器上得出同一组数字,因此输出必须带上 seed。
为什么只用 5 分钟 K 线:Yahoo 保留 60 天的 5 分钟 K 线,但只有约 7 天的 1 分钟 K 线,样本交易日太少,池子不公平。以下情况它会用一行说明拒绝:完整交易日少于 20 个、入场那根 K 线不在数据里(日期错、还没收盘、未来日期)、计划本身不自洽(买入计划的止损在上方、入场价不在 5 分钟网格上)。未收盘的实时 K 线永不使用。
reel 输出:
10,000 replays of the rest of the session, 10:15 AM to 4:00 PM (69 five-minute bars), seed 19.
target first 29.4 %
stop first 25.5 %
neither 45.1 % still open at 4:00 PM
green 51.7 % target first, or above the entry at 4:00 PM
Price at 4:00 PM: median 364.36, 90 % of replays between 355.54 and 373.54.
Average R: +0.034
History: the same rule on each of those 59 real sessions fired 33 times:
13 target, 15 stop, 5 neither. Average R -0.062.
Close to a coin flip: target first 29.4 % vs stop first 25.5 %.
45.1 % of the replays hit neither by 4:00 PM; the price at 4:00 PM decides those.
在 1R 下,目标需要在"触及某一侧"的重放中先到一半,实际是 53.6%——所以判词是接近抛硬币,而真实历史还略差于持平。这正是 README 那句"在你冒一分钱风险之前先看一眼"的含义。
十、风控闸门:逐单 PASS 或 BLOCK
trader-risk/SKILL.md 把风控定义为"提案与券商之间的门"。trader-budget 写的每一张单、trader-broker 的 flatten 生成的平仓单,都要过它。
入口与出口的不对称
- entry:开仓或加仓(买入,或会导致做空的卖出)。
- exit:只减少已有持仓。为了"永远能跑掉",出口只检查格式、资产类型与做空三件事;其余规则(日限额、时间窗、亏损、盈亏比、黑名单、规模、重复)对出口只降级为警告,绝不 BLOCK。
检查清单
订单按文件顺序检查,并且假定前一张已成交,这样"单张都合规、合起来越线"的批量也能被抓到。
| 检查 | 触发 BLOCK 的条件 |
|---|---|
| format | 缺 symbol;side 不是 buy/sell;qty 与 notional 同时给或都不给;notional 单不是 market + day(Alpaca 规则);限价单没有限价;括号单不是整数股、不是 day/gtc、或缺止损/止盈 |
| asset | allow_options 为 false 时的期权代码;加密或任何非美国股票/ETF 代码 |
| short | 卖出超过持仓且 allow_short 为 false |
| blocked | (开仓)代码在黑名单 |
| size | (开仓)低于 min_order_usd 或高于 max_order_usd |
| position | (开仓)该股将超过账户的 max_position_pct |
| cash | (开仓)买入后现金低于缓冲,或需要保证金 |
| stop | (开仓)require_stop 为真却没有止损;止损在入场价错误一侧 |
| loss | (开仓)qty ×(entry − stop)超过 max_loss_per_trade_usd |
| reward:risk | (开仓)(target − entry)/(entry − stop)低于 min_reward_risk |
| daily loss | (开仓)今日所有开仓的止损最大亏损加本单超过 max_daily_loss_usd |
| trades | (开仓)今日已开仓数达到 max_trades_per_day |
| window | (开仓)早于 no_entries_before、晚于 no_entries_after,或市场休市 |
| pdt | (开仓,仅 pdt_guard 为真)最近 5 个交易日已有 3 笔日内交易 |
| duplicate | (开仓)同一批次里同代码同方向出现两次,或今天已经下过 |
| daily limit | (开仓)今日订单数达到 max_orders_per_day |
几个数值口径值得单独记住:
- 风险测量基准:限价单用限价;市价单取"计划 entry"与"
trader/prices.json中 15 分钟内的新鲜价"的较高者,所以 10:15 写的计划无法在 10:55 价格跑高后低估风险;过期价格会被弃用并提示。 - 当日亏损:把今天每一笔开仓的满额最大亏损(无论输赢)累加,与
trader-broker记录一致。三笔满额交易正好用掉 $150 的日限额。 - 时间窗:纽约时间在工具内部推算(含夏令时),不看本机时区;周末与 NYSE 假日休市;提前收盘日窗口提前 3 小时结束;把两个
no_entries_*设为null可关闭窗口。 pdt_guard:把"同一天买入并卖出同一代码"和"今天下的任何开仓"都算作日内交易。README 记录 FINRA 于 2026 年 6 月 4 日取消 $25,000 日内交易者最低资金要求(Regulatory Notice 26-10),但券商可分批实施至 2027 年 10 月 20 日,所以你的券商可能仍在用旧规则。
指纹:让 PASS 只对"这一张单、今天"有效
这是我认为整套设计里最值得学习的一处。check.py 与 ticket.py 各自实现同一个 fingerprint(order):取 ALPACA_FIELDS 中存在的字段,json.dumps(..., sort_keys=True, separators=(",", ":")) 后做 SHA-256,取前 16 个十六进制字符。
结果是:订单任何一处改动都会变指纹,昨天对同参数单据的 PASS 也不会被今天复用。trader-broker 的 status_of() 依据 trader/state/risk.json 里"今天的、指纹匹配的 PASS"决定票据是否 READY。所以风控报告里那句"订单有任何变化就重跑一次"不是建议,而是代码强制。
reel 的通过示例与"多买一股"的拦截示例:
PASS #1 buy TSLA 8 shares, entry
entry 364.18 (the plan's entry), stop 358.32, target 370.04: risk 5.86 a share
max loss $46.88 (limit $50), reward:risk 1.00 (min 1)
today before this: 0 of 3 trades, $0 of $150 daily loss
1 passed, 0 blocked at 2026-10-19 10:15 New York. Cash after the passed orders: $2,086.56 (paper account).
BLOCK #1 buy TSLA 9 shares, entry
...
max loss $52.74 (limit $50), reward:risk 1.00 (min 1)
- loss: 9 shares x 5.86 risk a share = $52.74 at the stop, over your $50 max loss per trade
同样的 8 股,在 10:55 用 10:52 的真实报价 366.48 复检会被拦两次(8 × 8.16 = $65.28,且盈亏比 0.44);9:40 复检则被时间窗拦下(9:45 前不允许新开仓);而 15:55 的平仓卖单即使晚于 15:30 的入场截止,也照样通过——因为它是出口。
十一、下单:三道闸门,缺一不可
trader-broker/SKILL.md 是唯一可能触达真实订单的 Skill,因此规则最严。每张单、每一次,都要同时满足:
trader-risk今天通过了这张确切的单(指纹匹配);- 用户为这一张单在对话里输入了明确的 yes;
- 用户点击了 Claude 自己的 "Allow once"(因为下单工具被设为 "Needs approval")。
"用户的两次 yes,规则的一次 PASS。没有 yes,就没有订单。"
ticket.py 本身从不与券商通信:它渲染票据、校验回复是否构成对这张单的真实同意、构造平仓票据、把日志维护在 trader/state/broker.json。关键命令:
python3 ticket.py show # 每张票据,READY 或 not
python3 ticket.py approve --index 1 --reply "yes"
python3 ticket.py result --index 1 --status placed --broker-id ID --filled-qty 8 --filled-price 364.20
python3 ticket.py fill --symbol TSLA --side sell --qty 8 --price 370.04
python3 ticket.py flatten --symbol TSLA --qty 8
python3 ticket.py log
parse_yes() 的存在意味着 "sure"、"yes to all"、或指向别的股票/数量的 yes 都会返回 "Not recorded",必须重新询问——模型不能替用户把含糊回复翻译成同意。
Alpaca 接入(官方 MCP server,Claude Desktop)
README 与 SKILL.md 记录的完整步骤:
- 在 Alpaca 后台创建纸面交易 API Key(与实盘 Key 是两套)。
- 安装
uv(提供uvx)。 - 在 Claude Desktop:Settings > Developer > Edit Config,打开
claude_desktop_config.json(macOS 在~/Library/Application Support/Claude/,Windows 在%APPDATA%\Claude\),加入下面这段并把 Key 填进文件(模板见 trader-broker/claude_desktop_config.example.json):
{
"mcpServers": {
"alpaca": {
"command": "uvx",
"args": ["alpaca-mcp-server"],
"env": {
"ALPACA_API_KEY": "paste your paper key here, in this file only",
"ALPACA_SECRET_KEY": "paste your paper secret here, in this file only",
"ALPACA_PAPER_TRADE": "true",
"ALPACA_TOOLSETS": "account,trading,stock-data"
}
}
}
}
- 重启 Claude Desktop。
- 设置工具权限:Customize > Connectors,打开 alpaca:
place_stock_order:Needs approval,永远不要 Always allow;- 其它会下单、改单、撤单、平仓的工具(
cancel_order_by_id、replace_order_by_id、close_position、update_account_config):Needs approval; place_option_order、place_crypto_order、close_all_positions、cancel_all_orders、exercise_options_position、do_not_exercise_options_position:Blocked;- 只读工具(
get_account_info、get_all_positions、get_open_position、get_orders、get_clock、get_stock_snapshot、get_stock_latest_quote):Always allow 可以接受。
- 验证:向 Claude 要一次 Alpaca 账户信息(只读),在 Alpaca 后台确认那是纸面账户。
Claude Code 里则把下单工具留在 ask:"permissions": {"ask": ["mcp__alpaca__place_stock_order"]},绝不放进 allow。
括号单细节:place_stock_order 接收 take_profit_limit_price 与 stop_loss_stop_price(可选 stop_loss_limit_price);只要给了其中之一,server 会自己把 order_class 设为 bracket——本项目仍然显式写出,以便票据上能看到。括号单只支持整数股,time_in_force 为 day 或 gtc。入场成交后,止损单与止盈单作为两张互相取消的挂单留在券商;它们也是当日单,收盘即失效——这也是"收盘前必须平掉"的又一个理由。
平仓链路(含一个真实的坑)
到 flat_by(15:55 纽约)时,任何仍未平掉的仓位:
- 只读询问持仓:
get_open_position; ticket.py flatten --symbol TSLA --qty 8写出市价卖单到trader/orders.json;- 跑
/trader-risk——只减仓的卖单不会被日限额或入场时间窗拦住; ticket.py show,用户对这一张单说 yes;- 括号单的止损/止盈仍占着这些股票,Alpaca 会拒绝新的卖单:先用
get_orders(status open、nested true)找到它们,逐个cancel_order_by_id(Needs approval),再place_stock_order,最后result记录。
Interactive Brokers
IBKR 提供了经验证的连接器(可从 Claude 的连接器目录添加,登录在 IBKR 侧完成),其说明写明"Claude 起草的交易指令会送到用户 IBKR 账户供审阅批准,Claude 不会直接向市场提交订单"。因此用 IBKR 时最后一步 yes 发生在 IBKR 里。把 trader/config.json 的 "broker" 设为 "ibkr",并把起草订单的工具也设为 Needs approval。
reel 的票据长这样:
ORDER 1 of 1, PAPER account, Alpaca
BUY 8 TSLA, market, good for today
stop-loss 358.32
take-profit 370.04
max loss about $46.88 if the stop fills at 358.32 (it can fill worse in a fast market)
why: opening-range breakout on TSLA: 8 shares, bound by your $50 max loss per trade (8 x 5.86 = $46.88 at the stop)
READY: trader-risk PASS, waiting for your yes
Claude will call place_stock_order with exactly:
{"symbol": "TSLA", "side": "buy", "qty": "8", "type": "market", "time_in_force": "day",
"order_class": "bracket", "take_profit_limit_price": "370.04", "stop_loss_stop_price": "358.32"}
why 与 plan 留在文件里,永不发送。
十二、告警与行情:把计划变成三条提醒
trader-alerts/SKILL.md 的出发点是"告警是信息,不是订单":止损失效时这个 Skill 不会卖出任何东西。
规则类型:
| 类型 | 触发条件 | 再次触发 |
|---|---|---|
above / target |
价格 ≥ price |
reset 之后;或 "rearm": true 且价格回落后 |
below / stop |
价格 ≤ price |
同上 |
pct_move |
相对前收盘(或 ref)移动 pct 百分比,可加 direction |
每天最多一次 |
time |
纽约时间越过 at(如 "15:55")且在交易日 |
每个交易日一次 |
opening_bell |
NYSE 开盘 | 每个交易日一次 |
带 "date" 的规则只在那一天被监视;--from-plan 生成的规则继承计划日期,所以昨天的止损不会在今天响。"before_close": true 的 time 规则在提前收盘日提前 3 小时(15:55 变成 12:55)。
alerts.py add --from-plan 一次写入三条(见 trader-alerts/alerts.example.json 的 tsla-plan-stop、tsla-plan-target、tsla-flat-by)。
行情来源与新鲜度:
yahoo(默认):每个代码一次请求,间隔半秒;429 时等待后重试一次,仍失败或 5xx 则切换到另一个 host;自我标识为day-trader-skill/2.0。stooq:免费 CSV,解析器保留(文档记录 2026-10-13 返回过 404)。- 免费报价是非官方、延迟、可能滞后的:适合告警和复核仓位,不适合给订单定时。每个价格在
trader/prices.json里带自己的报价时间,trader-risk只用 15 分钟内的。 - 两个源都挂时,可从券商连接器读快照并写成
{"as_of": "...Z", "prices": {"TSLA": 366.48}}。
NYSE 时钟:常规时段 9:30–16:00 纽约时间,周末与假日休市,2026/2027 的假日与 13:00 提前收盘日在工具内硬编码;夏令时自行推算,不依赖时区文件,也不看本机时区;其它年份会明确说"假日列表未知"。
reel 的两次检查:
NYSE OPEN (2026-10-19 10:53 New York, regular session).
Nothing hit. 3 rule(s) watched today, TSLA $366.48.
ALERT Flat by close: it is 15:55 New York (set for 15:55), the market closes at 16:00. If TSLA is still
open, close it: trader-broker flatten --symbol TSLA builds the sell ticket, then trader-risk and your yes.
十三、扫描器与入场器:两个阶段的实现要点
Universe:从两万个代码到约 5,900 只
scan.py universe 下载 Nasdaq Trader 的 nasdaqlisted.txt 与 otherlisted.txt,按顺序保留:
- 不是测试代码、不是 ETF、不是 NextShares;
- 是普通代码:1–5 个字母,或 1–4 个字母加点加一个类别字母(
BRK.B);$优先股(ABR$D)排除,.U/.W/.R后缀(单位、权证、权利)排除; - 名称里出现 warrant、SPAC 单位与权利、notes、ETN、debenture、票息百分比、非 American/Global 的存托股 → 排除;
- 名称声明为 common stock/shares/units、ordinary shares、beneficial interest、ADS/ADR、存托股、合伙或信托单位 → 保留;
- 名称仍含 unit、right、bond、preferred 或 preference → 排除;
- 其余保留(如 "AMETEK, Inc.")。
2026-10-19 的文件得到 5,943 只;reel 里说的 5,259 是另一个临时过滤口径(名称含 common/ordinary、不含 ADR),前者是后者的超集,多出的 684 只主要是 ADR、封闭式基金与合伙单位。10-20 的文件是 5,942。
日报扫描(盘前)
Yahoo 的 spark 接口一次返回 20 个代码的收盘序列,因此 5,942 只约需 298 次请求;文档记录 2026-10-20 加上 0.3 秒礼貌间隔耗时 145 秒。流动性来自 spark meta:最新价至少 --min-price,上一交易日成交量至少 --min-volume。应该在盘前或收盘后运行:盘中成交量只是当日累计,当天的日线要到 16:00 才纳入。
形态只用日收盘计算(spark 没有高低点),因此是 reel 中 refs/scan.py 的近亲:
| 形态 | 收盘价规则 |
|---|---|
breakout_20d |
最后一根收盘高于之前 20 个交易日的所有收盘 |
bull_flag |
前 10 日涨幅 >10%,随后 5 日收盘落在 5% 区间内 |
reclaim_ma20 |
前一根收盘在 20 日均线下方,最后一根在上方 |
oversold |
RSI 14(Wilder)低于 30 |
oversold_bounce |
昨天 RSI 14 低于 30 且今天收涨 |
命中按成交额(价 × 量)从大到小排列。
开盘区间突破(盘中)
开盘区间是前 --or-minutes(默认 15)分钟:9:30、9:35、9:40 三根 5 分钟 K 线。命中定义是第一根完整收盘高于区间上沿的 5 分钟 K 线,时间取该 K 线的收盘时刻。
两阶段设计的动机是请求量:
- 阶段 1(全体):spark 取当日 5 分钟收盘,一次 20 个。只要有一根区间之后的完整 K 线收盘 ≥ 区间内最高收盘,就进入候选。区间上沿至少等于区间内每根收盘,所以这是必要非充分条件,不会漏掉任何突破。
- 阶段 2(逐个确认):拉取带真实高低点的 v8 图表,一次一个。区间上沿 = 区间内最高 high,下沿 = 最低 low。强势早盘时候选极多,所以最多确认
--max-confirm(默认 200)个,按成交额取最大的,并打印 PARTIAL 与跳过的数量;--max-confirm 0表示全查。
文档给出的真实耗时:2026-10-20 强势早盘,100 只活跃股在 10:01 用时 35 秒(5 次 spark + 70 张 v8,91 张可用中 51 张突破);10:03 扫全市场约 4 分钟(298 次 spark + 200 张 v8),2,448 张可用、1,782 个候选、确认最活跃的 200 个、其中 119 个突破。要快就扫日报自选或自己常做的名单(--watchlist、--symbols)。
可用图表的判定:9:30 到截止时刻的每根 5 分钟 K 线都必须存在(缺一根说明停牌或流动性太差);空收盘剔除;不在 5 分钟网格上的 bar(如 10:58:07 的实时 tick)剔除;只有"开始 + 5 分钟"已过才算完整。9:50 前、周末/假日、收盘后、或超过 no_entries_after(形态过期)时,只打印一行且不写文件。13:00 提前收盘在日历内。
入场器:只有收盘才算
trader-entry/SKILL.md 把形态压缩成一个瞬间:确认它的那根 K 线的收盘。K 线中间穿一下不算,收在水平位正好等于也不算(必须"高于")。
细节规则:
- 时间 = 该 K 线收盘时刻(10:10 的 bar 在 10:15 收盘);价格 = 收盘价,取到分。
- 只有已收盘的 bar 有效:时钟越过"开始 + 5(或 1)分钟"且 Yahoo 已跟上(最多等一分钟);Yahoo 的实时 tick 永不算 bar。
- 可选量能确认:
--min-volume-x 1.5要求触发 bar 的量达到区间 bar 均量的 1.5 倍;9:30 那根含开盘集合竞价,所以 1.0 已经很严格。 - 时间上限:9:45 前、15:30 后不新开仓(来自配置),13:00 提前收盘则截止提前到 12:30。
- 输出四态:waiting(并给出最后一根收盘距离水平位多远)、triggered、expired、no data;9:30 前 "not open yet",9:45 前 "range is still forming",周末与假日 "market is closed"。
- 一个形态每天只触发一次(第一次收盘突破),后续收盘不会重置。
reel 的两个时点:
WAITING last close $361.68 (10:05 bar), $0.50 under the range high $362.18 (-0.14%).
The 10:10 bar is still forming ($364.18 so far, closes 10:15 AM); it does not count until it closes.
TSLA Mon 2026-10-19 10:15 ET opening-range breakout (15-minute range) on 5-minute bars (Yahoo, free, can lag)
Opening range 9:30-9:45: high $362.18, low $354.47 (3 of 3 bars).
TRIGGERED 10:15 AM at $364.18: the 10:10 bar (bar 8) closed above the range high $362.18 (+0.55%).
This is the moment to get in, if you take the trade. Nothing was placed.
Next: set the stop and target BEFORE you buy: /trader-exit (exit.py plan --from trader/entry.json).
加上 --min-volume-x 1 后,10:10 那根量太薄(0.60 倍区间均量),触发点后移到 10:35、价格 365.75(10:30 那根,7.98 倍)。
十四、其余三个 Skill:新闻、财报、国会披露
这三个不在主交易链上,但都直接影响"这笔交易该不该做"。
/trader-news:只报新增,不重复
读取源:--tickers 指定的代码,否则 trader/watchlist.json;同时读 trader/plan.json(正在计划的交易)与 trader/portfolio.json(已持有)。信息来自 Yahoo Finance 标题 RSS、Yahoo 图表的"最新价 vs 昨收"、以及 SEC EDGAR 的 8-K Atom feed(--forms 8-K,10-Q 可扩展);没有 sec_user_agent 时跳过 filings 并注明。状态存在 trader/state/news.json(保留 30 天)与各代码的 CIK。
规则里最实用的两条:标题是线索不是事实(转述前要打开原文或文件、引用来源与链接、读不到就别总结);文件优先于标题(8-K 与新闻冲突时以公司给 SEC 的为准)。! 标记重要的 8-K 条目:2.02 业绩、5.02 高管变动、2.06 减值、3.01 退市通知、4.02 前期报表不再可靠、1.03 破产、1.05 网络安全事件。MOVING 标记相对昨收变动 ≥3%(--move-pct)。退出码 1 表示没有新增。
reel 的早间简报:"Tesla reports this week, so the stock can gap overnight; today's trade is in and out before the close. No new 8-K." 10:52 的价格行:TSLA 366.48 +3.31% vs yesterday's close 354.72 at 10:52 ET MOVING。
/trader-analyst:从 XBRL 读数,而不是读新闻稿
facts.py 读 SEC 的 XBRL companyfacts(公司申报过的每一个数字)、submissions 列表(最新的 10-Q/10-K,以及最新含 2.02 条目的 8-K)与该 8-K 目录里的 EX-99.1 新闻稿;--metrics 写 trader/metrics.json(示例见 trader-analyst/metrics.example.json)。
三条方法学约束:同比优先(与去年同期比;环比也显示,但很多业务有季节性——苹果的 12 月季度永远是最大的);标注推导值(公司不报 Q4 10-Q,第四季度 = 10-K 全年减去其内三个季度,标为 "derived",推导 EPS 是近似值);标注滞后(facts API 可能落后于申报;当最新 10-Q 晚于 facts 里最新季度时,工具打印带链接的 NOTE,此时应先读 10-Q)。净利高于营业利润时会提示其中含非经营性收益;银行与保险公司没有毛利率,留空而非 0。
reel 的 TSLA 一例(2026-10-20 运行):2026-06-30 季度收入 $28.24B(同比 +25.5%)、净利 $1.11B(−4.9%)、稀释 EPS $0.32(−3.0%)、毛利率 16.8%(环比 −4.3 个百分点)、营业利润率 1.4%;近四季收入 $103.6B、EPS $1.08。
/trader-pelosi:快,但不早
读众议院书记处的年度索引压缩包与 PTR PDF,把每份报告解析为行(谁、所有者、股票、代码、买入/卖出、期权行权价与到期、交易日期、金额区间、披露延迟天数),并在新文件出现时只提醒一次;状态在 trader/state/pelosi.json,PDF 存 trader/state/ptr-pdfs/。
必须说清的事实:PTR 需在议员知悉交易后 30 天内提交,且绝不超过交易后 45 天——所以等你读到,交易已经过去数天到数周。这不是内幕信息,只是公开披露被读得快。 金额永远是区间("$1,000,001 - $5,000,000",不能说成"300 万");所有者标记 SP(配偶)/JT(共同)/DC(受抚养子女);超过 45 天标记为迟报;期权就是期权,看涨期权不等于买股票。第三方追踪器只适合浏览,可能出错(文档记录某追踪器把 Pelosi 的交易日期显示早了一天),以 PTR 为准。
参议院报告在 efdsearch.senate.gov,需要先由本人在浏览器里接受使用条款,本 Skill 不代替点击、不自动化登录,只提供文档化的人工路径(用户搜索、打开、把表格贴进对话)。
十五、测试:离线可复现每一个数字
python3 -m unittest discover -s tests -v
README 强调测试完全离线,跑在从真实数据切出的 fixture 上:TSLA 到 2026-10-19 的 60 个交易日 5 分钟 K 线、10:15 的开盘区间扫描、当日早间的 Yahoo TSLA 标题、众议院书记处 2026 年索引、真实 PTR 文本与真实 XBRL facts。它们复现了上文示例里的每一个数字。
测试分布(按仓库现有文件统计,共 12 个测试模块、约 300 个用例):test_scanner.py(36)、test_entry.py(39)、test_exit.py(14)、test_timemachine.py(47)、test_budget.py(31)、test_risk.py(43)、test_broker.py(18)、test_alerts.py(30)、test_news.py(17)、test_analyst.py(13)、test_pelosi.py(16)、test_repo.py(11)。fixture 目录按 Skill 分文件夹,例如 tests/fixtures/trader-timemachine/TSLA-60d5m.json.gz、tests/fixtures/trader-entry/TSLA-2026-10-19-5m.json、tests/fixtures/trader-risk/orders-tsla.json。
tests/test_repo.py 本身就是一份"架构契约",值得单独读:
- 根目录必须恰好包含 11 个带
SKILL.md的目录 +.claude-plugin+LICENSE+README.md+tests; - 每个
SKILL.md的 frontmatter 必须有name:与description:,且正文超过 60 行、描述超过 200 字符(防止文档被悄悄写薄); - 下单路径上的 9 个 Skill 必须同时出现 "not financial advice" 与 "yes"(安全声明不可丢失);
- README 必须以
# The Day Trader skill开头,包含固定的安装片段与## Fine print,且提到全部 11 个命令; - 所有文本文件不得含 em dash,也不得出现个人邮箱;
- v1 遗留的四个 Skill 名不得残留(README 除外);
- 工具代码不得使用 3.9+ 语法(守护 Python 3.8 承诺);
config.example.json必须含日交易限额键,且require_stop为 true、allow_short/allow_margin/allow_options/paper的取值符合文档。
这也是我把这个仓库当作"文档即约束"范例的原因:README 里的承诺被编译器式的测试钉住了。
十六、边界与免责:必须原样传达的限制
README 的 "Fine print" 不是形式声明,而是每一项都对应代码里的具体行为:
- 不是投资建议。 这是读公开数据并做算术的软件,它不知道你的处境,也看不到未来。多数做日内交易的人亏钱,你也可能亏。需要建议就找持牌专业人士。
- 没有你的 yes,任何交易都不会成交。 只有
/trader-broker可能导向订单,且必须在/trader-risk通过那张确切的单、并且你在对话里为它输入 yes 之后。把券商工具设为 "Needs approval"(Customize > Connectors > tool permissions),永远不要 "Always allow"。除非你打开开关,否则没有期权、保证金、做空或杠杆。 - 先纸面。
config.example.json里"paper": true是默认值,Alpaca 的 MCP server 也默认纸面账户。密钥只放环境变量,永不进对话。 - 时间机器是模拟,不是预测。 它建立在个股过去 60 天的 5 分钟 K 线上。未来会发生这 60 天从未发生的事:财报、停牌、头条。把它的概率当成现实检查,永远不要当承诺。
- 止损是计划,不是保证。 快速行情或跳空时,止损单可能远低于止损价成交;"最大亏损"是按止损价计算的亏损。
- 数据免费且非官方。 Yahoo 的图表接口不是官方 API:可能滞后、变更或限流。扫描器与入场器读的是 1 分钟或 5 分钟 K 线,不是每一笔成交。任何重要的事,行动前拿券商的数据核对。
- 日内交易规则会变。 FINRA 于 2026 年 6 月 4 日取消 $25,000 日内交易者最低资金要求(Regulatory Notice 26-10),券商可分批实施至 2027 年 10 月 20 日;若你的券商仍执行旧规,设
"pdt_guard": true让/trader-risk统计日内交易。 - 国会议员的交易是公开信息,不是内幕信息。 STOCK Act 要求 45 天内披露超过 $1,000 的交易。
- 税务。 日内盈利属短期资本利得,频繁交易容易触发洗售规则;这里没有任何税务建议。
十七、文件地图:从哪里继续读
trader-scanner/ SKILL.md, scan.py
trader-news/ SKILL.md, news.py
trader-entry/ SKILL.md, entry.py
trader-exit/ SKILL.md, exit.py
trader-timemachine/ SKILL.md, timemachine.py
trader-risk/ SKILL.md, check.py
trader-budget/ SKILL.md, size.py, config.example.json, targets.example.json
trader-broker/ SKILL.md, ticket.py, claude_desktop_config.example.json
trader-alerts/ SKILL.md, alerts.py, alerts.example.json
trader-analyst/ SKILL.md, facts.py, metrics.example.json
trader-pelosi/ SKILL.md, ptr.py
tests/ unittest 套件 + 离线 fixture
推荐阅读顺序:
- README.md — 全局流程与安全边界;
- trader-budget/config.example.json — 先决定你的规则数字;
- trader-exit/SKILL.md + trader-timemachine/SKILL.md — 理解"先定出场、再验概率";
- trader-risk/check.py 的
check()与fingerprint()— 理解 PASS 的真实含义; - trader-broker/ticket.py 的
parse_yes()、status_of()、cmd_flatten()— 理解三道闸门如何被代码强制。
许可为 MIT。