用 claude-trading-skills 引导式跑批器验证 market-regime-daily 工作流:决策闸门、证据哈希与断点恢复

原创2026-11-14 12:24:361,722 阅读
文章标签:金融科技AI 技能人工智能数据分析

用 claude-trading-skills 引导式跑批器验证 market-regime-daily 工作流:决策闸门、证据哈希与断点恢复

本文以仓库中的引导式运行器 scripts/run_market_regime_daily.py 为主线,讲清如何在一个完全离线、数据全部虚构的环境里,完整走一遍 market-regime-daily 工作流的“就绪校验 → 分步执行 → 人工仓位姿态决策 → 本地日志交接”闭环。读者读完可以掌握三件事:如何用一条命令安全地跑出一份带完整性证据的离线会话、如何理解 allow / restrict / cash-priority 决策闸门的参数契约,以及当进程被中断、锁文件残留或产物被篡改时,如何按仓库既定策略做保守恢复而不破坏证据。

重要前提:这条路径评估的固定时间点是 2026-01-15T13:08:00+00:00,使用仓库内已提交的虚构组件夹具(fixture)。它不描述今天的市场,也不构成任何买卖信号。运行器的 LIMITATIONS 常量(scripts/run_market_regime_daily.py)把这条边界写死在每个运行的 manifest 与 journal 里。

定位:这条引导式路径解决什么问题

market-regime-daily 工作流本身由四个步骤组成(workflows/market-regime-daily.yaml):

步骤 技能 产物 ID 是否决策闸门
1 market-breadth-analyzer market_breadth_report 否
2 uptrend-analyzer uptrend_report 否
3 market-top-detector(可选) top_risk_report 否
4 exposure-coach exposure_decision 是

仓库里已有两套证据:一套是确定性 replay(scripts/workflow_replay.py 加 examples/workflows/market-regime-daily/replay.yaml),用于比对 golden 输出;另一套就是本文主角——引导式运行器,它在 replay 的 fixture 契约之上,额外补齐了三样 replay 不具备的东西:

  1. 单次运行专属的溯源(run-scoped provenance):每次运行生成独立 UUID,写进每个产物与 manifest;
  2. 显式人工闸门:第 4 步算出的“暴露建议”只是建议,必须由人输入姿态才落成决策;
  3. 断点恢复与完整性拒绝:中断后可以从已完成的检查点继续,但任何哈希、run_id、步骤顺序或源码指纹的偏移都会被拒绝,而不是“迁就”现有文件继续。

从源码结构看,运行器并没有重新实现市场分析逻辑,而是复用 replay 包中的校验器与原生评分器加载器(_load_market_fixture_set、_market_modules、_market_analysis,见 scripts/workflow_replay_pkg/steps_market_regime.py)。这决定了它对“原生 API”的调用是真实的,但对“数据获取”是完全离线的。

环境准备与首次运行

使用仓库锁定的环境,无需任何 provider 凭据:

uv sync --locked --extra dev

在仓库根目录执行:

uv run python scripts/run_market_regime_daily.py --run-dir reports/regime-demo

关于 --run-dir 有三条硬性规则,全部由源码强制:

  • 每次运行必须用一个新目录。运行器用 directory.mkdir(parents=True, exist_ok=False)(scripts/run_market_regime_daily.py),因此已存在的目录(包括空目录)一律被拒绝,避免把上一次的证据混进新一次运行。
  • 目录及其所有父级不得包含符号链接,否则直接抛 RunError。
  • 就绪校验发生在分配运行目录之前:contract() 先跑完工作流契约校验、fixture 校验和原生 scorer 模块加载,只有全部通过才 mkdir。所以依赖缺失或契约漂移不会留下半成品目录。

首次运行会按顺序完成:

  1. 校验工作流契约——id 必须是 market-regime-daily,四个步骤的技能顺序必须与 SKILLS 常量一致,decision_gate 必须严格是 [False, False, False, True],journal_destination 必须是 trader-memory-core;任一项变化即报“当前运行器需要同步更新”。
  2. 校验 fixture 契约并把三份夹具快照进本次运行目录的 inputs/。
  3. 加载 market-breadth-analyzer、uptrend-analyzer、market-top-detector 的 scorer.py/report_generator.py,以及 exposure-coach 的 calculate_exposure.py。
  4. 计算 breadth 与 uptrend 报告;默认显式跳过可选的天顶风险评估;再只用本次运行的产物计算 Exposure Coach 建议。

是否纳入天顶风险:必须在创建时决定

uv run python scripts/run_market_regime_daily.py \
  --run-dir reports/regime-demo-full --include-top-risk

--include-top-risk 只在创建运行时生效。源码在 main() 中直接拒绝“恢复时改配置”:--include-top-risk 与 --resume 或 --status 同时出现会触发 argparse 报错并返回退出码 2(scripts/run_market_regime_daily.py)。原因是 manifest 中的 include_top_risk 是运行契约的一部分,verify() 会检查它必须是布尔值,且第 3 步的状态必须与之一致——要么是带 reason: optional_not_selected 的 SKIPPED,要么是真实执行结果;SKIPPED 步骤的字典必须逐字段完全等于预期形态,否则报“可选步骤的跳过必须是显式的”。

命令与参数契约

参数 取值 约束与语义
--run-dir 路径,必填 新运行时必须是尚不存在的目录;--resume/--status 时必须是已存在的运行目录
--resume flag 与 --status 互斥(同一 mutually exclusive group)
--status flag 只读校验并打印状态,不更新 manifest
--include-top-risk flag 仅创建时有效;恢复/查询时给出即报参数错误
--decision allow / restrict / cash-priority 只能与 --resume 搭配,且运行必须处于 AWAITING_DECISION

--decision 的两道前置校验顺序值得注意:先由 argparse 层拦截“没有 --resume 却给了 --decision”(退出码 2),再由运行器在状态机上拦截“已不在 AWAITING_DECISION”(RunError,退出码 1)。前者不会创建目录,后者不会写 journal。

决策闸门:建议不等于许可

交互式终端下,运行器会打印暴露建议的 result 部分,并提示:

Posture (allow / restrict / cash-priority; blank pauses):
  • 输入三者之一:立即以 --resume --decision <posture> 的方式二次进入运行、写入 journal.json,最后打印“本地日志交接已记录;未投递”。
  • 输入空行:运行保持暂停,打印恢复指引并返回退出码 3。
  • 输入非法值:抛 RunError,运行保持暂停。

在重定向输入或 CI 场景,sys.stdin.isatty() 为假,运行器总是在展示建议后暂停并返回 3,不会读取 stdin。因此 CI 里的标准两段式写法是:

# 第一段:跑到闸门前,预期退出码 3
uv run python scripts/run_market_regime_daily.py --run-dir reports/regime-demo

# 查询当前证据与状态(只读)
uv run python scripts/run_market_regime_daily.py \
  --run-dir reports/regime-demo --status

# 第二段:显式记录人工姿态
uv run python scripts/run_market_regime_daily.py \
  --run-dir reports/regime-demo --resume --decision restrict

几个容易被忽略的行为细节:

  • --resume 不带 --decision 在 AWAITING_DECISION 上只做校验与展示,然后重新返回 3;它不会替你“顺手”记录许可。
  • 已完成的运行拒绝再次决策:state["status"] != "AWAITING_DECISION" 时给 --decision 直接 RunError,对应回归测试断言 --resume --decision allow 在完成后返回 1。
  • 对已完成运行做 --resume 是幂等的:校验并展示既有结果,不重写任何产物,也不刷新步骤时间戳。测试用 st_mtime_ns 对比确认了这一点(scripts/tests/test_run_market_regime_daily.py)。
  • 决策一旦写入即不可变更:journal.json 里的 decision 与 recorded_at 来自第 4 步记录,后续校验会重算 journal 全量内容并逐字节比对。

运行目录里的证据结构

一次成功暂停(或完成)的运行目录形如:

reports/regime-demo/
├── .lock                      # 写入期间存在,正常退出时删除
├── manifest.json              # 运行状态机与全部哈希
├── inputs/
│   ├── breadth.json           # {run_id, fixture} 绑定本次运行
│   ├── uptrend.json
│   └── top_risk.json
├── 01_market_breadth_report.json
├── 02_uptrend_report.json
├── 03_top_risk_report.json    # 仅 --include-top-risk 时存在
├── 04_exposure_proposal.json
└── journal.json               # 仅在做出决策后出现

manifest.json 承载什么

initialize()(scripts/run_market_regime_daily.py)写入的字段可以分为四组:

分组 字段 说明
身份 schema_version、workflow_id、run_id run_id 是标准 UUID,校验时通过 uuid.UUID() 往返比对,防手工篡改
时间 created_at、evaluation_at evaluation_at 必须等于 replay spec 里的固定时间戳,不允许自由设定
配置 include_top_risk、readiness、limitations readiness 被固定为 {"status": "PASSED", "api_environment": "not_required"}
证据 sources、inputs、steps、status、journal sources 是源码指纹;inputs 与步骤的 output 都是 {path, sha256} 记录

每个步骤条目在生命周期中依次是 PENDING → RUNNING(写入 started_at 并落盘)→ COMPLETED(步骤 1–3)或 AWAITING_DECISION(步骤 4),并补充 completed_at、inputs、output。步骤 1–3 的 inputs 只指向自己那一个夹具记录,步骤 4 的 inputs 是全部已完成产物记录的集合——这就是“步骤依赖”的可验证声明。默认路径下步骤 3 是 {"step": 3, "skill": ..., "status": "SKIPPED", "reason": "optional_not_selected"},它是 SKIPPED,永远不是 PASSED。

inputs/*.json 的内容被写成 {"run_id": <本次 UUID>, "fixture": <夹具原文>},把夹具快照与运行身份绑定,防止跨运行挪用。

journal.json:只是本地交接

{
  "schema_version": 1,
  "run_id": "...",
  "fictional": true,
  "destination": "trader-memory-core",
  "delivery": "handoff_only",
  "decision": "restrict",
  "recorded_at": "...",
  "proposal": {"path": "04_exposure_proposal.json", "sha256": "..."},
  "limitations": ["..."]
}

由 journal() 生成(scripts/run_market_regime_daily.py)。它记录决策 + 建议产物的哈希,而不是建议的全文。注意 destination 与 delivery 这对字段的诚实性:目标是 trader-memory-core,但交付方式是 handoff_only——运行器既不读取也不修改真实的 thesis/journal 状态、组合、账户或 dotenv 文件。向该目标的实际投递仍属未实现范围(上游 issue #513 保持开启)。

计算链路:从组件夹具到暴露建议

这一节对照源码把数字讲透,方便你验证“为什么默认路径是 REDUCE_ONLY,加入天顶风险后变成 NEW_ENTRY_ALLOWED”。

第一步:夹具契约校验

夹具不是随便一个 JSON。_validate_market_component_fixture 要求字段集严格包含 schema_version、kind、as_of、max_age_days、component_scores、data_availability、warning_flags,并施加以下约束:

  • schema_version == 1 且 kind 与目录中的种类一致;
  • max_age_days 必须是 0–30 的整数(布尔值被显式排除);
  • as_of 不得晚于固定评估时间;
  • as_of 到固定评估时间的间隔不得超过 max_age_days,否则报“该组件证据在固定时间点已过期”;
  • component_scores 与 data_availability 的键集必须恰好等于规范组件集,warning_flags 的键集也必须恰好等于规范旗标集;
  • 每个分值必须是 0–100 的有限数;每个可用性必须是布尔且不得为 false——任何组件缺失都会以“证据不足”失败关闭;
  • 三份夹具的 as_of 必须完全一致(_load_market_fixture_set 中校验 len(as_of_values) == 1)。

规范组件集来自 MARKET_COMPONENT_CONFIG(scripts/workflow_replay_pkg/constants.py):

种类 技能 组件 告警旗标
breadth market-breadth-analyzer breadth_level_trend、ma_crossover、cycle_position、bearish_signal、historical_percentile、divergence 无
uptrend uptrend-analyzer market_breadth、sector_participation、sector_rotation、momentum、historical_context late_cycle、high_spread、divergence
top_risk market-top-detector distribution_days、leading_stocks、defensive_rotation、breadth_divergence、index_technical、sentiment 无

以 breadth 夹具为例(examples/workflows/market-regime-daily/replay-inputs/breadth-components.json):as_of 为 2026-01-14T21:00:00+00:00,max_age_days 为 2,相对 2026-01-15T13:08:00+00:00 的评估时间是 16 小时 8 分,未过期。

第二步:原生评分器

_market_composite 直接调用技能自身的 scorer.calculate_composite_score:uptrend 需要额外传入告警旗标,breadth 与 top_risk 只传分值与可用性。返回值必须是非空映射、可 JSON 有限序列化,且 composite_score 落在 0–100,否则报错。运行器在 provenance.native_surface 中写入 scorer.calculate_composite_score; guided runner JSON serialization,并覆盖 replay 助手默认的 report_generator.generate_json_report 表述——测试专门断言了这一点("report_generator.generate_json_report" not in provenance["native_surface"])。这处覆盖的意义是:引导式运行器确实调用了原生的 JSON 序列化路径,但产物形态由运行器自己的规范化写出逻辑负责,不该冒充 report generator 的直出结果。

同时,breadth、uptrend 两份报告会带 data_provenance 块,由 provenance_contract.build_provenance 生成,provider 为 fictional-fixture、endpoint 为 market-regime-<kind>-component-fixture、若干 adjusted/point_in_time/survivorship_free/corporate_actions_handled 均为 false,并把 run_id 改写为本次运行的 UUID(replay 包内的全局 MARKET_PROVENANCE_RUN_ID 常量被保留不动,因为那是 replay 的资产)。

第三步:暴露建议

proposal() 先按 exposure.WEIGHTS 初始化全部键为 None,再填入三个可得的分数,然后依次调用原生 API:

  1. extract_breadth_score / extract_uptrend_score / extract_top_risk_score。注意天顶风险是反向语义:market-top-detector 的 composite.composite_score 越高代表风险越高,取分时按 100 - score 反转成“越高越安全”的口径(skills/exposure-coach/scripts/calculate_exposure.py)。
  2. validate_market_inputs(breadth, uptrend, run_id=..., evaluation=..., max_age_days=3)——硬编码 3 天新鲜度,且只覆盖 breadth 与 uptrend;天顶风险被明确排除在这个闸门之外(返回的 boundaries 里写着 “optional top-risk and other inputs are outside this gate”)。它会校验 run_id 一致、retrieved_at 为 UTC 且不晚于评估时间、as_of 不晚于检索、数据未过期(skills/exposure-coach/scripts/provenance_contract.py)。
  3. calculate_composite_score 做加权平均,权重只累加实际提供的输入;随后对每个缺失的关键输入(CRITICAL_INPUTS = {"regime", "top_risk", "breadth"})扣 10 分,下限为 0。
  4. determine_recommendation、determine_exposure_ceiling、determine_bias("Unknown", None, None, None)、determine_participation、determine_confidence 依次给出门槛、姿态、偏向、参与度与置信度。

用默认路径可以手工复算:breadth 66、uptrend 71,权重各 0.15,加权和 9.9 + 10.65 = 20.55,总权重 0.30,合成分为 68.5;缺失关键输入为 regime 与 top_risk 两项,扣 20,得 48.5。48.5 落在 <a href="https://link.gitcode.com/i/f829bd3ef805bd1310c5daa19ddbabc0" target="_blank">35, 50) 区间,暴露上限为 int(30 + 13.5 × 1.3) = 47;合成分 < 50 触发 REDUCE_ONLY;provided 只有 2 个而缺失关键输入有 2 个,因此置信度为 LOW。uptrend 与 breadth 均 ≥ 50,参与度为 BROAD。这与 [examples/workflows/market-regime-daily/sample-run/04_exposure_decision.json 完全一致。

加入天顶风险后(该夹具算出的可用安全分为 62):加权和 20.55 + 62 × 0.20 = 32.95,总权重 0.50,合成分 65.9;只缺 regime 一项,扣 10,得 55.9。上限 int(50 + 5.9 × 1.3) = 57;合成分 ≥ 50、天顶风险 62 ≥ 40、缺失关键输入 1 项 < 2,故为 NEW_ENTRY_ALLOWED;provided 3 个,置信度 MEDIUM。这正是 full-path golden 的值,也是回归测试参数化的 (False, 48.5) / (True, 55.9) 两例。

引导式运行器输出的 04_exposure_proposal.json 与 replay golden 的 04_exposure_decision.json 形态不同:前者是 {schema_version, run_id, evaluation_at, fictional, result: {...}} 的嵌套结构,result 内含 input_lineage 与 rationale;后者是扁平的单一报告。两者数字一致,但不要混用文件名或结构。

完整性校验:verify() 到底检查了什么

verify()(scripts/run_market_regime_daily.py)是这条路径的核心资产:它在交接与恢复之前,把磁盘上的东西与原生重算结果对齐,但不重跑已完成步骤的发布动作。检查清单如下:

  1. 契约字段:schema_version == 1、workflow_id 正确、run_id 是规范 UUID、evaluation_at 等于 spec 固定时间戳、include_top_risk 是布尔、limitations 全等、readiness 全等。
  2. 源码指纹:state["sources"] 必须与当前 source_fingerprint() 完全相等,否则报“运行器、工作流、夹具或原生源码已变更;请开启新的运行”。
  3. 输入绑定:三份 inputs/*.json 的路径与哈希必须匹配,且内容必须等于 {run_id, fixture}。
  4. 步骤顺序与状态:步骤号与技能必须逐位对应;PENDING 条目必须只含三个字段(不允许携带残留的执行态);一旦出现 PENDING,其后不允许再有已完成步骤;AWAITING_DECISION 只允许出现在第 4 步。
  5. 依赖一致性:步骤 inputs 必须等于预期集合。
  6. 产物重算比对:verify_record 校验路径与 sha256,然后用原生 API 重算期望值并整棵树深比较——步骤 1–3 用 component(),步骤 4 用 proposal()。任一处不等即报“保存的输出与原生计算或运行溯源不一致”。
  7. 状态与完整性一致:有未完成步骤则整体必须是 IN_PROGRESS。
  8. 完成态额外校验:决策值必须在白名单内、decision_at 可解析、journal.json 记录匹配且内容等于 journal(state) 重算结果。
  9. 决策不得先于闸门:未完成态下若出现 decision 字段、journal 字段或 journal.json 文件,一律拒绝。

最后一步的边界也很明确:哈希用于发现损坏与意外编辑,但 manifest 不是签名或防篡改审计记录。手工改 manifest 骗不过去,是因为重算比对会把伪造的哈希与伪造的产物一起否掉——回归测试用六种变异(改产物哈希、换 run_id、把步骤标为 SKIPPED、直接把整体标为 COMPLETED、把产物路径改成 ../outside.json、把步骤改回 RUNNING)逐一验证了这一点,全部返回 1 且不产生 journal.json。

源码指纹覆盖哪些文件

source_fingerprint()(scripts/run_market_regime_daily.py)对下列文件的 SHA-256 做映射,键是仓库相对路径:

  • workflows/market-regime-daily.yaml
  • scripts/workflow_replay.py 与 scripts/workflow_replay_pkg/*.py
  • scripts/validate_provenance.py
  • 运行器自身
  • examples/workflows/market-regime-daily/replay.yaml 与 replay-inputs/*.json
  • 四个技能各自 scripts/ 下递归的全部 .py(排除 tests 目录)

这意味着:改了任何一个评分器、replay 助手、工作流定义或夹具,旧运行目录都不再可恢复,必须开新目录。这是有意为之——避免把不同代码版本下的产物拼成一次“看起来完整”的运行。

中断与恢复:保守优先

状态机与检查点

每个步骤在执行前先把自身标为 RUNNING 并落盘 manifest,执行成功后写入产物、更新 output 记录与 completed_at、再落盘一次。因此:

  • 已完成步骤恢复时不重写产物。测试通过注入 after_checkpoint 钩子在步骤 1 完成后抛 KeyboardInterrupt,恢复后断言步骤 1 产物 mtime 未变、整体到达 AWAITING_DECISION。
  • RUNNING 与 FAILED 步骤永不自动重试、永不自动升级。异常路径会把步骤与整体状态都置为 FAILED,写入固定的 failure 文案后重新落盘,然后抛出 RunError。恢复时若发现这些状态,直接报“步骤中断、失败或乱序;请开始新的运行”。正确做法是保留该目录作为证据,另起一个新目录。
  • journal 发布也是执行边界。发布期间整体状态被临时置为 RUNNING 并先落盘,再写 journal.json,随后记录哈希并置为 COMPLETED。若在此窗口崩溃,RUNNING 状态会阻止后续“采纳”那份可能只写了一半的 journal,同样要求新开运行。

锁文件排查四步法

.lock 用独占创建(open("x"))实现,文件内写入持有者的 PID;正常退出或 Python 级中断在 finally 中删除。SIGKILL 或断电可能留下残留。运行器永不自动删除已存在的锁——遇到锁就报“运行已被锁定;手工恢复前请先确认持有者”。

按文档给出的顺序处理:

  1. 读该次运行目录 .lock 里的 PID,用 ps -p PID -o pid=,command= 检查。注意 PID 可能被复用,务必核对命令行与运行目录。
  2. 若属主进程仍在运行,等它结束,不要删它的锁。
  3. 只有在确认没有进程拥有这次运行后,才手工删除那一个 .lock。保留全部 JSON 产物与 manifest。
  4. 运行 --status。若出现 RUNNING/FAILED 步骤、哈希不符或 manifest 不完整,保留证据并改用新目录。不要为了强行恢复而编辑状态字段、哈希或删除产物。

--status 会短暂获取同一把锁、只读校验、更新零个字段。测试验证了:残留锁内容被原样保留、恢复返回 1;把产物替换成指向外部文件的符号链接同样返回 1,且外部文件不被触碰。

原子写与写入拒绝

  • manifest 的替换走“先写 .tmp 并 flush+fsync,再 os.replace 原子改名”。.tmp 用 "xb" 打开,遗留的 .tmp 会被拒绝而不是复用,避免采纳被截断的中间状态。
  • 所有产物与 inputs/*.json 用 "xb" 独占创建,已存在即失败,杜绝“覆盖旧证据”。
  • regular_bytes() 在读取任何文件前检查自身与全部父级是否是符号链接,并确认是常规文件。

退出码与诊断约定

退出码 含义 典型场景
0 已完成 决策已记录、journal 已发布
3 等待决策 建议已生成但尚未记录人工姿态(含 CI 与重定向输入场景)
1 失败或阻塞 就绪校验、完整性、锁、执行失败
2 参数非法或运行时依赖缺失 参数互斥冲突、缺少依赖

诊断输出遵循两条安全规则:一是不回声不可信内容——无效 manifest、夹具或 provider 数据的具体内容不会出现在 stdout/stderr,测试用带标记的私有字符串断言了“未泄漏、无 traceback”;二是不谎报执行——完整性失败打印 BLOCKED,并保留上一版 manifest 供诊断,而不会把状态改写成“确实执行过”。

依赖缺失的识别比较讲究:replay 适配层会把导入失败包装成 ReplayError,所以 main() 会沿 __cause__/__context__ 链向上遍历(带 visited 集合防环),只要链上出现 ImportError 就返回 2,并提示 uv sync --locked --extra dev。此外,依赖与就绪失败都发生在分配新运行目录之前,所以失败的运行不会留下目录。

安全与合规边界

运行器的边界是“结构性”的,不靠约定:

  • 不触网、不碰账户:没有 provider 抓取、没有券商动作、没有网络调用。
  • 不读凭据:不读取 dotenv、不检查也不记录任何凭据。回归测试甚至故意设置 FMP_API_KEY=private-key-must-never-be-recorded,然后遍历运行目录内所有 JSON 断言该字符串未出现。
  • 不改真实状态:不读写真实的 thesis/journal、组合与账户。journal.json 只是本地交接文件。
  • 不执行 Exposure Coach 的 CLI:它直接调用该技能的 Python API(extract_*、calculate_composite_score、determine_*、generate_rationale)。这与 replay 路径不同——replay 的第 4 步 executor_mode 是 native_cli,会真正起子进程并在其中剥离 API key/token/secret/password/proxy 环境变量。
  • 组件计算器不参与:这里消费的是“完整的虚构组件分值”,单项组件计算器与实盘 API 行为都在路径之外。

这些限制会以 LIMITATIONS 数组的形式随 manifest 与 journal 一起落盘,让证据自身携带免责声明,而不是依赖读者记得文档。

与确定性 replay 的关系:两套证据,各司其职

维度 引导式运行器 确定性 replay
入口 scripts/run_market_regime_daily.py scripts/workflow_replay.py run --spec ...
产物形态 04_exposure_proposal.json(嵌套 result) 04_exposure_decision.json(扁平)
决策 人工闸门 + journal.json gate_policy: record_only
恢复 支持检查点续跑 事务式重生成,失败不改动既有目标
用途 学习一次完整流程与证据链 比对 golden、作为独立数值基线

replay 的两种变体与预期姿态记录在 examples/workflows/market-regime-daily/README.md:required-only 为 REDUCE_ONLY + LOW,full-path 为 NEW_ENTRY_ALLOWED + MEDIUM。恢复命令为:

python3 scripts/workflow_replay.py run \
  --spec examples/workflows/market-regime-daily/replay.yaml \
  --variant required-only \
  --output-dir /tmp/market-regime-required

python3 scripts/workflow_replay.py run \
  --spec examples/workflows/market-regime-daily/replay.yaml \
  --variant full-path \
  --output-dir /tmp/market-regime-full

python3 scripts/workflow_replay.py check

文档明确保留了一条判据:现有的确定性 replay 仍是独立的数值基线。引导式运行器共用 replay 的 fixture 校验与 scorer 助手,因此两者的数值天然应当一致;但引导式运行器不替换 golden,也不能作为“生产验证”的替代。

故障排查速查

现象 可能原因 处置
退出码 3 建议已生成,等待人工姿态 用 --resume --decision <posture> 记录,或先 --status 复核
BLOCKED: ... source changed 源码指纹与运行时不一致(改了运行器/工作流/夹具/技能脚本) 保留旧目录,新开运行目录
BLOCKED: ... hash mismatch 产物被编辑、被替换或来自另一次运行 保留证据,新开目录;不要改哈希
BLOCKED: ... locked .lock 残留 按四步法确认属主后再手工删除该锁
RunError: Run directory 已存在 --run-dir 复用了旧目录或空目录 换一个新的目录路径
退出码 2,提示 uv sync --locked --extra dev 运行时依赖缺失 补齐锁定环境后重试(不会留下半成品目录)
步骤状态为 FAILED 步骤执行异常,已按策略放弃自动重试 依 manifest 诊断后新开运行
找不到 03_top_risk_report.json 未在创建时加 --include-top-risk 新开运行并显式开启;不能在恢复时补

尚未实现的部分

向上游 issue #513 归属的能力仍然开放:向 trader-memory-core 的实际投递,以及未来可能的实盘数据接入或其他工作流扩展。本文这条运行器既不为这些扩展授权,也不实现它们。把 journal.json 读成“已经写进记忆库”是这类实验最常见的误读——delivery: handoff_only 就是给这种误读准备的显式标记。同样地,proposal 不等于许可,SKIPPED 不等于通过,manifest 的哈希也不等于签名审计。理解这三点,才算真正把这套引导式离线路径用对。

登录后查看全文
claude-trading-skills