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