ai-hedge-fund-btst

name	ai-hedge-fund-btst
description	在本仓库中处理中文 BTST 次日计划、全套文档、执行清单、预警池、交集票高亮、方案 A 观察期目录、BTST 选股策略优化、profile 对照、交易前决策卡等请求时触发。典型触发语义：BTST + 明天/次日/某日收盘数据 + 交易计划|全套文档|执行清单|通俗说明|预警文档|交集票|early-runner|scheme_a|保守|激进|profile 对照|决策卡。

ai-hedge-fund-btst

本 skill 负责本仓库的 BTST 次日文档流与方案 A 观察期选股流。

默认目标

• 默认生成 5 份核心 BTST 文档；如果方案 A 已激活或用户明确要求 early-runner 预警，再额外生成 2 份补充预警文档。
• 默认目标不是“多给几只票”，而是通过更好的分层和排序，提高筛选精度、胜率稳定性和盈亏比质量。
• 仓库默认策略阈值真源是 config/btst_strategy_thresholds.json；除非用户明确要求临时实验参数，否则文档流、复盘流、策略建议都要沿用这份配置。
• 当用户明确要求比较风格、优化胜率/盈亏比，或当前需要在 conservative / aggressive 之间做执行取舍时，优先补一份双 profile 对照摘要和交易前决策卡。
• 所有输出必须把候选明确拆成 4 层：
  • 正式执行层
  • 交集优先复审层
  • 补充复审层
  • 回补机会层
• 只有当用户没有给出保存路径时，才问一句简短问题：
  • 是否保存到默认目录 outputs/YYYYMM/？
• 如果用户已经给出自定义目录，不再重复追问。
• 默认目录中的 YYYYMM 来自 signal date，不是 next trade date。
• 方案 A 观察期内，优先使用 outputs/YYYYMM/YYYYMMDD_scheme_a/，只有观察期通过后才切回 outputs/YYYYMM/YYYYMMDD/。

Alpha / Beta / Gamma 硬职责

• Alpha（统计与赔率）
  • 只对“这批候选是否具备足够的胜率稳定性与赔率质量”负责。
  • 必须抽取并写清：样本量、区间/收缩式谨慎提示、盈亏比质量、胜率与赔率是否分化。
  • 当 artifacts 只能支持点估计、不能支持稳定 edge 时，明确写“证据不足”或“artifacts not available”，不能把点估计包装成硬优势。
• Beta（执行与降级）
  • 只对“明天怎么下、何时确认、何时取消、何时降级/回补”负责。
  • 必须把触发、取消、降级、回补、时段、仓位/成本约束写成可执行语句或表格。
  • 不得用“看盘再说”“强就上”这类空泛表述替代执行 contract。
• Gamma（市场 / 板块 / 赚钱效应）
  • 只对“当前大盘、板块、赚钱效应是否支持更激进或更保守的执行姿态”负责。
  • 必须优先复述 artifacts 已给出的 market gate、板块强弱、题材集中度、赚钱效应/情绪语义。
  • 如果当前 run 没有支持字段，只能写“相关 artifacts not available”，不能补通用盘面评论。

默认优化优先级

1. 胜率 / 赔率严谨性优先（Alpha first）
2. 执行细节具体性第二（Beta second）
3. 市场 / 板块 / 赚钱效应语境第三（Gamma third）

只要三者冲突，先保住命中率与盈亏比质量，再补执行细节，最后才扩写市场语境。

Workflow

1. 解析范围、日期和目录。

   • 如果用户指定了 signal date，直接使用。
   • 如果没有指定，自动解析“已拿到收盘数据的最新交易日”。
   • 永远计算真实的 next trade date。
   • 如果收盘数据不可用，停止并说明 blocker。
   • 如果用户没有缩小范围，默认走全套文档。
   • 规则版首选入口：

   uv run python scripts/btst_full_report.py [--trade-date YYYYMMDD]
   

2. 运行规则版 BTST 报告。

   • 预期产物：
     • data/reports/btst_full_report_YYYYMMDD.md
     • data/reports/btst_full_report_YYYYMMDD.json

3. 运行多智能体 BTST 链路。

   • 本 skill 固定使用 short_trade_only。
   • 默认保持 MiniMax / MiniMax-M2.7，除非用户明确覆盖模型路由。
   • 如果最新优化 profile manifest 已就绪，默认优先使用；但只有产物明确支持时，才能称为 optimized run。
   • 如果用户显式给了 short-trade profile 输入，把它视为主动绕过 manifest 自动选择，不能擅自标记为 optimized。
   • 默认命令：

   uv run python scripts/run_paper_trading.py \
     --start-date YYYY-MM-DD \
     --end-date YYYY-MM-DD \
     --selection-target short_trade_only \
     --optimized-profile-manifest data/reports/btst_latest_optimized_profile.json \
     --model-provider MiniMax \
     --model-name MiniMax-M2.7 \
     --output-dir data/reports/paper_trading_YYYYMMDD_YYYYMMDD_live_m2_7_short_trade_only_YYYYMMDD_plan
   

4. 刷新或读取 early-runner 产物。

   • 方案 A 下，环境允许时先刷新：

   uv run python scripts/analyze_btst_early_runner_v1.py
   uv run python scripts/generate_btst_early_runner_daily_tables.py
   

   • 如果环境嘈杂、离线或刷新不稳定，可以跳过刷新，让文档包直接读取当前 latest artifact。
   • 如果产物只支持 stale_fallback 或 unavailable，绝不能伪造 exact-date 板。

5. 读取当前 artifacts。

   • MANDATORY：起草前加载 references/artifact-reading.md。
   • 先看 operator_summary.json 的运行状态和决策阶段；再用 session_summary.json 作为多智能体 provenance 与 btst_followup 路径真源。
   • 先读 optimization_profile_resolution，再判断本次运行是否真的用了最新 optimized manifest。
   • 如果 session_summary.json 显示 default_fallback，最终文档必须明说，不能默默写成 optimized。
   • 其余读取优先级、缺字段降级、Alpha/Beta/Gamma 证据抽取，统一按 references/artifact-reading.md 执行，不在这里重复展开。

6. 先做选股分层，再写最终文档。

   • MANDATORY：起草前加载 references/final-doc-spec.md。
   • 起草前默认读取 config/btst_strategy_thresholds.json，把它当作 BTST 四层选股、观察期 gate 和建议阈值的共享基线。
   • 优先使用统一入口：

   uv run python scripts/generate_btst_doc_bundle.py \
     --signal-date YYYYMMDD \
     --output-dir outputs/YYYYMM/<signal_dir> \
     --strategy-thresholds-config config/btst_strategy_thresholds.json \
     --no-refresh-early-runner
   

   • 其中 <signal_dir> 在方案 A 观察期使用 YYYYMMDD_scheme_a，观察期通过后才切回 YYYYMMDD。

   • 必须在文档里执行下面的分层策略：

     • 正式执行层：只使用正式 BTST 已经提升到 selected_actions / primary_entry 的票。
     • 交集优先复审层：只有 exact-date overlap 才能进入；它是优先复审，不是无条件下单。
     • 补充复审层：only early-runner priority / watchlist 只做补充观察，不得升级成正式执行层。
     • 回补机会层：second_entry_reentry 单独呈现，不和普通 watchlist 混用。

   • 当请求包含“保守还是激进”“哪套更适合今天”“比较两套 profile”“提高胜率和盈亏比应该偏哪边”这类语义时，优先运行：

   uv run python scripts/generate_btst_doc_bundle.py \
     --signal-date YYYYMMDD \
     --compare-profiles conservative aggressive \
     --output-dir outputs/YYYYMM/YYYYMMDD_profile_compare
   

   • 这一步会额外产出：
     • 双 profile 文档包对照 JSON / Markdown
     • BTST 交易前决策卡 JSON / Markdown
   • 如果决策卡已生成，要把同一套“今日执行倾向”结论桥接进：
     • BTST-YYYYMMDD.md
     • BTST-LLM-YYYYMMDD.md
   • 最终中文回复也必须沿用同一句结论口径，避免文档说偏保守、回答却说偏激进。
   • 核心文档内必须显式落地 references/final-doc-spec.md 规定的三张硬区块，标题名称保持完全一致。
   • 决策卡优先看 4 个字段：
     • 推荐 profile
     • 交集票差异
     • only early-runner 压力
     • second-entry 干扰
   • 状态解释必须固定：
     • exact：允许交集票进入优先复审层。
     • stale_fallback：交集只能标成历史参考。
     • unavailable：完全按正式 BTST 走，不补 early-runner 票。
   • 产物必须来自当前 artifacts，不能靠固定模板脑补。
   • 硬降级 gate：
     • 样本质量弱、赔率质量弱、market gate 未放行、或板块/赚钱效应语境偏弱时，必须降级候选，不能维持正式主票口径。
     • 具体的 Alpha/Beta/Gamma 降级写法与硬区块标题，统一按 references/final-doc-spec.md 执行。
   • 只有在用户明确接受精简，且当前不是必须保留 early-runner 预警输出的方案 A 场景时，才可以只生成 5 份核心文档并使用 --core-only。

7. 交付前验证。

   • 所有请求文件都存在。
   • 文件名使用 signal date，不是 next trade date。
   • 所有文档都写真实的 next trade date，不能写 N/A。
   • 方案 A 激活时，确认文档里能看到 early-runner status、交集票高亮、only early-runner 补充池。
   • Alpha / Beta / Gamma 三条线都要有交付证据；具体验收字段与失败降级口径，统一按 references/final-doc-spec.md 与 references/final-response-template.md 执行。
   • 如果用户请求“优化 BTST 策略”或“看是否值得升级”，优先回答：
     • 交集票是否开始比普通观察票更有价值。
     • only early-runner 票是否大多仍是噪音。
     • 当前是否还处于 scheme_a 观察期。
     • 是否满足切回正式目录或进入中期强化阶段的条件。

策略硬规则

• 最终文档必须是中文。
• 股票首次出现必须用 stock_code + stock_name。
• 不能虚构股票名、原因、排序、执行规则、交集关系或 early-runner 状态。
• 不能把 opportunity / research / shadow / near_miss / only early-runner 票擅自升成正式交易票。
• 不能让 early-runner 抢正式主票决策权；它当前只能做观察增强和优先级增强。
• 交集票的正确处理是“优先看、优先复审、优先等确认”，不是“优先盲打”。
• stale_fallback 交集只能作为参考高亮，不能当成当日优先级提升。
• second_entry_reentry 必须单独呈现，不能并入普通 watchlist。
• 当样本质量、赔率质量、market gate 或板块/赚钱效应语境偏弱时，必须降级候选，不能维持正式主票口径。
• 不能把高胜率但低赔率、或低样本下的点估计，包装成稳定 alpha。
• 不能把缺少 artifacts 支持的板块情绪、赚钱效应、执行触发/取消规则写成既成事实。
• BTST-YYYYMMDD.md 以规则报告为准。
• BTST-LLM-YYYYMMDD.md 与 BTST-YYYYMMDD-EXEC-CHECKLIST.md 以多智能体计划为执行真源。
• 市场背景只能来自当前 artifacts 和可观察上下文，不能写通用股评。
• 一般字段缺失时直接省略，不猜；但对 胜率/赔率诊断卡（Alpha）、执行触发/取消/升级/降级矩阵（Beta）、大盘-板块-赚钱效应环境卡（Gamma） 这三类硬区块，若当前 artifacts 不支持，必须显式写 artifacts not available 或 context weak，不能直接消失。
• 需要交互输入时，向用户要答案后继续。
• 上游 artifacts 产不出来时，停止并报告 blocker，不伪造 deliverables。
• 当 session_summary.json 存在时，不能把 report directory 名字当真源。
• 只有 session_summary.json 或 downstream artifacts 明确支持时，才能声称本次运行是 optimized-profile run。
• 如果 optimization_profile_resolution.mode=default_fallback，要在最终文档里明确写出 fallback 状态和原因。
• 如果 rollout / strict-objective / replay validation 相关 artifacts 给出 hold、runtime_replay_required_before_conclusion 或其它 blocked 结论，必须照实写，不能包装成 active upgrade。
• 对 candidate-entry / weak-structure 清洗规则，shadow_rollout_review_ready 仅代表 governed shadow evidence，不代表默认升级许可。
• 只有当当前 artifacts 明确支持时，最终中文文档才可以提到 auto-applied P5 precision gate。
• 如果已经生成双 profile 对照和交易前决策卡，最终回复不能只丢路径，必须明确说今天更偏 conservative 还是 aggressive；并且始终保留 1 条 Alpha 统计质量理由 + 1 条 Gamma 市场/gate 理由 作为主骨架。交集票 / only early-runner / second-entry 只能作为补充强因子，不能替代这条主骨架。
• 如果决策卡已经桥接进主文档，最终回复必须与主文档里的“今日执行倾向”保持完全同口径，不能一边偏保守一边偏激进。

观察期与评估口径

• 方案 A 观察期重点看 6 项：
  • early_runner_status
  • early_runner_latest_trade_date
  • 是否出现交集票高亮
  • 是否出现 only early-runner 补充票
  • 核心文档是否都生成
  • 是否需要手工修补
• 周度和阶段评审时，优先判断：
  • exact 占比是否提升
  • 交集票是否比普通观察票更有价值
  • only early-runner 票是否仍以噪音为主
  • 是否满足切回正式目录的条件
• docs/plans/2026-05-27-early-runner-adoption-plan.md 定义了 BTST 四层选股结构。
• docs/plans/2026-05-27-early-runner-scheme-a-operations.md 定义了 scheme_a 目录、每日运行链路和切换 gate。
• config/btst_strategy_thresholds.json 定义默认策略阈值；如果用户没有明确要求试验值，就不要偏离它。

Lazy loading

• 在读取 run outputs 前，加载 references/artifact-reading.md。
• 在起草最终文档前，加载 references/final-doc-spec.md。
• 在发送最终中文回复前，加载 references/final-response-template.md。
• 当用户问如何触发 skill 或触发语义不清时，才加载 references/trigger-examples.md。
• 当请求涉及方案 A、early-runner 分层、观察期目录或策略优化判断时，优先对照：
  • docs/plans/2026-05-27-early-runner-adoption-plan.md
  • docs/plans/2026-05-27-early-runner-scheme-a-operations.md
• 正常执行时不要加载 使用说明.md 或 scripts/install_symlink.sh。

P0D / P0B 行为边界

• operator_summary.json、统一入口、ONE-PAGER、profile compare scope、最终回复格式的细则，统一以 lazy-loaded reference 文件为准：
  • 读取优先级与 failed/degraded 流程：references/artifact-reading.md
  • 文档结构、硬区块标题、profile compare 边界：references/final-doc-spec.md
  • 决策卡驱动的最终回复顺序与理由口径：references/final-response-template.md
• SKILL.md 只保留总原则，不重复展开这些 reference 已覆盖的细节，避免 prompt 膨胀和双重真源。