113 lines
5.3 KiB
Markdown
113 lines
5.3 KiB
Markdown
---
|
||
name: study-analysis
|
||
description: 分析用户学习情况的工具，输入格式为「学情分析：用户角色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文件访问地址返回给用户
|
||
|
||
## 调用方式
|
||
执行脚本：
|
||
```bash
|
||
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可视化报告的本地路径/访问地址
|
||
- 失败：返回具体错误信息
|
||
|
||
## 文字版学情分析报告通用模板
|
||
生成可视化报告后，可使用以下模板整理成文字版总结发送给学员/教学团队：
|
||
```
|
||
# 📚 学情分析报告 - 学员{{学员ID}} {{Level等级}} {{Unit单元号}}
|
||
生成时间：{{报告生成日期 YYYY-MM-DD}}
|
||
---
|
||
## 一、基本信息
|
||
- 学员ID：{{学员ID}}
|
||
- 学习级别：{{Level X}}
|
||
- 学习单元：{{Unit X 单元名称}}（共{{课时数}}课时）
|
||
- 学习周期：{{单元开始日期}} ~ {{单元结束日期}}（共{{X}}天）
|
||
- 总学习时长：约{{X小时X分钟}}
|
||
|
||
## 二、整体学习情况概览
|
||
- 总互动次数：{{X}}次（每课时{{X}}个互动组件）
|
||
- 总练习题数：{{X}}道（每课时{{X}}道巩固练习）
|
||
- 单元整体掌握率：{{XX}}%，属于{{优秀/良好/合格/待提升}}水平
|
||
- 能力训练完成情况：共{{X}}项训练，{{X}}项Perfect、{{X}}项Good、{{X}}项待提升
|
||
|
||
## 三、各维度表现分析
|
||
### 1. 互动组件表现（平均正确率{{XX}}%）
|
||
| 课时 | 课时名称 | Perfect | Good | Oops | 正确率 | 薄弱知识点 |
|
||
|------|---------|---------|------|------|--------|------------|
|
||
| Lesson {{X}} | {{课时名称}} | {{X}} | {{X}} | {{X}} | {{XX}}% | {{薄弱知识点1、2}} |
|
||
| {{依次补充所有课时数据}} | | | | | | |
|
||
|
||
### 2. 巩固练习表现（平均正确率{{XX}}%）
|
||
| 课时 | 课时名称 | 正确 | 错误 | 正确率 | 易错知识点 |
|
||
|------|---------|------|------|--------|------------|
|
||
| Lesson {{X}} | {{课时名称}} | {{X}} | {{X}} | {{XX}}% | {{易错知识点1、2}} |
|
||
| {{依次补充所有课时数据}} | | | | | |
|
||
|
||
### 3. 能力训练表现（平均正确率{{XX}}%）
|
||
| 题型 | 数量 | Perfect | Good | Oops | 薄弱项 |
|
||
|------|------|---------|------|------|--------|
|
||
| 听力 | {{X}} | {{X}} | {{X}} | {{X}} | {{薄弱项}} |
|
||
| 阅读 | {{X}} | {{X}} | {{X}} | {{X}} | {{薄弱项}} |
|
||
| 口语 | {{X}} | {{X}} | {{X}} | {{X}} | {{薄弱项}} |
|
||
| 写作 | {{X}} | {{X}} | {{X}} | {{X}} | {{薄弱项}} |
|
||
|
||
## 四、优势总结
|
||
✅ **{{优势1，例如：基础能力扎实}}**：{{补充具体表现，例如：单词跟读、听选类题型正确率超过95%}}
|
||
✅ **{{优势2，例如：听力理解突出}}**：{{补充具体表现}}
|
||
✅ **{{优势3，例如：综合理解能力强}}**：{{补充具体表现}}
|
||
✅ **{{优势4，例如：学习习惯良好}}**：{{补充具体表现}}
|
||
|
||
## 五、待提升方向
|
||
⚠️ **{{待提升点1，例如：句型应用能力}}**：{{补充具体表现，例如：句型替换、单词排序类题型正确率低于80%}}
|
||
⚠️ **{{待提升点2，例如：输出类能力}}**：{{补充具体表现}}
|
||
⚠️ **{{待提升点3，例如：语法规则细节}}**：{{补充具体表现}}
|
||
⚠️ **{{待提升点4，例如：逻辑关联能力}}**：{{补充具体表现}}
|
||
|
||
## 六、个性化学习建议
|
||
1. **{{建议方向1}}**：{{具体执行方案，例如：每天花10分钟做句型替换练习，重点练习X类核心句型}}
|
||
2. **{{建议方向2}}**：{{具体执行方案}}
|
||
3. **{{建议方向3}}**：{{具体执行方案}}
|
||
4. **{{建议方向4}}**：{{具体执行方案}}
|
||
```
|
||
|
||
### 模板使用说明
|
||
1. 所有量化数据可从自动化生成的HTML学情报告中直接提取，无需手动统计
|
||
2. 优势/待提升方向需对应数据支撑，避免主观判断
|
||
3. 学习建议需可落地，明确训练内容、频次、周期，避免笼统描述
|
||
4. 可根据学员实际情况增减模块，重点突出学员个性化特征
|