大宗商品分析解读

任务目标

本 Skill 用于：通过钢联内部分析接口，获取大宗商品市场的专业分析报告
能力包含：钢铁、有色、能源化工、炉料及相关产业链的价格分析、供需解读、库存跟踪等
触发条件：当用户提出"分析XX市场"、"XX价格走势"、"供需情况如何"等分析需求时

前置准备

凭证配置：需要配置钢联API密钥（两种方式任选其一）
- 方式一（推荐）：设置环境变量 mysteel_skill_auth_key
- 方式二：在 references/api_key.md 文件中配置（将 YOUR_API_KEY_HERE 替换为实际的API密钥）
- 优先级：系统会优先使用环境变量，未配置时才读取文件

操作步骤

标准流程：
1. 检查API密钥配置（必需步骤）
  - 系统会按以下优先级查找API密钥：
    1. 环境变量 mysteel_skill_auth_key（推荐）
    2. references/api_key.md 文件
  - 如果两种方式均未配置或配置无效：
    - 立即终止整个流程
    - 提示用户配置API密钥，提供环境变量或文件两种配置指引
    - 严禁跳过此步骤或通过其他方式回答用户问题
  - 注意：此步骤失败时，整个Skill执行立即终止，不执行任何后续操作
  - 重要：推荐使用环境变量方式配置，便于管理和迁移
2. 理解分析需求
  - 仅在API密钥验证通过后执行
  - 智能体解析用户的大宗商品分析需求
  - 识别分析对象（品类、市场、时间段）
  - 提取关注维度（价格、供需、库存、情绪等）
3. 构建查询语句
  - 根据需求特点构建结构化查询问题
  - 例如："上海建筑钢材市场分析"、"螺纹钢价格走势及供需情况"
  - 智能体可根据上下文优化查询表述
4. 调用分析接口 必须使用以下完整参数调用 exec 工具，不要省略任何字段，尤其是 yieldMs 和 timeout：
```
   {
     "tool": "exec",
     "command": "python3 scripts/analyze.py --query \"<你的查询问题>\"",
     "yieldMs": 150000,
     "timeout": 300,
     "background": false
   }
```
  - 执行脚本，获取钢联分析结果
  - 接口响应时间约90秒，请耐心等待
  - 返回格式为Markdown结构化分析报告
5. 深度解读与扩充输出
  - 充分理解接口返回的Markdown格式分析报告的完整内容和逻辑结构
  - 保留原文核心数据和分析框架，不进行删减或简化
  - 扩充内容：在原有报告基础上：
    - 补充更详细的背景信息和行业背景
    - 增加数据背后的逻辑分析和因果关系解读
    - 添加多维度的视角和交叉验证
    - 扩展风险因素的深度分析
    - 补充实操建议和策略指引
  - 输出目标：提供一篇比原报告更加饱满、全面、有深度的分析结果
  - 确保输出内容完整性强，信息密度高，满足用户深度分析需求
异常处理：
- 当API密钥校验失败（两种方式均未配置或配置无效）：
  - 立即终止整个流程
  - 明确提示用户配置API密钥，提供环境变量或文件两种配置方式
  - 绝对禁止跳过校验或通过其他途径回答用户问题
- 当接口返回Token校验失败（code=400）：
  - 立即终止整个流程
  - 提示用户API密钥无效，需要更换正确的密钥
  - 引导用户更新环境变量 mysteel_skill_auth_key 或 references/api_key.md 文件中的密钥
- 当接口返回系统内部异常（code=401等其他错误）：
  - 脚本会自动重试一次
  - 如果重试仍失败，提示用户稍后重试
- 当接口超时：建议用户稍后重试或简化查询范围

资源索引

必要脚本：见 scripts/analyze.py（用途与参数：调用钢联内部分析接口，接收query参数，返回Markdown格式分析结果）
API密钥配置：见 references/api_key.md（用途：存储钢联API密钥，第一行注释，第二行为实际密钥。注意：优先使用环境变量 mysteel_skill_auth_key）

注意事项

该接口为钢联内部服务，调用需要有效凭证
API密钥校验是硬性前置条件，验证失败时必须终止流程，严禁绕过
Token校验失败（code=400）表示密钥无效，需要用户更换正确的API密钥
系统内部异常（code=401等）会自动重试一次，无需用户干预
严禁在API密钥缺失或无效的情况下使用智能体的通用知识回答用户问题
接口响应时间较长（约90秒），请合理安排调用时机
查询问题越具体，返回的分析结果越精准
智能体会根据分析结果提供专业的业务解读和风险提示

使用示例

示例1：市场概况分析
- 用户提问："上海建筑钢材市场最近怎么样？"
- 执行方式：检查密钥 → 验证通过 → 构建查询 → 调用脚本 → 解读结果
- 异常情况：检查密钥 → 验证失败 → 提示输入 → 终止流程
示例2：价格趋势分析
- 用户提问："螺纹钢最近的价格走势如何？"
- 执行方式：检查密钥 → 验证通过 → 构建查询 → 调用脚本 → 输出趋势解读
示例3：供需关系分析
- 用户提问："现在螺纹钢供需情况怎么样？"
- 执行方式：检查密钥 → 验证通过 → 构建查询 → 调用脚本 → 提供供需解读

Mysteel_MarketAnalysis

大宗商品分析解读

任务目标

前置准备

操作步骤

资源索引

注意事项

使用示例