前言¶

大宗商品研报的写作难点不在文笔，而在数据和结构。价格、库存、开工率、进出口这些基本面数据散落在 Mysteel 钢联数据库里，人工整理一遍要花不少时间；报告的框架又相对固定，日报、周报、深度分析、策略报告各有一套范式。做这类 Agent 应用时，需要让模型既拿到实时数据，又遵守既定的研报结构，还要能溯源。

下面介绍的 Skill 就是这个方向：把钢联数据库的实时数据检索和研报框架固化进 Skill，模型只需在用户明确要求写报告时触发。

这是什么¶

Mysteel_ReportWrite，坐标 @clawhub_wyb92/mysteel-reportwrite，由 wyb92 发布，来源 clawhub，当前版本 1.0.0，许可证 MIT-0。分类为 data-analysis，标签 requires_api_key=true。上游页面显示评分 100000，下载 21770，安装 16。

它解决的问题是：用户明确要求写报告、撰写研报、生成分析报告时，Agent 自动完成从钢联数据库取数、按研报框架生成梗概、再丰富成完整研报的流程。数据实时检索、专业框架输出、可溯源的生成是它的三项能力。

核心功能¶

1、数据实时检索。与 Mysteel 钢联数据库打通，实时查询价格、库存、开工率、进出口等基本面数据。

2、专业框架输出。内置行业通用的研究报告框架，覆盖日报、周报、深度分析、策略报告。

3、可溯源的生成。生成内容附带数据来源或推理依据，便于核对专业写作的准确性。

4、明确的触发条件。只在用户明确表达写报告、撰写研报、生成分析报告时使用。

安装与启用¶

安装通过 OpenClaw 的 skills 命令完成：

openclaw skills install @wyb92/mysteel-reportwrite

Skill 基于通用 SKILL.md 格式，安装后由 Agent 读取 SKILL.md 并按其描述执行。官方资料未提及 Cursor、Codex CLI、Claude Code 的专门适配，这里不做展开。

环境依赖有两项：

python requests>=2.28.0

Python 版本要求 >= 3.6，requests 库用于发起 HTTP 请求。遇到 ImportError 时执行 pip install requests。

凭证方面，Skill 需要钢联 API 密钥，需联系钢联内部获取 api_key，并写入 references/api_key.md（第一行注释，第二行为 api_key，把 YOUR_API_KEY_HERE 替换为实际密钥）。

典型用法¶

官方流程分五个步骤。步骤 1 是判断触发条件，识别「写一篇 XX 报告」「分析 XX 市场」「XX 价格走势」「XX 供需分析」「策略报告」等关键词。步骤 2 是检查凭证配置，这一步是强制前置条件，按官方说明必须完成才能继续。

步骤 3 调用钢联研报梗概接口，通过脚本执行：

python scripts/call_mysteel_api.py --query "<用户研报撰写目标>"

接口是响应式的，执行时间约 90 秒，最长 2 分钟。成功时返回 JSON，含 success、outline（研报梗概）、api_response 字段；失败时返回 success、error、error_code（如 token_invalid）、retryable 字段。

步骤 4 基于梗概丰富内容。官方要求的研报结构包括：报告标题、执行摘要（200-300 字）、市场概况（价格走势、供需情况、关键影响因素）、供需分析（供应端的产量/库存/开工率，需求端的消费量/下游需求变化，进出口）、趋势预测（短期 1-3 个月与中长期判断、关键风险因素）、策略建议（投资策略、风险提示）、数据来源（说明来源与统计周期）。撰写要求是语言专业客观、数据引用标明来源和时间、逻辑层次分明、图表数据可用文字描述、避免主观臆断。

步骤 5 以 Markdown 格式输出完整研报。

以官方给出的螺纹钢市场分析示例为例，执行链条是：识别研报撰写需求 → 读取并校验 references/api_key.md → 执行脚本获取梗概 → 解析 outline 字段 → 按结构丰富内容 → 输出完整研报。

凭证校验失败时的处理是这套流程里最硬的约束。文件不存在、api_key 仍是占位符、api_key 为空三种情况，官方都要求立即终止流程，提示用户提供钢联 API 密钥。严禁在校验失败后继续后续步骤、严禁用其他方式回答研报需求、严禁绕过凭证检查直接调用 API。正确流程是用户输入密钥后更新 references/api_key.md，重新校验，通过后再进入步骤 3。

适用场景与注意¶

适合已经有钢联 API 密钥、需要批量产出大宗商品日报/周报/深度报告的场景，尤其是数据口径要与 Mysteel 数据库一致时。

需要注意的几点：API 密钥是硬门槛，没有密钥这个 Skill 无法工作，所以先确认能从钢联内部拿到 api_key。单次梗概生成约 90 秒，接口支持错误重试（自动重试一次），调用方要预留等待时间。研报正文是模型基于梗概二次丰富出来的，数据引用需自行复核，不能把生成结果直接当作已核对的数据。触发条件写得很清楚，只在用户明确要求写报告时使用，不要把它当作通用行情问答的默认入口。

结尾¶

Mysteel_ReportWrite 的价值在于把「取数 + 框架 + 溯源」这三层从人工流程里抽出来交给 Agent，使用者只需要提供研报目标和 API 密钥。官方地址：https://api.skillhub.cn/mysteel/mysteel-reportwrite ，上游仓库：https://clawhub.ai/wyb92/mysteel-reportwrite 。