Plan & Review

Validated pre-market, intraday, and post-market reports

Install

openclaw skills install @fize/plan-review

Plan & Review — 盘前计划与盘中/盘后复盘

这是一个只读的市场研究与复盘流程。三类报告分别回答：开盘前需要观察什么、午间哪些假设得到验证、收盘后全天结构如何演变。午间和盘后市场复盘可以独立运行；只有“复核既有假设”部分需要对应的前置报告。

技能协同与工作流衔接

盘前准备阶段：在运行 prepare --phase pre 之前，推荐优先调用 market-intel 技能提取隔夜外盘、宏观与要闻事实，作为盘前计划的定性背景输入。
盘后复盘阶段：在进行题材生命周期划分与次日观察清单制定时，推荐结合 risk-guard 的大势环境定义（Regime）确定当前市场的整体风险系数。

不可违反的规则

先运行 workflow.py prepare，返回 status: ready 后才能创建对应报告。
任一必需数据缺失、过期、日期不一致、字段变化或覆盖率不达标时，停止生成；向用户列出错误和建议的下一次采集窗口。
只使用数据包内的数值。每条量化陈述在同一行用 [E01] 形式引用证据。
区分事实、解释、假设和反证；不把实时值写成收盘值，不用当前截面回填历史截面。
报告完成后必须运行 workflow.py validate。验证失败不交付报告。
不调用任何委托或执行层工具；本技能只采集市场数据、形成研究计划和复盘结论。
market 只提供数据。报告中的市场定性、题材阶段、假设与反证必须由你读取数据包后完成，不能期待数据脚本返回结论。
必须实际使用数据包中的全市场涨跌分布与排行、指数历史、连板梯队、行业分布及行业/概念 1/3/5 日资金流；不能只摘录汇总家数。
盘中比较前一交易日收盘与午间原始数据；盘后比较午间与收盘原始数据，不从前置报告文本反推数值。
午间和盘后报告必须包含市场概览、恐慌贪婪指数和商品行情三个模块；数据不足时明确阻断或标记不可计算，不填默认中性值。
报告只能使用模板规定的章节和字段，不复述用户任务、工具调用或执行边界；正式报告通过脚本校验后才能交付。

环境

所有命令从项目根目录运行。数据采集使用 market 技能自己的环境；工作流脚本只依赖 Python 标准库。

bash

uv venv market/.venv
uv pip install --python market/.venv -r market/requirements.txt

数据生命周期

实时全市场、资金流和龙虎榜接口不能可靠重建任意历史时点，因此必须在业务窗口内采集带时间戳的原子快照：

快照	允许时间（Asia/Shanghai）	内容
午间	交易日 11:30-13:00	全市场宽度与成交额、资金流、涨跌停活动、指数
收盘	交易日 15:05 后	全市场收盘结构、资金流、涨跌停活动、指数
龙虎榜	交易日 16:30 后	当日龙虎榜明细与机构统计

bash

plan-review/.venv/bin/python plan-review/scripts/workflow.py capture --phase noon --date YYYYMMDD
plan-review/.venv/bin/python plan-review/scripts/workflow.py capture --phase close --date YYYYMMDD
plan-review/.venv/bin/python plan-review/scripts/workflow.py capture --phase lhb --date YYYYMMDD

如果 plan-review/.venv 尚未建立，可用系统 Python 运行 workflow.py；它会通过子进程调用 market/.venv。

盘前准备

目标是给当日建立可证伪的观察框架，不预测无法验证的确定结果。

必需数据：

AKShare 交易日历；
前一交易日收盘全市场快照；
前一交易日指数历史与收盘行业/概念 1/3/5 日资金流快照；
前五个交易日涨停、炸板和跌停活动；
已结束交易日的美股指数，以及采集时点的 A50、美元人民币；
自选股历史（仅在用户配置自选股时必需）。

自选股未配置时正常忽略；部分标的可用时数据包返回 warning；全部不可用时阻断盘前报告。

bash

plan-review/.venv/bin/python plan-review/scripts/workflow.py prepare --phase pre --date YYYYMMDD

成功后读取返回的数据包和 templates/pre_market.md，创建 report/daily/YYYYMMDD_盘前计划.md。必须检查指数多周期数据、市场宽度与涨跌分布、异动排行、连板梯队和行业分布、1/3/5 日资金排行及自选股 K 线/指标。重点说明隔夜背景、前日结构、最多三条今日假设及其失效条件。

盘中复盘

目标是用午间截面复盘市场并逐条核对盘前假设。没有同日盘前报告时仍可生成独立市场复盘；没有午间快照时不能生成。

先在午间窗口执行 capture --phase noon，再运行：

bash

plan-review/.venv/bin/python plan-review/scripts/workflow.py prepare --phase noon --date YYYYMMDD

成功后读取数据包和 templates/intraday_review.md，如存在则读取同日盘前报告，创建 report/daily/YYYYMMDD_盘中复盘.md。报告必须先给出市场概览、恐慌贪婪指数、商品行情，再写上午事实；有盘前假设时逐条判为“确认、部分确认、失效、证据不足”之一，并写出下午需验证的收盘数据。

盘后复盘

目标是复核全天判断、识别结构演变并形成次日研究清单。盘后市场复盘可独立运行；若要比较午后变化，必须有完整午间快照；若要复核既有判断，则读取可验证的前置报告。

15:05 后执行 capture --phase close 保存收盘市场快照；16:30 后执行 capture --phase lhb 补充龙虎榜。两者都成功后再运行：

bash

plan-review/.venv/bin/python plan-review/scripts/workflow.py prepare --phase post --date YYYYMMDD

成功后读取数据包和 templates/post_market.md，如存在则读取前两份报告，创建 report/daily/YYYYMMDD_盘后复盘.md。报告必须先给出市场概览、恐慌贪婪指数、商品行情，再写收盘事实与结构判断。

题材生命周期使用六类，而不是把不同维度混在同一分类中：

观察：首次出现，持续性证据不足；
启动：广度与强度同步改善，资金开始一致；
扩散：参与面继续扩大，核心和跟随增强；
高潮：绝对强度高但边际改善放缓，拥挤风险上升；
分歧：内部明显分化，仍有核心承接；
退潮：广度、强度、持续性和资金多数转弱。

每次分类同时列出广度、强度、持续性、资金一致性和反证。若证据冲突，选择“分歧”或“观察”，不得强行归类。

报告验证

bash

plan-review/.venv/bin/python plan-review/scripts/workflow.py validate --phase pre --date YYYYMMDD
plan-review/.venv/bin/python plan-review/scripts/workflow.py validate --phase noon --date YYYYMMDD
plan-review/.venv/bin/python plan-review/scripts/workflow.py validate --phase post --date YYYYMMDD

验证器检查：数据包状态和日期、必需章节、bundle_id、证据编号、量化陈述的同行引用，以及禁止进入报告的执行层内容。

数据文件

原始报告快照：market/data/report_snapshots/YYYYMMDD/
阶段数据包：plan-review/data/YYYYMMDD/
报告：report/daily/YYYYMMDD_{盘前计划,盘中复盘,盘后复盘}.md
自选股（可选）：data/watchlist.json

plan-review/scripts/derived_metrics.py 提供版本化的恐慌贪婪指数（fg-v1）和商品行情行校验；午间和盘后 prepare 会从已校验的市场快照、前一交易日基线和指数历史自动计算指数，分项缺失时阻断。它不依赖其他 Skill，可在独立安装的 plan-review 目录中调用。商品行情由 market commodities 数据命令采集后写入阶段数据包。

快照和数据包是审计证据，不要手工修改。需要重新采集时重新运行 capture，并重新执行后续 prepare 与 validate。