3b75170862
- K4周日1900班第12课《花朵随心画》课评（梁境城、钟嘉逸、王睿意补课） - AICODE03/CSP03各班级第12课课评及班级总结 - 更新多班级学生画像 - 课评生成技能优化
9.6 KiB
9.6 KiB
橙子老师 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 触发方式
- 学生主动发起: 学生通过特定命令或界面发起对话
- 橙子老师主动发起: 根据学生档案中的问题标记，主动联系学生
- 老师安排对话: 橙子老师根据需要安排特定学生和橙子老师对话
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 部署步骤
- 创建目录结构
- 编写agent配置文件
- 创建对话模板库
- 实现分析诊断模块
- 测试和验证
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 审核者: 橙子 批准者: 待定