ai_member_xiaoban/skills/study-analysis/SKILL.md

name	description
study-analysis	分析用户学习情况的工具，输入格式为「学情分析：用户角色ID，Level几，Unit几」，其中Level支持Level1/L1/1格式，Unit支持Unit1/U1/1格式，自动请求API获取学情数据并生成可视化分析报告。触发场景：用户提到「学情分析」、「学习情况分析」时使用。

学情分析技能使用指南

触发规则

当用户输入以下格式内容时触发本技能：

学情分析：[用户角色ID]，[Level]，[Unit]

• 用户角色ID：数字类型（必填）
• Level：支持多种格式：Level1/L1/1/Level2/L2/2，自动转换为数字1或2
• Unit：支持多种格式：Unit1/U1/1，自动转换为对应的数字

工作流程

1. 参数解析：从用户输入中提取角色ID、Level、Unit三个参数，统一格式化为数字类型
2. 构造请求：将参数封装为API查询参数，operator固定为Kingson
3. 请求API：调用学情分析服务API https://api.valavala.com/v2/user/unit/learn/info，传入请求参数
4. 存储数据：将API返回的JSON数据保存到本地 output 目录
5. 生成可视化报告：使用HTML模板渲染返回数据，生成可视化HTML文件
6. 返回结果：将生成的HTML文件访问地址返回给用户

调用方式

执行脚本：

python3 /root/.openclaw/workspace-xiaoban/skills/study-analysis/scripts/analysis.py [role_id] [level] [unit]

参数说明

• role_id: 用户角色ID（数字）
• level: 等级（数字1或2）
• unit: 单元号（数字）

API接口说明

• 请求地址：https://api.valavala.com/v2/user/unit/learn/info
• 请求方式：GET
• 请求参数：
  • operator: 固定值 Kingson
  • level: L1 或 L2
  • userId: 用户角色ID
  • unitIndex: 单元号

输出说明

• 成功：返回HTML可视化报告的本地路径/访问地址
• 失败：返回具体错误信息