daily-deep-brief

Daily Deep Brief (08:03 HKT, weekday)

8 点这个时点：HK 开盘前 ~90 分钟，US 已收盘 ~4 小时。盘前是 deep think 最好的窗口 — 有完整夜间消息面，没有盘中执行压力。

Harness 架构（不可越权）

┌──────────────────────┐   ┌────────────────┐   ┌──────────────────────────┐
│ clawock brief preflight │──►│ LLM (你 / Rick) │──►│ clawock brief postflight  │
│   (确定性 + 幂等)      │   │ (只写判断/反方) │   │ 校验 → 渲染 → 投递        │
└──────────────────────┘   └────────────────┘   └──────────────────────────┘
   指标/因子/风险/evidence     查 packet summary     校验 plan+judgment，
   编译 typed packet           写 plan + judgment    brief_render 出 md+微信卡，
                               (纯文本，不写版式)    Pages 只读稳定 projection

为什么这样分：之前完全交给 LLM，模型可能漏快照、漏 HHI、漏 FX、漏 retrospective。 确定性步骤交给脚本（一定执行，无遗漏）；LLM 只做"分析综合"这个不能脚本化的部分。

🔒 Exec 铁律：退出码就是整回合的判据

每一条 exec 的退出码会被当成整个回合的成败。 一条中途的非零退出会让 cron 把 已经做完并已投递的一轮判成 error（2026-08-18：简报全部产出、wechat_sent: true、 commit+push 都成了，但一条读「可能不存在的文件」的 exec 非零退出，整轮仍被记成红）。

规则正文只有一份：本回合任务消息里的「Exec 契约」（源文件 config/cron-payloads/_exec-contract.md，简报、报告、盘中共用）。本 skill 不另写一套， 两句话的要点：

• 探测（读可选文件、ls/grep/head/test）给那一条探测自己兜底 || true。
• 业务步骤（preflight / postflight）的结果必须原样可见：不接管道、不补 || true / ; true，只允许 ; echo "EXIT=$?"。preflight 退 2 就是失败，不是「今天还没产出」。

配套的窄规则见 Step 5 的「送达确认铁律」（#558）：那条禁的是 postflight 之后再去读 marker 确认送达。

6-step 流程（严格按顺序）

Step 1: 跑 preflight（一行命令搞定所有确定性活）

clawock brief preflight

行情失败闸：US 或 HK 刷新失败时，preflight 退出 1，并把本日 context 与 manifest 换成 price_refresh_failed 的失败代（无持仓数字、无 decision packet）。 看到该状态立即结束本轮，不写 plan/judgment，不调用 postflight；修复行情后重跑 preflight。fallback 会拒绝生成，postflight 也会阻止发布。其他资料采集警告仍按 本次 context 的 issues 逐项披露。

这一步内部做了：

1. clawock analyze-us — US 价格刷新（7-route fallback + RSI/MA）
2. clawock analyze-hk — HK 价格刷新（Tencent 主源 + Eastmoney 全量独立对账/兜底 → stooq → yfinance + 恒指 + 信号）
3. clawock fx --json — USDHKD 实时汇率（Frankfurter → exchangerate.host → Yahoo）
4. cp portfolio.json memory/snapshots/{date}.json — 每日快照（longitudinal 基础设施）
   • 为什么：portfolio.json 是滚动覆盖的 ground truth，每次刷价就丢前一刻状态。 有 snapshot 历史才能做 Rolling P&L 曲线 / Alpha vs benchmark / Drawdown 分析 / Position 变化追溯。
   • ⚠️ 不可补做 — 每过一天少一份永远拿不回来的数据。
5. HHI / Top2 集中度算法（HK + US leg 分开）
6. SEC EDGAR fundamentals — 从当天 portfolio.json 动态筛选 shares > 0 的 US 持仓；跳过 is_leveraged_etf=true 或被名称启发式识别为杠杆 ETF 的标的，其余单股逐一跑 clawock filings
   • 杠杆 ETF 检测启发式（name 关键词）：'倍', 'Direxion', 'T-Rex', 'Defiance', 'ProShares', '2X Long', '3X Long', 'Daily Target'
   • 不在文档硬编码 ticker；实际名单以当天持仓和上述动态过滤结果为准
7. Retrospective：读 prior v2 plan，对每个 decision 按 strategy 检查 condition 是否触发、模拟 benefit 与 confidence calibration