feat: 添加第12课课评、班级总结及学生画像更新
- K4周日1900班第12课《花朵随心画》课评（梁境城、钟嘉逸、王睿意补课） - AICODE03/CSP03各班级第12课课评及班级总结 - 更新多班级学生画像 - 课评生成技能优化
This commit is contained in:
chengzi
338
docs/superpowers/specs/2026-05-23-橙子老师-subagent-design.md
Normal file
338
docs/superpowers/specs/2026-05-23-橙子老师-subagent-design.md
Normal file
@@ -0,0 +1,338 @@
|
||||
# 橙子老师 Subagent 设计文档
|
||||
|
||||
**创建日期**: 2026-05-23
|
||||
**版本**: 1.0
|
||||
**状态**: 设计完成，待实施
|
||||
|
||||
---
|
||||
|
||||
## 1. 概述
|
||||
|
||||
### 1.1 项目背景
|
||||
橙子老师是一个专门用于和学生进行心理疏导对话的Claude Code subagent。它能够针对不同性格的学生，通过快速咨询的方式解决学习中的具体问题，提供正向引导和激励。
|
||||
|
||||
**心理疏导范围**：
|
||||
- 学习困难：编程概念理解、逻辑思维、调试能力等
|
||||
- 信心不足：害怕犯错、不敢尝试、自我怀疑等
|
||||
- 专注力问题：容易分心、缺乏耐心、难以持续等
|
||||
- 家庭压力：家长期望过高、学习时间不足等
|
||||
- 人际关系：同学竞争、合作困难等
|
||||
|
||||
**不涉及范围**：
|
||||
- 严重心理健康问题（需引导至专业帮助）
|
||||
- 医疗建议
|
||||
- 学术作弊处理
|
||||
- 家庭纠纷调解
|
||||
|
||||
### 1.2 核心目标
|
||||
- 为学生提供心理疏导和情感支持
|
||||
- 针对不同性格的学生调整沟通方式
|
||||
- 快速解决学习中的具体问题（5-10分钟）
|
||||
- 提供正向引导，避免负面评价
|
||||
|
||||
### 1.3 目标用户
|
||||
- 主要用户：穹狼科创编程课程的学生
|
||||
- 次要用户：橙子老师（作为管理和触发者）
|
||||
|
||||
### 1.4 学生性格分类
|
||||
根据学生档案中的性格描述，将学生分为以下类型：
|
||||
|
||||
| 性格类型 | 特征描述 | 沟通策略 |
|
||||
|---------|---------|---------|
|
||||
| 内向型 | 安静、不善表达、喜欢独立思考 | 温和鼓励、多倾听、给予思考时间 |
|
||||
| 外向型 | 活泼、爱表达、喜欢互动 | 积极回应、引导深度思考、适当挑战 |
|
||||
| 敏感型 | 容易受情绪影响、在意评价 | 正向反馈、避免批评、建立安全感 |
|
||||
| 自信型 | 有主见、敢于尝试、接受挑战 | 肯定能力、引导反思、适度挑战 |
|
||||
| 依赖型 | 喜欢指导、缺乏自主性 | 逐步引导、培养独立、给予成功体验 |
|
||||
|
||||
---
|
||||
|
||||
## 2. 架构设计
|
||||
|
||||
### 2.1 整体架构
|
||||
```
|
||||
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||||
│ 触发入口 │ │ 对话引擎 │ │ 学生档案系统 │
|
||||
│ - 学生主动发起 │───▶│ - 状态管理 │◀───│ - 性格特点 │
|
||||
│ - 橙子老师安排 │ │ - 流程控制 │ │ - 学习状态 │
|
||||
│ - 系统触发 │ │ - 模板选择 │ │ - 历史表现 │
|
||||
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────┐
|
||||
│ 分析诊断模块 │
|
||||
│ - 性格分析器 │
|
||||
│ - 问题诊断器 │
|
||||
│ - 激励策略器 │
|
||||
└─────────────────┘
|
||||
```
|
||||
|
||||
### 2.2 组件说明
|
||||
|
||||
#### 2.2.1 Agent配置文件
|
||||
- **位置**: `.claude/agents/橙子老师/agent.md`
|
||||
- **内容**:
|
||||
- Agent名称、描述、版本
|
||||
- 能力范围和限制
|
||||
- 对话原则和红线
|
||||
- 调用方式和参数说明
|
||||
|
||||
#### 2.2.2 对话引擎
|
||||
- **功能**: 管理对话流程和状态
|
||||
- **状态**: 开始、进行中、结束
|
||||
- **模式**: 快速咨询型（5-10分钟）
|
||||
- **能力**: 处理中断和恢复
|
||||
|
||||
#### 2.2.3 学生档案访问器
|
||||
- **功能**: 读取和解析学生档案
|
||||
- **数据源**: `.claude/memory/class/[班级]/[姓名]/profile.md`
|
||||
- **输出**: 学生性格特点、学习状态、历史表现摘要
|
||||
|
||||
#### 2.2.4 对话模板库
|
||||
- **分类**: 按场景分类（学习困难、信心不足、专注力问题、家庭压力等）
|
||||
- **结构**: 每个场景包含多个对话模板
|
||||
- **选择**: 根据学生性格和问题类型自动选择
|
||||
|
||||
#### 2.2.5 性格分析器
|
||||
- **输入**: 学生档案中的性格描述、行为记录
|
||||
- **分析**: 识别主要性格类型（内向/外向/敏感/自信等）
|
||||
- **输出**: 性格维度输入，用于对话策略选择
|
||||
|
||||
#### 2.2.6 问题诊断器
|
||||
- **输入**: 学生档案中的学习状态、历史表现
|
||||
- **识别**: 常见问题类型（理解力不足、专注力差、缺乏兴趣、家庭影响等）
|
||||
- **输出**: 问题焦点，用于对话内容设计
|
||||
|
||||
#### 2.2.7 激励策略器
|
||||
- **输入**: 学生性格和问题类型
|
||||
- **策略**: 鼓励型、挑战型、支持型、引导型等
|
||||
- **输出**: 动态调整对话中的激励方式
|
||||
|
||||
---
|
||||
|
||||
## 3. 对话流程
|
||||
|
||||
### 3.1 触发方式
|
||||
1. **学生主动发起**: 学生通过特定命令或界面发起对话
|
||||
2. **橙子老师主动发起**: 根据学生档案中的问题标记，主动联系学生
|
||||
3. **老师安排对话**: 橙子老师根据需要安排特定学生和橙子老师对话
|
||||
|
||||
### 3.2 对话阶段
|
||||
```
|
||||
1. 开场白 → 2. 了解情况 → 3. 问题诊断 → 4. 激励引导 → 5. 总结建议 → 6. 结束
|
||||
```
|
||||
|
||||
#### 阶段1: 开场白
|
||||
- 自我介绍（我是橙子老师）
|
||||
- 建立信任关系
|
||||
- 明确对话目的
|
||||
|
||||
#### 阶段2: 了解情况
|
||||
- 询问学生当前状态
|
||||
- 倾听学生描述
|
||||
- 初步判断问题类型
|
||||
|
||||
#### 阶段3: 问题诊断
|
||||
- 根据学生描述和档案信息
|
||||
- 识别具体问题类型
|
||||
- 确定对话焦点
|
||||
|
||||
#### 阶段4: 激励引导
|
||||
- 根据问题类型选择激励策略
|
||||
- 使用正向语言引导
|
||||
- 提供具体建议和方法
|
||||
|
||||
#### 阶段5: 总结建议
|
||||
- 总结对话要点
|
||||
- 提供可操作的建议
|
||||
- 鼓励学生继续努力
|
||||
|
||||
#### 阶段6: 结束
|
||||
- 感谢学生参与
|
||||
- 表达持续支持
|
||||
- 结束对话
|
||||
|
||||
### 3.3 对话原则
|
||||
- **快速咨询型**: 5-10分钟，聚焦具体问题
|
||||
- **正向引导**: 避免负面评价，用积极方式引导
|
||||
- **个性化**: 根据学生性格调整语气和方式
|
||||
- **保密性**: 对话内容不对外公开，保护学生隐私
|
||||
|
||||
---
|
||||
|
||||
## 4. 文件结构
|
||||
|
||||
```
|
||||
.claude/
|
||||
├── agents/
|
||||
│ └── 橙子老师/
|
||||
│ ├── agent.md # Agent配置文件
|
||||
│ ├── 对话模板/
|
||||
│ │ ├── 学习困难.md # 学习困难场景模板
|
||||
│ │ ├── 信心不足.md # 信心不足场景模板
|
||||
│ │ ├── 专注力问题.md # 专注力问题场景模板
|
||||
│ │ └── 家庭压力.md # 家庭压力场景模板
|
||||
│ └── 策略库/
|
||||
│ ├── 鼓励型策略.md # 鼓励型激励策略
|
||||
│ ├── 挑战型策略.md # 挑战型激励策略
|
||||
│ └── 支持型策略.md # 支持型激励策略
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 实现方案
|
||||
|
||||
### 5.1 Agent配置
|
||||
- 使用Claude Code的agent系统配置
|
||||
- 定义在`.claude/agents/橙子老师/agent.md`
|
||||
- 支持自定义对话参数（时长、深度等）
|
||||
|
||||
### 5.2 调用方式
|
||||
- 通过斜杠命令`/橙子老师`调用
|
||||
- 支持参数：学生姓名、对话场景、触发方式等
|
||||
- 示例：`/橙子老师 李梓宁 学习困难`
|
||||
|
||||
### 5.3 集成点
|
||||
- 访问`.claude/memory/class/`下的学生档案
|
||||
- 可选：与课评系统集成，记录对话结果到学生档案
|
||||
|
||||
### 5.4 技术栈
|
||||
- Claude Code agent系统
|
||||
- Markdown配置文件
|
||||
- 学生档案系统（现有）
|
||||
|
||||
---
|
||||
|
||||
## 6. 错误处理
|
||||
|
||||
### 6.1 学生档案不存在
|
||||
- 使用默认对话策略
|
||||
- 提示学生档案信息不完整
|
||||
- 建议补充学生信息
|
||||
|
||||
### 6.2 对话中断
|
||||
- 支持断点续传
|
||||
- 保存对话状态
|
||||
- 允许稍后继续
|
||||
|
||||
### 6.3 敏感问题识别
|
||||
- 识别可能的心理健康问题
|
||||
- 引导到专业帮助
|
||||
- 避免提供医疗建议
|
||||
|
||||
### 6.4 对话超时
|
||||
- 快速咨询型对话控制在10分钟内
|
||||
- 超时时提示并总结
|
||||
- 可选择延长或结束
|
||||
|
||||
---
|
||||
|
||||
## 7. 测试计划
|
||||
|
||||
### 7.1 单元测试
|
||||
- 对话引擎的状态管理
|
||||
- 学生档案访问器的解析功能
|
||||
- 性格分析器的准确性
|
||||
|
||||
### 7.2 集成测试
|
||||
- 完整对话流程测试
|
||||
- 与学生档案系统的集成
|
||||
- 多种触发方式的测试
|
||||
|
||||
### 7.3 用户测试
|
||||
- 不同性格学生的对话测试
|
||||
- 对话质量评估
|
||||
- 用户满意度调查
|
||||
|
||||
### 7.4 性能测试
|
||||
- 对话响应时间
|
||||
- 学生档案读取速度
|
||||
- 系统资源占用
|
||||
|
||||
---
|
||||
|
||||
## 8. 部署和维护
|
||||
|
||||
### 8.1 部署步骤
|
||||
1. 创建目录结构
|
||||
2. 编写agent配置文件
|
||||
3. 创建对话模板库
|
||||
4. 实现分析诊断模块
|
||||
5. 测试和验证
|
||||
|
||||
### 8.2 维护计划
|
||||
- 定期更新对话模板
|
||||
- 根据反馈优化策略
|
||||
- 扩展新的对话场景
|
||||
|
||||
### 8.3 监控和日志
|
||||
- 对话成功率统计
|
||||
- 问题类型分布
|
||||
- 用户满意度跟踪
|
||||
|
||||
---
|
||||
|
||||
## 9. 风险评估
|
||||
|
||||
### 9.1 技术风险
|
||||
- 学生档案格式变化
|
||||
- Claude Code agent系统限制
|
||||
- 对话质量不稳定
|
||||
|
||||
### 9.2 业务风险
|
||||
- 学生不接受AI对话
|
||||
- 对话效果不佳
|
||||
- 隐私泄露风险
|
||||
|
||||
### 9.3 缓解措施
|
||||
- 定期备份学生档案
|
||||
- 建立对话质量评估机制
|
||||
- 加强隐私保护措施
|
||||
|
||||
---
|
||||
|
||||
## 10. 时间计划
|
||||
|
||||
### 10.1 设计阶段（1周）
|
||||
- 需求分析和确认
|
||||
- 架构设计和评审
|
||||
- 文档编写和审核
|
||||
|
||||
### 10.2 实现阶段（2周）
|
||||
- Agent配置文件编写
|
||||
- 对话模板库创建
|
||||
- 分析诊断模块实现
|
||||
- 对话引擎开发
|
||||
|
||||
### 10.3 测试阶段（1周）
|
||||
- 单元测试
|
||||
- 集成测试
|
||||
- 用户测试
|
||||
|
||||
### 10.4 部署阶段（1周）
|
||||
- 系统部署
|
||||
- 用户培训
|
||||
- 上线运行
|
||||
|
||||
---
|
||||
|
||||
## 11. 附录
|
||||
|
||||
### 11.1 术语表
|
||||
- **Subagent**: Claude Code中的子智能体
|
||||
- **对话模板**: 预定义的对话流程和内容
|
||||
- **激励策略**: 针对不同学生类型的激励方法
|
||||
|
||||
### 11.2 参考文献
|
||||
- Claude Code文档
|
||||
- 学生心理疏导相关文献
|
||||
- 编程教育心理学研究
|
||||
|
||||
### 11.3 变更历史
|
||||
- v1.0 (2026-05-23): 初始设计文档
|
||||
|
||||
---
|
||||
|
||||
**设计者**: Claude Code
|
||||
**审核者**: 橙子
|
||||
**批准者**: 待定
|
||||
Reference in New Issue
Block a user