ClassFeedback/docs/superpowers/specs/2026-05-23-橙子老师-subagent-design.md

# 橙子老师 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
**审核者**: 橙子
**批准者**: 待定