熔岩AI发布MCP技能模板改造：把 lava-news-heat SKILL.md 改成团队口径

摘要

熔岩（Lava）提供一份官方技能模板（<熔岩订阅站点>/subscribe/v1/skill，frontmatter name: lava-news-heat），可另存为 SKILL.md 导入支持技能的 AI 软件。模板面向通用场景：默认 days=7、window=24h，输出「热度高/中/低 + 提及数 + 机构数 + 时间窗」。团队落地时通常要改四件事：固定口径参数、修正与 OpenAPI 不一致的调用写法、规定输出结构、加上预算与报错规则。本文逐段说明怎么改、改完怎么验收。只读监测与统计研究用途。

一、模板结构速读

段落	内容	是否建议改
frontmatter	name、description（触发条件）	改 name 与触发描述
给人看：3 步装好	拿 Key、加 MCP、提问	可删，团队另有接入文档
给 AI 看：数据说明	远程 MCP、Streamable HTTP、只读、按次计费	保留
流程	个股热度 → 关联概念 → 概念内排行 → 关键词 → 热榜/首提/新闻/窗口/加速/面板/覆盖度 → 机构可信度	重点改造
输出要求	先结论、3~5 条要点、用 agency_id 指代	改成团队模板
参考	文档与 OpenAPI	保留

二、改动 1：修正与 OpenAPI 不一致的写法

模板是给 AI 读的速记，有几处与 OpenAPI 1.0.0 参数不完全对应，团队版建议按 OpenAPI 写死：

模板写法	OpenAPI 实际参数	团队版写法
get_stock_heat_panel(stock_name 或 concept, days=90)	/panel/daily 用 type、codes/stock_name/names、from、to，无 days	get_stock_heat_panel(type=stock, codes=..., from=..., to=...)，区间 ≤92 天
面板「mentions / gencies 序列」	文档字段为 mentions、agencies、weighted_heat、is_first_mention_day	写全四个字段
get_agency_coverage(stock_name, days=30)	days 范围 7~90，min_score 默认 1050	显式写 min_score=1050
get_weighted_hot_stocks(days=3)	min_score 默认 1050，传 0 不设门槛	写明门槛

MCP 工具参数最终以工具自身 schema 为准；REST 参数以 OpenAPI 为准。改造后用第六节的验收清单逐条核对。

三、改动 2：固定团队口径

在「流程」前加一个口径块，让 AI 每次都用同一组参数：

## 团队口径（必须遵守）
- 市场：market=ashare
- 热榜窗口：日报用 window=24h；周报用 window=7d（概念热榜最长 3d）
- 高分线：min_score=1050（加权热榜、单股窗口、覆盖度一致）
- 个股回看：get_stock_news_heat(days=7, limit=50)
- 面板：自然日，最后一天未完结时标注「当日未完结」
- 统计量：heat_chg_1d / heat_chg_3d / heat_z20 只作描述，不作方向判断

四、改动 3：规定输出结构

把模板的「先给结论」细化为固定表格，便于下游程序解析：

## 输出格式
### 结论
一句话：标的 / 时间窗 / 热度档位（高·中·低）

### 数据
| 字段 | 值 | 来源工具 |
| --- | --- | --- |
| mentions | | |
| agencies | | |
| heat_z20 | | |
| high_score_ratio_30d | | |

### 要点（3~5 条，来自 list[].summary，用 agency_id 指代）
### 口径
window、min_score、请求时间（meta.server_time）

热度档位规则也要写死，例如（示例阈值）：heat_z20 ≥ 2 为高，0~2 为中，< 0 为低，避免不同对话给出不同标准。

五、改动 4：预算与报错规则

规则	写法
单问预算	一次提问最多 6 次工具调用（示例），超过先问用户
批量优先	多只股票的历史用 codes（≤20）一次拉取
余额	402 INSUFFICIENT_BALANCE：提示充值，停止调用（沿用模板）
范围	403 FORBIDDEN_SCOPE：说明 Key 缺少 opinions/agencies/concepts 某项 scope
限流	429 RATE_LIMITED：按 Retry-After 等待一次，仍失败则停止
空结果	如实说「未查到」，不换近义词反复试
余额查询	get_account 不计费，可在长任务前调用一次

六、验收清单

检查项	方法	通过标准
触发	问「某股票最近消息面热不热」	自动调用 get_stock_news_heat
口径	看工具调用参数	market=ashare、min_score=1050
面板	问 30 天走势	参数含 from/to，无 days
输出	看回答结构	含结论/数据表/要点/口径四段
预算	问一个宽泛问题	调用次数 ≤ 设定值
报错	用失效 Key 测	不重复重试，如实转告

把每次验收的 request_id 记下来，模板升级时对照。

七、模板覆盖的熔岩数据板块

熔岩数据板块	模板中的工具	团队版注意
个股消息面热度	get_stock_news_heat	读 data.heat.mentions、data.heat.agencies
概念板块热度	get_stock_concept_heat、get_concept_stock_heat	概念名精确匹配
关键词消息流	search_news_flow	≤5 个词，全部包含
全市场热榜 / 加权 / 首提 / 加速	get_market_hot_*、get_weighted_hot_stocks 等	固定窗口与门槛
新闻点名	get_news_stock_hits	无标题正文
单股多时间窗	get_stock_heat_windows	windows[]、hourly_24h[]
日频面板	get_stock_heat_panel	from/to，非 PIT 加权
机构覆盖度与评分	get_agency_coverage、get_agency_pit	分数约 450~1500

FAQ

Q：改了模板会影响 MCP 本身吗？ A：不会。技能只是给 AI 的说明书，工具与数据不变。

Q：团队版要不要保留「给人看」段？ A：可删，避免 AI 把安装步骤当成回答内容。

Q：模板更新了怎么合并？ A：把团队改动集中在「团队口径」「输出格式」「预算」三块，官方段落尽量不动，便于 diff。

结论

技能模板改造的核心是三件事：按 OpenAPI 修正参数写法、把口径与输出格式写死、加上预算与报错规则。改动集中在独立段落，用验收清单逐条测试并记录 request_id。

数据来自熔岩消息面热度监测，仅用于只读监测与统计研究，不构成投资建议。

只读监测与字段说明见：https://lava.ai-dolphin.com/subscribe/docs