- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add pseudo-longinus/quant-buddy-skills --skill quant-buddy-skill -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add pseudo-longinus/quant-buddy-skills --skill quant-buddy-skill -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add pseudo-longinus/quant-buddy-skills --skill quant-buddy-skill -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add pseudo-longinus/quant-buddy-skills --skill quant-buddy-skill -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/pseudo-longinus/quant-buddy-skills/tree/HEAD/skills/quant-buddy-skillFrom the publisher
涉及选股、TopN、确认后的过滤条件时,先阅读 研究合同与恢复。研究与页面状态分开记录;缺数据或结果为空仍交付可读研究页,不得把未验证写成零命中。
WebAgent 宿主交付约定优先:宿主要求金融问题统一“完整问答+活页”时,所有金融问题先实际 route,再由 QBS 查询验证并发送非终止首答,同轮继续 QBV。包括具体字段、概念解释和“601137 最近如何?”,不依赖建页关键词。Worker 的 QBS_DEFAULT_PAGE_REQUESTED=1 由脚本自动继承;本文件及 leaf workflow 的“只回答/结束/不建页”默认仅适用于独立 QBS。明确不要网页/只回复文字、已有页面只读解读、文件托管与纯维护按各自规则处理。详见 宿主默认建页。
建页意图持续保留:普通“个股分析”与“综合分析”使用同一分类器;附加日期窗口、指标或展示要求不套固定快页。已有显式 QBV/活页意图时传 page_requested:true,查数结束不清除它;非终止首答后执行交接下一步,直至页面与回复验收通过或实际恢复后报告具体阻断。取数 success 不代表页面已交付,详见 先答后建页。
首屏优先:先读本文件前部的「平台工具参数速查」「硬规则」和「场景路由」。简单行情、窗口序列、最近报告期、固定区间收益、K 线图等高频任务命中 Fast Path 时,无需继续整本通读。
本地交付必须复用工具返回的真实路径;不得加 sandbox: 或猜测 Skill 安装目录。排名表逐列核对数据 ID、单位和日期;比值列不能抄到 PE 列。参见 全局执行规则。
个股画像与综合分析的内容合同见 workflows/stock-profile.md:默认交付五个数据章节与综合观察,用户明确要求简短或限定字段时才缩减。读取 Skill 后必须继续读取匹配工作流、实际查询并回复;“将读取文档/准备查询”不是业务交付,不可作为最终答案。明确不要网页只取消建页,不取消上述查询和完整分析。
quant-standard.md 查询并给出实际行情、成交量、估值首答,再按 answer-first.md 继续 QBV。刷新意图不允许先注册公式包,也不能只回复看板设计。不要先要求用户列股票名单。精确板块不存在或确有同名歧义时才澄清,不用几只龙头冒充全部行业。下表是 LLM 最容易写错的三个 schema。任何调用前先核对,不要凭"看起来合理"猜参数名。
口径转换(confirmDataMulti 查询词):用户写 PE(TTM) / 归母净利润 等英文或缩写时,查询词应使用中文规范名(如 市盈率 TTM / 归母净利润),而不是把用户原文照抄进 data_desc。详细规则见 workflows/global-rules.md#指标口径精确匹配。
回测口径硬规则:回测() 的交易时机同时决定成交时点与收益率记账口径。当天开盘买入 / 第二天开盘买入 按开盘到开盘收益记账(今日开盘/昨日开盘-1,含隔夜跳空,跨长假后可超过常规涨跌停);当天收盘买入 按预物化日收益率记账。看到极端单日收益先跑同交易时机基准,不用涨跌停直觉直接判错。信号按列归一适合每日总权重为1的等权/因子组合;信号不归一表示输入原值就是目标仓位/目标暴露,0-1 择时与0.3等目标仓位不得强制归一。
用户问槽位对应合约、换约/换月,或要解释期权IV、价格、持仓量变化时,读取 tools/query_option_contracts.md,使用 query_option_contracts。参数为 asset + query_type:snapshot查最新已生效映射,window用lookback_days查自然日窗口。美股按纽约日期,国内按北京时间及品种夜盘归属交易日;国内empty为空槽,不能补旧合约,E1/E2不等同于期货主力/次主力。支持QBV option_contracts 动态授权。保留实际trade_date,按行情实际日与选约生效日对齐,不把拼接价格当持有收益。skill_server将公开参数转换为各市场Celery五字段日期查询;国内依赖新增dataServer查询任务,未部署不得假装成功。
外盘换月事件仅适用于分钟:Range返回roll_events,RangeMulti仅解析去重后单资产时返回同结构roll_events,多资产与market请求不附事件。外盘日频换月信息当前缺失,不能用分钟事件解释日频换月、复权或合约;详见换月频率边界。
主连/次主连的跨日、跨频、指标或回测任务,先读 连续期货换月与数据口径。新版事件保留 decision_trade_date(决策日/原始参考价取价日)和 effective_trade_date(生效日),按返回 columns 解析;日频复权价格、原始分钟和未复权换月参考价须统一尺度,派生分钟参考序列按文档的加法价差算法计算。
少量分钟缺失、端点差异、日分钟价格/成交量未对齐,默认按日期、字段和计算路径记录告警,继续可用部分和原定交付;不得把跨频严格相等自行升级为整段窗口或全年数据的通过条件。只有确实依赖缺失输入的结果才标未知或不可计算,其他分析继续。保留原始缺口和有效样本数,不补0、不删端点凑量、不将未知收益当0;日分钟可能来自不同来源,不承诺无条件重聚合相等。
用户提供 JPG/PNG、HTML、PDF 等已有文件并要求转活页或公开分享时,优先进入 QBV workflows/existing-file-static-first.md:先 file_prepare 保存原件、生成原始承载页和持久发布参数,保留 file_publish_dir 执行静态发布,验收后在下一次工具调用前先向用户发送链接,file_confirm_delivery确认实际发出的消息,再自动继续已授权的研究、纠错、补指标和QBS接入。复合需求也不能先研究再发布。此顺序高于资产映射、查数、公式验证、图表分类器及“先计算再Handoff”;首版不要求计算胶囊,不先改写原报告。复用真实 task_id/turn_id 和同一个 page_id,不能另建用户可见任务。QBS查询/接入失败只影响增强,保留线上成功版本;未查到不等于平台不支持。纯文件分析、明确不发布不触发;真实公开授权、不可读文件、转换/首次托管问题须如实说明。不得将快照标为实时或已核验。
工具名与 unknown-tool 红线(最高优先级):
runMultiFormulaBatchStream。runMultiFormulaBatch / runMultiFormula / run_multi_formula。未知工具 / Unknown tool / tool not found 后,同名工具 0 次重试,也不得尝试名称变体。认证后验与 session 初始化:
config.json,也不要检查 .session.json、output/.session*.json 或任何本地 session 文件。newSession;不得用 Bash / Glob / Read / ls 做 session 存在性探测。trace_context.py begin 创建 task_id,不得再生成第二个 task_id。优先由 QBV 的 scripts/qbs_bridge.py 调用本技能;bridge 会传 {"task_mode":"inherit","task_id":"<上游 task_id>","task_source":"quant-buddy-view","user_query":"<用户原始问题>"} 并用 QBS_SESSION_KEY=<task_id> 隔离并发 session。此例外只用于跨 Skill 会话绑定。task_mode=inherit,不要通过 qbv_ 等字符串前缀猜测来源。继承 session 会锁定 task_id;后续参数若传入不同值,必须按 TASK_ID_CONTEXT_MISMATCH 停止,不能静默拆链。task_mode/task_id,由 newSession 自动生成新的 UUID 并上报 session begin。api_key 为空 / code: 1 / 401/402 时才进入认证引导并停止当前查数任务。x-skill-name: quant-buddy-skill 与当前 x-task-id,用于跨 Skill Trace 聚合;quant-buddy-view 上游任务不得切换 task_id。原生工具优先,禁止脚本包装:
fast_query、fast_query_minute、fast_query_minute_range、fast_query_minute_range_multi、confirmDataMulti、selectByComposition、runMultiFormulaBatchStream、resumeJob、readData、renderKLine、renderChart 等;但普通K线活页必须先走 kline-page-fast-path.md,不可调用 renderKLine。scripts/call.py / 包装已有原生平台工具。唯一编排例外是 quant-buddy-view 的 ,它只负责继承 task_id 和隔离 session,不改写业务参数或结果。个人数据与执行能力边界:个人持仓、成本、份额和交易记录进入持久化活页前,说明当前活页凭链接公开访问;收集必要参数时一并确认是否允许公开这些信息。要求“记录持仓”不等于同意公开;已明确授权公开时不重复确认,普通公开行情查询不受此限制。不能承诺未经验证的私有访问。页面打开/刷新取数不等于每日定时执行、主动通知或自动交易;只有宿主具备相应能力且实际创建成功后才能承诺已启用。详见 能力与个人数据边界。
修复 T-001 / T-011 / T-024 等 leaf 没把
newSession当成首条强制步骤、跳过直接调平台工具的问题。
无论路由进入 fast-snapshot / fast-window / fast-report-period / render-kline / 任何 leaf workflow:
newSession;newSession 同时登记本 Session 的首个 Turn。beginTurn,参数中的 user_query 必须是本轮原话;同一 Turn 内连续调用多个工具时复用当前上下文,不重复 beginTurn。
newSession / beginTurn 时必须同时生成可选 agent_intent:用简短文字写清本轮要解决的对象、动作、约束和期望产物,推荐 20~160 字。追问中的“那它呢/和上一个比/继续”等指代必须结合已有上下文展开,但不得覆盖用户原话。agent_intent 示例:首问 分析贵州茅台的盈利质量、估值水平与主要风险。;追问“那和五粮液比呢?” → 延续上一轮贵州茅台分析,对比五粮液的盈利能力、估值水平与主要风险。;带约束问题“只要近三年,做成一张表” → 整理目标公司近三年的核心指标并输出单表对比,不扩展到其他期间。user_query 充当 Intent;禁止记录 Chain of Thought、内部推理步骤或未经数据分析的结论。老客户端、自动测试和无法生成 Intent 的旁路允许省略,服务端按 null 处理,不得阻断业务。newSession。不允许用“已读 SKILL.md / leaf workflow”跳过首个 newSession,也不允许用重复 newSession 代替追问的 beginTurn。
newSession 的单次版本检查可能同时返回可选 companion(当前为 quant-buddy-view):QBS 自身需要升级时必须先只升级 QBS 并 reload;QBS 已最新时才可安装、更新或补齐当前 Agent 的 companion 注册。companion 失败属于旁路错误,不得阻断当前 QBS 数据业务;只要返回 reload_required=true,最终回复必须明确提示用户重新加载 Agent,禁止忽略该提示后声称活页能力已在当前会话生效。newSession 同时传 agent_model:填入当前 Agent 的真实模型标识(例如 gpt-4o / claude-sonnet-4 / gemini-2.5-pro);拿不准就留空,禁止猜测。MISSING_NEW_SESSION。若新问题未先 beginTurn,或显式 turn_id/user_query 与当前 Turn 漂移,客户端必须取消不安全的 Turn 关联、保留本轮真实 user_query 并继续业务工具;仅输出追踪诊断,禁止因 Turn 记录失败停止回答用户,也禁止把调用错误挂到其他 Session。默认走最窄路径;只在收到"明确不够用"的证据后,才扩大范围。
每次准备读文件、调工具、扩大读取范围前,回答三个问题:
任一回答含糊 → 不做这一步。
扩大范围的唯一合法触发:上一步工具明确返回了"缺数据 / 字段不存在 / 失败",且失败原因可以追溯。不允许用"为了更全面"、"为了更准确"、"为了避免遗漏"作为理由。
这条原则覆盖:要不要多读一个文档;readData 读哪个变量;要不要为某个字段调 confirmDataMulti;公式自己写还是查现成数据集;以及所有未来出现的同类决策。
工具层面落地:调用 confirmDataMulti / readData / runMultiFormulaBatchStream 或加载额外文档前,必须在心里完成工具清单自检;不要为执行清单而搜索、加载或读取 recipes/tool-call-checklist.md。无论该文件是否已在上下文中,只在心里完成以下三条最小自检即可(这三条已是清单的浓缩版,不需要再去查原文):
顶层原则管"要不要做",清单管"具体怎么做"。
本 SKILL.md 所在目录即为 skill 根目录(SKILL_ROOT),下文所有相对路径均以此为基准。
脚本路径以本轮已读取的 Skill 实际位置为准:若文档来自 /work/<本会话>/project/.claude/skills/quant-buddy-skill/SKILL.md,可直接使用同目录 scripts/call.py 的完整绝对路径;不要猜会话 ID。只有 cwd 已是 Skill 根目录才用 python3 scripts/call.py ...,cwd 是 project 根目录时不能照抄该相对路径。不要使用 .claude/skills/... 相对前缀,也不要用 /opt/... 安装目录替代会话副本。路径拒绝后只根据已确认的工作目录修正一次,不反复尝试 /opt、.claude/skills、cd 的排列,不探测或放宽权限。
宿主已将命令工作目录(cwd)固定为本 Skill 根目录时,禁止再次执行 cd,直接使用相对路径运行;仅在人工终端或宿主没有设置 cwd 时,才先切换到本目录。
SKILL_ROOT/
├── config.json ← API Key 配置(按需读取;非每题必读)
├── SKILL.md ← 本文件(入口 + 路由)
│
├── workflows/ ← 业务流程编排(路由目标)
│ ├── fast-snapshot.md Fast Path:最新时点行情/估值(≤1000资产,标量/CSV)
│ ├── fast-window.md Fast Path:最近N日序列/窗口统计(≤2500日)
│ ├── fast-report-period.md Fast Path:最近报告期财务(≤1000资产)
│ ├── quick-lookup.md 快速查数路由器 + 共享基础规则
│ ├── quick-snapshot.md 最新时点行情/估值快照(字段齐即停)
│ ├── quick-window.md 最近N日短窗序列/窗口统计
│ ├── quick-report-period.md 最近报告期财务指标
│ ├── period-return-compare.md 固定区间累计涨跌幅对比
│ ├── stock-profile.md 单股预计算指标画像
│ ├── external-fact-verification.md 上市/退市/更名/换代码及知识冲突核验
│ ├── composition-select.md 已物化维度组合选股(selectByComposition 快路径)
│ ├── global-rules-lite.md 精简全局规则(quick-window/period-return-compare 专用)
│ ├── quant-standard.md 选股/回测/因子/图表标准流程
│ ├── live-page-routing.md QBS→QBV 非阻塞活页路由、Handoff 与 Job 合同
│ ├── visual-page-fast-path.md 单资产标准历史字段同图的取数复用快路径
│ ├── event-study.md 事件研究(给定或可识别事件后的窗口表现)
│ ├── regime-segmentation.md 阈值区间/连续阶段识别与区间统计
│ └── render-kline.md K线图渲染与交付
│
├── recipes/ ← 公式模板 & 工具用法(被 workflow 引用)
│ ├── ma-crossover-backtest.md 均线金叉策略
│ ├── value-pe-strategy.md PE估值选股
│ ├── upload-custom-data.md 上传自有数据
│ ├── render-chart.md 渲染图表
│ ├── download-data.md 下载数据
│ └── industry-aggregation.md 行业聚合排名
│
├── references/ ← 参考文档
│ ├── environment.md 环境依赖
│ ├── troubleshooting.md 故障排查
│ └── ru-billing.md RU 计费
│
├── tools/ ← API 工具完整参数文档(默认不读;workflow 标注「必读」或报错时再查)
│ │ ⚠️ 下表列出所有可用工具的**实际调用名**,调用时必须使用此名,不得变体
│ ├── fast_query.md → 工具名 `fast_query` 快速合并查询(行情/估值/财务,≤1000资产,支持CSV)
│ ├── fast_query_minute_range.md → 历史单资产跨日1分钟CSV全列(日期/自然日offset)
│ ├── fast_query_minute_range_multi.md → 多资产/全市场1分钟、每日时段、交易日滚动及JSON/CSV
│ ├── fast_query_minute.md → 工具名 `fast_query_minute` 单资产当前盘中/最近完整日分钟 OHLCVA 序列
│ ├── confirm_data_multi.md → 工具名 `confirmDataMulti` 批量确认数据项存在性与维度(写公式前必查)
│ ├── run_multi_formula.md → 工具名 `runMultiFormulaBatchStream` 执行公式批次(选股/回测/因子计算)
│ ├── read_data.md → 工具名 `readData` 读取公式计算结果(需传 data_id,非 expression_id)
│ ├── render_kline.md → 工具名 `renderKLine` 渲染 K 线图(直接传 ticker,无需提前跑公式)
│ ├── stock_profile.md → 工具名 `stockProfile` 单股预计算指标画像(估值/财务/资金/波动/走势)
│ ├── select_by_composition.md → 工具名 `selectByComposition` 已物化维度组合选股/筛选(不走公式引擎)
│ ├── dimension_indicators.md → 工具名 `listDimensionIndicators` 按维度列出指标目录(细分+综合)
│ │ → 工具名 `getIndicatorFormulas` 按指标名取该指标的完整公式组
│ │ ⚠️ 二者非平台原生工具,走 `python scripts/call.py <工具名>`(硬规则 #2 许可路径)
│ ├── render_chart.md → 工具名 `renderChart` 渲染折线/柱状/面积图(需先有 data_id)
│ ├── get_card_formulas.md → 工具名 `getCardFormulas` 按卡片名拉取完整公式组(量化场景使用)
│ ├── scan_dimensions.md → 工具名 `scanDimensions` 九维度 IC 扫描(单股多维度预测力分析)
│ ├── search_similar_cases.md → 工具名 `searchSimilarCases` 向量检索相似案例(设计策略前的 fallback 查找)
│ ├── search_functions.md → 工具名 `searchFunctions` 检索平台函数名称与调用格式
│ ├── download_data.md → 工具名 `downloadData` 按 data_id 下载一维时序到 CSV/JSON
│ ├── upload_data.md → 工具名 `uploadData` 上传自有因子 CSV,上传后可在公式中引用
│ ├── refresh_snapshot_time.md → 工具名 `refreshSnapshotTime` 强制刷新分钟数据截止时间(盘中实时场景)
│ ├── resume_job.md → 工具名 `resumeJob` 续传 deferred 后台任务(配合 research_24h 使用)
│ └── formula_package.md → 脚本 `scripts/formula_package.py` 注册公式组为「任务包」→ 凭 package_id+signature 无 key 取数(对外只读/前端页面接入)
│
├── presets/ ← 已验证的常用数据(按需加载)
│ ├── cases_index.yaml 106 张案例卡片目录(量化标准场景必读,快速查数无需)
│ ├── assets.yaml 常用资产(99 行精选,可一次读完)
│ ├── assets_db/ 全量资产字典(按类型分文件,⚠️ 仅 grep 检索,禁止 read_file 整文件;不含指数成分股映射)
│ │ ├── stock_a.yaml A 股 5316 条(SH/SZ,含场内 ETF)
│ │ ├── stock_hk.yaml 港股 2858 条(HK 前缀;行情优先,财务以 fast_query 返回为准)
│ │ ├── stock_us.yaml 美股及境外ETF 1069 条(.N/.O/.A/.BAT;行情优先,财务以 fast_query 返回为准)
│ │ ├── index.yaml 指数 513 条
│ │ └── future.yaml 期货 239 条
│ ├── functions.yaml 常用函数(170 条)
│ ├── data_catalog.yaml 常用精选数据集(高频 index_title)
│ ├── index_info_catalog/ 系统支持数据名全量索引(2566 条,按业务分类分 YAML,grep 检索)
│ ├── dimensions.yaml 已物化指标候选的本地快照,用于 selectByComposition 的常见快速映射
│ │ ⚠️ 细分指标、快照未命中项和实时可选状态,用 `listDimensionIndicators` 在线确认;公式口径用 `getIndicatorFormulas`
│ ├── sectors.yaml 行业板块(742 条,10 个分类)
│ └── themes.yaml 题材板块
│
├── scripts/ ← 执行脚本
│ ├── call.py 工具统一入口(所有命令通过它调用)
│ ├── executor.py call.py 的底层(禁止直接调用)
│ ├── formula_package.py 公式任务包客户端(register/query/list/revoke/refresh,取数走 SSE)
│ ├── quant_api.py Python SDK(供其他脚本 import)
│ ├── auth/ 认证脚本
│ └── eval/ 评测脚本
│
└── output/ ← 输出目录(自动创建)
├── .session.<key>.json 当前 session task_id(按 QBS_SESSION_KEY 派生,多会话隔离)
├── ic_data/ IC 扫描结果
└── *.png / *.csv 图表和数据文件
全局 429 处理(所有路径均适用):
已有文件转活页先执行上方静态托管优先例外,不进入下表 QBS leaf;首次静态交付后的数据增强才按本节加载查询规则。
无论匹配到哪个 leaf workflow,执行顺序固定为:
① read_skill_file(global-rules 版本,见下表) → ② read_skill_file(leaf workflow) → ③ 执行
步骤 ① 全局规则文件选择(按目标 leaf workflow 确定):
先识别用户意图,确定目标 leaf workflow;然后按上方执行顺序加载:
上传、下载、画图不是独立场景——它们是 workflow 内的子步骤,workflow 文档会在需要时指引你读对应的
recipes/。
以下规则在触发词匹配之前检查,命中即强制改道,不得被触发词覆盖:
判断口诀:
period-return-compare(固定区间收益比较)event-study(因果窗口)event-study(阈值触发模式)regime-segmentation(连续阶段统计)若用户请求满足以下任一模式,应优先判定为【快速查数任务】,按以下路由直接跳转,不得先进入其他 workflow:
Fast Path 条件(同时满足以下 2 点才可走 Fast Path;否则走完整链路):
tools/fast_query.md),不涉及自定义公式/选股/排名资产数量不再限制 Fast Path 路由(服务端支持 ≤1000 个资产)。超过 500 数据点时服务端自动返回 CSV 格式(OSS 下载链接),详见
tools/fast_query.md限流与 CSV 模式段落。
快速查数路由(按优先级依次判断,首个匹配即停):
用户明确要求一个资产的 2~4 个标准历史字段放在同一张图中,且未明确只要 PNG → 只读 workflows/visual-page-fast-path.md;这是页面主图快路径,不得继续读取 quant-standard.md / render-kline.md。
0a. 用户明确要求申万一级行业最近 N 个交易日涨跌幅排名图/柱状图/可视化,且未明确只要 PNG → 只读 workflows/industry-ranking-fast.md;不得读取 global-rules.md、quant-standard.md 或行业 recipe,不得调用 renderChart。
分钟覆盖前置检查:先确认市场/资产类型并按 分钟支持范围 判断。A股/美股股票起于2026-05-13,国内期货起于2005-01-04,港股股票起于2026-05-20,国内指数起于2026-08-13;境外期货主力连续已支持,分钟起点按ticker区分(见分钟覆盖参考);美国/香港指数及香港期货暂不支持。历史窗口早于边界必须先提示:全窗口越界不查;部分覆盖明确缺失范围,不静默改日期或宣称完整覆盖。此限制不套用于日频行情。
用户要多资产/全市场分钟、每日分钟窗口、最近N个交易日分钟或当前交易日规则 → 先读 tools/fast_query_minute_range_multi.md,用 fast_query_minute_range_multi。其余单资产历史/跨日分钟序列或分钟CSV → tools/fast_query_minute_range.md;只支持历史日期,完整返回所有列;窗口/offset互斥,不得偷换成日频或当日分钟。用户要求30分钟K线时,先取原始1分钟数据,再按该工具文档的受控聚合步骤生成派生30分钟数据,并同时保留原始区间、时区和来源间隔。
用户明确要单资产完整分钟/分时/逐分钟序列或分钟 OHLCVA,且未指定历史日期、日期区间、分钟聚合或多个资产 → 先按资产库规则确认唯一资产,调用 fast_query_minute;按索引配对返回的 dates[] 与 fields.<name>[],保留 data_scope/trade_date/timezone 语义,成功即停。只问最新标量仍走 snapshot;历史/区间改走 fast_query_minute_range;多资产不能塞进任一单资产工具。连续期货只按所选 trade_date 解读 contract_info,不将 inferred 说成已实时核验;附加 warnings 不影响成功行情。
整句为一个资产名称/简称/代码,或简单单股综合分析(如“分析一下贵州茅台”)时,先执行 live_page_routing.py route;命中 single_a_stock_fast 则读取 QBV guides/answer-first.md,QBS 验证首答后同轮 new_asset_page,不能只输出画像就结束。其他开放式单股综合指标概览(如“分析一下XX个股”“个股画像”“指标概览”),且不是只问单字段/明确窗口/IC 预测力 → workflows/global-rules.md → workflows/stock-profile.md
时间锚点是"最近 N 日窗口/序列",或用户明确给出起止日期要求返回区间序列(如"从X日到X日每日的…走势/序列/数据"),或用户只说"最近走势/看走势"但未明确要图片/K线 → Fast Path 条件满足时读 workflows/fast-window.md,不满足则 workflows/global-rules-lite.md → workflows/quick-window.md;未给 N 时默认按最近 20 个交易日
时间锚点是"最近报告期"且字段属于财务类 → Fast Path 条件满足时读 workflows/fast-report-period.md,不满足则 workflows/global-rules.md → workflows/quick-report-period.md
用户明确要“K线 / K 线 / 蜡烛图 / OHLC / 开高低收”:有活页意图时加载 workflows/kline-page-fast-path.md;只有明确只要PNG/图片时才加载 workflows/render-kline.md
其余(明确是最近完成交易日或当日的行情/估值/多资产对比,且不含 排名/筛选/全市场 语义)→ Fast Path 条件满足时读 ,不满足则 →
上述路由不需要先读
workflows/quick-lookup.md。
以下 4 条规则从 global-rules.md 摘录,优先级最高,对所有场景生效:
_working/ 路径、checkpoint 名称、workflow 文件名。查到即答,不展示内部过程。ASSET_NOT_FOUND 时,必须读 external-fact-verification.md。ASSET_NOT_FOUND 只表示当前接口未识别资产,不得推导为公司未上市。触发词参考:
stock-profilequick-snapshotquick-windowquick-report-period禁止:
renderKLine;先读 kline-page-fast-path.md 并用 fast_query(window) 取得OHLCV。只有用户明确只要PNG/图片时才调用 renderKLinerunMultiFormulaBatchStream / renderKLine / scanDimensions / stockProfile / 输出“无法联网”或“无法获取实时数据”presets/assets_db/future.yaml 时,静态输出“平台不支持期货/期权”或“期货无法查询”;应先按行情/窗口序列工具链尝试,失败后只按工具返回说明当前品种或字段暂不可得description、samples、预览行、截断大表作为名单题的完整结果直接收尾(必须提取完整名单或明确声明不完整)leaf workflow 最终回答合同优先:leaf workflow 中的"最终回答合同"优先负责收紧该场景的输出格式;若 leaf workflow 已满足停止条件,必须直接按该合同输出,不得再解释内部过程。
规则层级(从高到低):
冲突解决:
tools/read_data.md 的场景表))优先于 global-rules 的一般规则quick-lookup.md 的定位:
全局合同详见
workflows/global-rules.md,进入任何 leaf workflow 时自动生效。 leaf workflow 可在其内部添加更严格的约束,但不得豁免或放宽 global-rules 中的规则。
港股 / 美股数据范围限制:
- 行情价格类(收盘价、开盘价、最高价、最低价、涨跌幅、成交量、成交额):A / HK / US 均支持。
- 所属行业基础信息:仅 A 股股票支持
所属行业,使用fast_query(snapshot/value);资产须为type=stock且market_id=1/2。返回申万一级swl1、申万二级swl2和概念列表jqc;港股、美股、指数及其他资产暂不支持。- 估值类:
- A/US/HK:
PE/PE_TTM/PB/PS_TTM/股息率/PCF/总市值(日频,服务端按字段自动映射;PB 不带 TTM)- 仅 A 股:
流通市值/换手率- PE(静态):A 股用静态 PE,港美股自动映射到 TTM 版
- 历史兼容入口:港美股
PE_单季/PB_单季/PS_单季/股息率_单季实际映射到日频估值,不是季频数据;新调用使用PE_TTM/PB/PS_TTM/股息率- 财务类(营业收入/净利润/归母净利润等):A / HK / US 均支持(通过
fast_query接口);ROE 仅 A 股。- 资金流向 / 南北向持股类(
fast_querysnapshot/window,非report):
- 仅 A 股:
主力资金净额/主力资金净占比、超大单/大单/中单/小单 净额·净占比(主力 = 超大单 + 大单)- 仅 A 股:
北向持股比例(陆股通持股比例)/北向持股市值(2024-08 后季频/稀疏)- 仅港股:
南向持股比例/南向持股市值(日频)- 走动态解析(非白名单,需用全称):北向/南向「十大活跃股成交额」
- 不支持:北向/南向「资金成交额·成交量·净买入」(市场级一维序列,无个股维度)——应走
confirmDataMulti+readData,而非fast_query。- 商品期货类(
fast_querysnapshot/window,仅 A 股期货品种,单位按品种):
- 期货行情
收盘价/开盘价/最高价/最低价:单位按品种(白银元/千克、螺纹元/吨、黄金元/克…)现货价格(基差,多为元/吨)、商品库存/库存按发布日(单位按品种推测,带STOCK_UNIT_INFERRED警告)- 用期货 ticker(如
RB.SHF)查询;单位按品种发散时fields_meta[字段].unit_per_asset=true,单位下沉到每资产值({v, unit}),读值优先看资产内联unit
除了「数据集」(全市场每日收盘价 这类原始字段),平台还维护一套已经算好的指标库,是另一套东西,别混:
维度 dimension ──包含──▶ 指标 indicator ──定义于──▶ 公式组 formulas
17 个(趋势结构、动量与反转、 163 个 每个指标一组,
资金流向、盈利能力、异动监控…) 依赖在前、目标在最后
细分 = 单一口径基础指标(如「20日高点接近突破」);综合 = 该维度的维度分,由维度内细分指标聚合而成(如「A股动量与反转」)。另有正交的 output_type:score 连续分 / screen 0-1 布尔。selectByComposition 不以 细分 / 综合 作为准入条件:两个分类均可用,但必须已物化、当前可选、支持目标市场且具有已知快照日期。不同有效快照允许组合,结果必须按 date_alignment 披露;请求位置由 output_type 决定:score 用于排名/阈值,screen 用于交集筛选。name(20日高点接近突破,目录里的短名)和 index_title(通用_20日高点接近突破得分,公式里的变量名),两者从不相同;再加稳定键 indicator_id,取公式时三种都能用。走哪条路:
确认资产失败(熔断规则)详见
workflows/quick-lookup.md§ Step 1。
环境依赖(Python版本、Playwright、API Key)→
references/environment.md故障排查 →references/troubleshooting.mdRU 计费 →references/ru-billing.md
凭据存储说明:本 skill 的 quant-buddy API Key 默认存放在 skill 目录下的
config.json的api_key字段,日常以此为权威来源;QUANT_BUDDY_API_KEY环境变量仅作最低优先级兜底(只在 config.json 也没有值时才生效,不是常规覆盖手段——config.json 已有默认 key 时设置它不会有任何效果)。仅可选的BOCHA_API_KEY(通用外部事实搜索,包括事件研究和资产状态核验)走环境变量。
Playground 场景覆盖:若本轮用户消息里含独立一行
api_key=<value>(这是 Playground 前端自动附带的、当前登录用户本人的凭据,不要转述/回显给用户),调用本 skill 任意工具时在其 JSON 参数里追加"api_key": "<value>"字段——这会临时覆盖 config.json,仅本次调用生效、不落盘、优先级最高。命中这种情况时直接用该值查数即可,不需要走下面"config.json 为空则停止查数"的新用户引导流程。手上是一份现成的@file参数、不方便现改这份文件塞api_key字段时,用环境变量QBS_API_KEY效果等价(同一优先级,不要跟QUANT_BUDDY_API_KEY混用)。
仅在以下情形下,才需要显式读取 config.json 检查 api_key:
对已命中 leaf workflow 的简单查数题(quick-snapshot / quick-window / quick-report-period / kline-page-fast-path / render-kline):
config.json原则:认证检查服务于执行,不应成为简单题的固定额外步骤。
若 api_key 非空 → 正常继续
若 api_key 为空 → 立即停止,禁止继续查数,输出以下新用户引导消息(原样输出,不得删减):
⚠️ 尚未配置 API Key,当前无法查询数据。
前往 https://www.quantbuddy.cn/login 登录/注册并获取 API Key,然后直接发给我:
帮我配置 APIkey:sk-xxxxxxxx
当用户消息中包含 sk- 开头的字符串时:
sk- 开头的完整 Key 字符串config.json 的 api_key 字段(用 replace_string_in_file 直接写入)newSession(以原始用户问题作为 user_query)新建 session,再立即重新执行该查询并给出数据结论,不需要用户再次发起。运行时 401/402 → 立即停止,提示用户 API Key 无效/过期/配额耗尽,请重新前往官网获取新的 Key 并重新配置。
所有工具通过 scripts/call.py 调用。call.py 会同时将结果打印到 stdout 和写入临时文件。
python scripts/call.py <工具名> '{"key":"value"}'
结果直接从 stdout 获取。若 stdout 被截断,可回读 /tmp/gzq_out.txt。
也可通过环境变量传参(适用于参数含特殊字符的场景):
GZQ_PARAMS='<JSON>' python scripts/call.py <工具名>
简言之:presets 是数据快照,recipes 是完整教程,tools 是参数字典。
data_catalog.yaml只维护高频精选字段;index_info_catalog/*.yaml承载全量系统数据名。高频且确认常用的数据名,再人工补进data_catalog.yaml。index_info_catalog/按业务分类保存系统支持的数据名。公式使用精确的index_title;不要推断或向用户展示内部来源。目录由仓库外部维护流程生成,不要手工修改记录。
当用户要求更新本 skill(发送 zip 压缩包)时,必须严格遵守以下规则:
⚠️ 备份目录禁止放在 skills/ 目录下。 运行时更新器会把受管理备份写入:
<workbuddy-root>/backups/skills/quant-buddy-skill/
每个备份目录以时间和被替换版本命名,并带有 backup-metadata.json(含 slug、旧版本、创建时间和来源)。更新器只在新包校验、原子替换和活动目录健康检查都成功后,才迁移旧根目录备份并清理历史:最多保留 3 个、仅保留 30 天内的已识别备份。
--backup-root <dir> 可以显式指定备份根目录;不会改写为默认位置。skill_slug=quant-buddy-skill 的目录;未知人工目录、活动目录、lock、staging、trash 和 skills/ 下任何目录都不会被清理。<workbuddy-root>/quant-buddy-skill-backup-* 仅在新版本健康检查成功后、且 _skillhub_meta.json / _meta.json 明确写有相同 slug 时迁移;更新失败时绝不删除旧备份。# 解压到临时目录再拷贝(避免嵌套)
TMPDIR=$(mktemp -d)
unzip -o <压缩包路径> -d "$TMPDIR"
# 如果解压出嵌套目录 quant-buddy-skill/,取内层
if [ -d "$TMPDIR/quant-buddy-skill" ]; then
cp -rf "$TMPDIR/quant-buddy-skill/"* ~/.openclaw/workspace/skills/quant-buddy-skill/
else
cp -rf "$TMPDIR/"* ~/.openclaw/workspace/skills/quant-buddy-skill/
fi
rm -rf "$TMPDIR"
~/.openclaw/workspace/skills/ 下只有 quant-buddy-skill/ 一个与本 skill 相关的目录SKILL.md 确认版本号config.json 中已有的 api_key(若用户之前已认证过)|
---name: quant-buddy-skilldescription: |---# skills/quant-buddy-skill/SKILL.mdFAQ
Download skills/quant-buddy-skill/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/pseudo-longinus/quant-buddy-skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.
run_skill_scriptqbs_bridge.pyfast_query 返回 mode:"csv" + csv_url(数据点 > 500 的正常交付)时,调用 python scripts/fetch_fastquery_csv.py "<csv_url>" 下载并解析该 csv 属于许可路径——这是消费工具返回的 OSS 产物(平台无等价原生解析工具),不算"包装原生工具"。历史分钟长表使用 scripts/fetch_minute_range_csv.py @output/minute-manifest.json --output output/minute-data.json,不能套用日频宽表解析器。但仍禁止用裸 curl / 自写临时脚本替代该脚本。grep presets/assets_db/{类型}.yaml 搜索本地资产库,禁止整文件读取;命中多条先澄清,未命中再交给服务端兜底解析。工具失败熔断:同类错误不得重复
RESUME_CONTEXT_MISMATCH 可按工具返回的唯一 resume_params 修正一次;UNIVERSE_SCOPE_MISMATCH 可在核对目录后修正为精确行业一次。这两类尚未提交网络请求,不得用这个例外重复真实查询错误。runMultiFormulaBatchStream / resumeJob 只有最终 completed 且全部结果成功时才返回 validation_receipt_file;failed、部分失败、deferred 均不生成收据。QBV 编排必须以该收据作为进度完成证据。长结果可传 output_mode:"summary":completed 保留 data_id/expression_id/status;deferred 额外完整保留 status/task_id/trace_id/job_id/stream_url/_deferred。deferred 缺 task_id/trace_id 时返回 DEFERRED_CONTINUATION_MISSING,禁止重提原批次。任何 workflow 失败退出时必须输出受控失败答复:禁止以空白或纯过程日志结束对话。失败答复必须包含:
先读 workflow 再操作:按下方「场景路由」表加载对应 workflow,不要自行猜测参数格式。
配置/认证错误立即停止,不得在普通查数流程中转为认证收集:
api_key 为空 消息 / code: 1):立即停止查数,输出新用户引导消息(格式见「前置条件」章节模板),禁止继续执行查数;等待用户粘贴 Key 后再执行配置向导。最终答案首句必须是数据结论:回答用户时,第一句话必须直接给出数据结论(如资产名+数值、表格、或"符合条件的共N只"),绝对禁止以"已成功获取""数据已获取""根据返回结果""让我来"等过程性陈述开头。违反此规则 = 必须删除过程话术后重新输出。
code:0 / success:true 后,最终答复必须把 data.results 等业务字段转写成人类可读结论(一句话、短表格或名单)。除非用户明确要求"给我原始 JSON / 调试输出",否则不得把完整工具响应原样发给用户。code、success、task_id、_quota、skill_latest_version、skill_update_available、skill_update_enforced、skill_self_update、auto_upgrade*、version_check 等运行态/升级字段;这些字段只供 Agent 判断流程,不是给普通用户看的答案内容。data 已成功返回,即使响应体带版本心跳,也必须先回答用户问题;只有工具明确返回业务失败或 SKILL_VERSION_MISMATCH 时才进入自愈/排错流程。用户条件冻结,不得改写:执行前必须逐字核对用户原始条件,以下改写行为均属违规(一旦发现必须回退并重新确认):
>0.03)任务含糊时先反问,禁止猜测开干:若用户的指令有 2 种以上合理解读(如"批量确认X"不清楚是确认指数本身还是全部成分股、"分析一下Y"不清楚要哪个维度),第一步必须向用户提问澄清,不得凭推测选择一种解读自行执行。反问应简洁列出各种可能(例:"您的意思是 ① … 还是 ② …?"),等用户确认后再继续。唯一例外:用户语义明确无歧义(如"给我贵州茅台今日收盘价"),无需反问。
⚠️ 模糊词处理规则(先判断是否真歧义,再决定反问还是默认口径直行):
下列词在量化语义中存在多种定义,必须正确处理:
判定流程(按顺序匹配,命中即停):
综合分析请求 → 用默认口径直行,禁止反问阻塞。
判定:用户在一句话里列出 ≥2 个分析维度(如"基本面 + 技术指标 + 趋势"、"估值 + 财务 + 走势"),或明确说"全面分析 / 综合看一下 / 给一份报告"。
做法:直接走 stockProfile(综合画像)+ 常规技术指标 + 默认趋势口径,报告首句告知用户使用的口径(例:"本次按以下默认口径输出:基本面=综合画像(估值+财务+资金流+波动率),技术=MACD/KDJ/RSI/布林带,趋势=MA20/MA60 排列方向。如需调整口径请告诉我。")。
孤立的单点定义性请求 → 必须反问。 判定:触发词单独出现,且其定义直接决定结论数值(如"贵州茅台支撑位是多少"、"宁德时代趋势怎么样",无任何其他维度上下文)。 做法:反问 ① 口径定义(如"支撑位"=近N日最低/布林下轨/均线密集区);② 时间窗口;③ 输出格式。
触发词只是修饰语 → 直行。 判定:用户主体诉求清晰,触发词只是顺带描述(如"找最近基本面改善的股票"主体是筛选,"基本面改善"已隐含"营收/净利同比上升"等可执行口径)。 做法:用最常见的可执行口径执行,并在结果中标注口径。
实测教训(T-036):用户问"贵州茅台支撑位",模型擅自用"60日最低价附近"作为定义直接执行——这是孤立单点请求,应走流程 2 反问。 反例(不要再犯):用户问"分析东方财富的基本面、技术指标、趋势预测",模型反问 4 个问题阻塞——这是综合分析请求,应走流程 1 默认口径直行。
工具返回 SKILL_VERSION_MISMATCH 时必须自愈,不得继续执行原任务:当任何工具调用的输出中出现 "error": "SKILL_VERSION_MISMATCH" 时,说明当前对话上下文中的工具签名/参数格式已过时。此时必须执行以下自愈流程(每步不得省略):
立即停止当前任务,不得再调用任何平台工具;
调用 newSession(新建 session,获取新 task_id);
强制重读 SKILL.md(本文件)+ 当前场景对应的 workflow 文档 + 涉及的 tools/*.md;
以新读取的工具签名和参数格式重新执行用户原始任务;
禁止询问用户"是否继续"或解释版本升级过程——直接静默完成自愈并返回结果。
CHANGELOG / skill-changelog 仅作为审计,不作为规则源:CHANGELOG.md、skill-changelog/** 是按时间叠加的变更记录,包含已被后续版本反转或废弃的旧口径。任何「执行顺序、字段名、协议块语义、工具签名、参数格式」相关的判断,必须以 SKILL.md + workflows/** + tools/** + references/troubleshooting.md 为唯一权威;CHANGELOG 描述与上述文件冲突时,以上述文件为准。CHANGELOG 仅可用于:① 排查问题时回看「哪一版动过什么」;② 升级成功后做 5 条以内的版本上下文摘要。禁止:把 CHANGELOG 某条历史叙述当作当前执行规则、依据 CHANGELOG 推断现行参数格式、或在 CHANGELOG 与 SKILL.md 冲突时偏向 CHANGELOG。
判断工具成败看返回 body 的 code/success,不看 HTTP 状态码:HTTP 200 不代表业务成功——body 里出现 "code": -1 / "success": false 即为业务错误,必须按失败处理(读 error/message 再决定重试/改参/走排查表),禁止「HTTP 通了就当成功」继续往下走。另:call.py 返回 "error": "INVALID_TOOL_NAME" 表示工具名写错或缺失(工具名必须排在命令最前、且为已注册工具名),属可立即修正的本地错误。详见 references/troubleshooting.md 顶部「成败判定通则」。
先答后建页:每日/定期复盘、行情监控、画线/画图、执行回测、看 K 线等操作请求,以及已登记的稳定榜单(低 PE + 高 ROE + 选股/排名 + TopN)必须实际执行 scripts/live_page_routing.py route,不能把普通 TopN 全部升级为活页。上述操作本身构成活页意图,不要求用户另说“网页”;纯概念解释不建页。上下文中的真实建页意图可传 --page-requested,明确不要网页/暂不发布仍优先;不要画图只约束表现形式,不能否决表格型活页。按 先答后建页 执行:QBS 查询验证后先发完整非终止业务答案,再准备 Capsule/Handoff/Job,默认 same_turn 进入 QBV;可靠内部委派是可选分支,不得重复执行。prepare-validated-page 接受 answer_structure;未传时按首答顺序的 validated_roles 生成保守表格结构。**全量计算规模与页面展示规模分离:排名未指定数量时默认 Top20,页面只渲染 Top20;Formula Package/Data Grant 负责服务端缓存和动态取数,不能因为参与计算的股票多就把页面降级成静态快照。只有用户明确要求固定快照,或动态数据路由经过验证确实不可用时,才使用 validated_snapshot,并在回复中如实说明不会自动更新。**成功后按 next_action 继续,不重复 handoff/prepare。prepare 不是图表或页面完成,QBV 不可访问时必须用本 Skill 的 update 写回返回的 on_unavailable 失败字段,不得留 queued 或假称后台执行。路由/页面失败不撤销正常首答;无中途可见消息能力时如实记录限制。页面路由、权限、同页更新和公开验收仍由 QBV 负责。单资产多标准字段同图、近N日行业排名分别沿专用快路径,快路径也必须先答后准备页面。
QBS→QBV 只复用本轮已经算完的部分,不把 QBV 改成 QBS 专用渲染器:create|existing_page 在 Handoff 前优先运行 scripts/qbv_computation_capsule.py build @capsule-input.json,生成 qbs_computation_capsule_v1。胶囊必须同时包含用户核心问题/主图意图、资产规范化结果、可复现查询或公式合同及 fingerprint、结果快照或 artifact SHA256、字段映射、结论与验证收据;禁止只交 PNG 或一句总结。 同一业务 role 对应多个已物化结果时可传 data_ids;构建器按原顺序展开为 role__01、role__02…,保留原始 ID 字符串并同步 required_roles,禁止 Agent 手工改写或复制 ID。QBV 的 thin adapter 判定 covered 时不得重复识别资产或重算相同 role,partial 时只补 missing_roles,unusable 时无损回退原 QBV→QBS bridge;direct/fork/unmatched、ownership、构建、运行时注册、发布和验收仍完全归 QBV。用户直接使用 QBV 的量化建页同样先答;无胶囊时保留原查询能力,已有文件/解读/展示维护例外不变。
已跑通的公式执行合同必须原样交给 QBV,禁止二次改写:runMultiFormulaBatchStream 成功后,原始执行以 Validation Receipt 的 execution_contract 为证,安全页面读取另用 qbs_formula_runtime_contract_v1(可能缺省),不可混同,保留 formulas 的条数、顺序、完整指标名、引号、begin_date、include_description、use_minute_data、force_reusable_array、reads 和 fingerprint。prepare-validated-page 必须把该合同写入 computation capsule;不得把平台已确认的 "A股市盈率(PE, TTM)〔估值数据〕" / "A股净资产收益率ROE" 缩写成 PE(TTM) / ROE 后交给 QBV,也不得把多条已验证公式合并成一条新公式。显式合同与 Receipt 不一致、fingerprint 不一致或输出左值不完整时必须失败关闭,不得猜测修复。准备交接 JSON 时,Receipt 已含原始公式就不要在 validated_roles[].formula 手抄第二份,也不要在每个 role 重复同一 Receipt;优先在顶层 validation_receipts 传一次 Receipt 对象或 Receipt 文件路径字符串,也可以让 prepare-validated-page 按同任务全部 data_id 自动发现,避免引号转义失败和无效重试。
| 申万一级行业近N日涨跌幅排名图 |
| 申万一级行业/行业板块 + 最近N日/最近一个月 + 涨跌幅 + 排名图/柱状图/可视化 |
只读 industry-ranking-fast.md;固定一条行业聚合公式,只读 indexinfo_id,直接准备已物化 QBV Job;禁止进入 global-rules.md、quant-standard.md、行业 recipe 和 renderChart |
| K线活页(可持续打开) | 明确出现 K线/K 线/蜡烛图/OHLC/开高低收,且没有明确只要图片 | 只读 kline-page-fast-path.md;QBS fast_query(window) 验证 OHLCV 后先答,再交给 QBV 的 candlestick 运行时面板;禁止调用图片型 renderKLine |
| K线图片(明确只要PNG/图片) | 用户明确不要网页、只要图片 artifact | global-rules.md → render-kline.md;此时才允许 renderKLine |
| 固定区间累计涨跌幅 | 从A到B、某年某月至某年某月、区间收益、累计涨跌幅、区间表现、多资产区间对比 | global-rules-lite.md → period-return-compare.md |
| 数据下载 / 导出本地 CSV | 下载成CSV、导出到本地、保存到本地、下载历史数据 | global-rules.md → recipes/download-data.md;单资产单字段时序优先 runMultiFormulaBatchStream → downloadData → write_skill_file,禁止 Bash 兜底 |
| 已物化指标选股 / 维度分或细分指标 TopN / 推荐股票 | 分数最高、综合分最高、维度分,或由已物化细分 score/screen 指标组成的推荐/选出/筛选 TopN | global-rules.md → composition-select.md(newSession → 本地快照匹配或在线目录确认 → selectByComposition) |
| 高频稳定因子榜单:低 PE + 高 ROE TopN | 同时出现低PE/低市盈率、高ROE/高净资产收益率、选股/筛选/排名、TopN/前N;即使没说图表或活页 | global-rules.md → quant-standard.md 的“高频默认口径”;验证 TopN 后必须实际 route,create 时用三个已物化 data_id 一次 prepare-validated-page,QBS 先答、QBV 同轮完成后补链接;明确不要网页则 none,只要表格且无其他建页意图也保持 none |
| 维度指标库查询 / 指标口径与公式 | 平台有哪些维度、XX 维度下有哪些指标、XX 指标怎么算的/口径是什么/公式是什么、想按现成指标改口径 | tools/dimension_indicators.md(用 scripts/call.py 调 listDimensionIndicators → getIndicatorFormulas,非平台原生工具;要拿改过的公式跑数再转 quant-standard.md) |
| 量化选股 / 回测 / 因子 / 图表 / 上传下载 | 选股、回测、均线、PE选股、因子、净值、上传CSV、下载数据、画图、多个指标放进同一张图…;或目录无匹配维度、需要临时构造指标/历史曲线/自定义公式 | global-rules.md → quant-standard.md;执行回测、监控、画线或任何图表 artifact 在首答前必须实际运行 live_page_routing.py route,命中 create 后非阻塞交接 QBV |
| 直接运行用户给定的公式链文件 | 「运行/跑一遍/执行这个文件里的全部公式」「公式链文件」「formula chain」「按这个 md/json 跑」 | global-rules.md → run-formula-chain.md |
| 事件研究 | 复盘、历次、涨价、降息、加息、事件窗口、随后表现、超预期、不及预期、政策后表现…(给定事件或需先识别事件日) | global-rules.md → event-study.md |
| 阈值区间统计 / 连续阶段 | 历次、每次、平均、回撤超过、从高点下跌超过、熊市区间、连续阶段、regime | global-rules.md → regime-segmentation.md |
| 每日复盘 / 持续监控 / 每天看行业股 | 每日或定期复盘、每天看、监控/盯盘、刷新看板、做个能直接打开的页面 | global-rules.md → quant-standard.md → answer-first.md;先原生查询和完整业务首答,再交 QBV;不进入先注册包的旧流程 |
| 明确开发接口 / 管理公式任务包 | 用户明确要求注册公式包、package_id、签名取数、对外只读接口或第三方接口接入 | tools/formula_package.md + recipes/formula-package.md;仅接口管理请求,普通研究看板走上一行;注册前仍须验证公式和运行时频率 |
workflows/fast-snapshot.mdworkflows/global-rules.mdworkflows/quick-snapshot.md说明:含"今天/今日/当日/当前/现在/实时/盘中"但仅查单资产行情字段,属于日内刷新场景,
fast_query snapshot已自动启用盘中刷新(等效use_minute_data: true),应直接走 Fast Path;上方"路由硬排除"已拦截"今天 + 全市场/板块 + 排名/筛选",此处无需重复排除。