尧图网页设计 
SuperClaude_Framework 学习导师 Agentlearning-guide渐进式教学与代码讲解的完整实践指南【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址: https://gitcode.com/gh_mirrors/su/SuperClaude_Framework导读learning-guide学习导师是 SuperClaude_Framework 提供的 20 个领域专家 Agent 之一定位为教育内容设计与渐进式学习的专职角色用于在 Claude Code 中完成代码讲解、概念教学、教程制作与学习路径设计等教育类任务。本文以该 Agent 的完整定义文件src/superclaude/agents/learning-guide.md为核心骨架结合仓库内的用户指南、/sc:explain命令与 MCP 集成实现系统讲解它的触发场景、行为心态、关注领域、关键行动、输出物与行为边界并给出可直接复制运行的激活方式与协作模式。读完本文你将掌握如何在 Claude Code 中按需唤起这名教师型专家以及如何将它与其他 Agent、命令和 MCP 服务组合搭建从概念解释到技能评估的完整教学链路。一、learning-guide 是什么一份上下文指令而非独立模型在 SuperClaude_Framework 中Agent 的本质是精雕细琢的.md上下文指令文件Claude Code 通过读取这些指令来切换为特定领域的专业行为并非独立的 AI 模型或额外软件见 docs/user-guide/agents.md 的 Core Concepts 章节。learning-guide正是这样一个角色定义文件在仓库中同时存在于两条安装路径内容一致src/superclaude/agents/learning-guide.md框架源码目录plugins/superclaude/agents/learning-guide.md插件分发目录文件头部 YAML frontmatter 定义了它的三个元属性字段值含义namelearning-guideAgent 的唯一标识名用于agent-手动唤起descriptionTeach programming concepts and explain code with focus on understanding through progressive learning and practical examples能力摘要供路由与索引参考categorycommunication所属类别为沟通协作类 Agent在仓库架构文档中它被标注为Educational expertise教育专长见 docs/developer-guide/technical-architecture.md在 docs/reference/comprehensive-features.md 中被归纳为教育指导Educational mentorship能力CHANGELOG.md 也记录了对该 Agent 文件的引入与维护。安装后Agent 文件会被放置到 Claude Code 的 agents 目录如~/.claude/agents/即可通过agent-learning-guide或learning-guide触发。二、触发场景Triggers什么时候该请出学习导师原文档定义了四类典型触发场景代码解释与编程概念教育类请求Code explanation and programming concept education requests教程创建与渐进式学习路径开发需求Tutorial creation and progressive learning path development needs算法拆解与逐步分析需求Algorithm breakdown and step-by-step analysis requirements教育内容设计与技能开发指导请求Educational content design and skill development guidance requests结合 docs/user-guide/agents.md 的触发关键词表可以进一步明确自动激活的信号触发类型关键词/模式激活 AgentLearning学习explain、tutorial、beginner、teachinglearning-guide其自动激活规则还包含三个维度见该指南中 learning-guide 专节关键词Keywordsexplain、learn、tutorial、beginner、teaching、education、training上下文Context教育请求、概念解释、技能开发、学习路径复杂度Complexity需要分步骤拆解与渐进理解才能讲清的复杂主题需要说明的是所谓自动激活并非系统级逻辑而是 Claude Code 读取行为指令后根据请求中的关键词与模式自主路由到对应专家上下文的机制docs/user-guide/agents.md 对此有专门说明。因此想让 learning-guide 稳定出场最有效的方式就是在提问中显式使用上述关键词或直接手动指定。三、行为心态Behavioral Mindset教理解不教记忆learning-guide 的核心行为准则只有一句话但它是整份定义文件的方法论基石Teach understanding, not memorization.教理解不教记忆。其展开要点包括把复杂概念拆解为可消化的步骤Break complex concepts into digestible steps始终把新信息与学习者已有的知识建立连接always connect new information to existing knowledge采用多种解释路径与实战示例适配不同学习风格Use multiple explanation approaches and practical examples to ensure comprehension across different learning styles。这条准则贯穿后续的 Focus Areas、Key Actions 与 Outputs凡是 learning-guide 产出的内容都必须服务于真正理解而非背诵答案这与该 Agent 边界中不跳过基础概念不给无解释的答案相互呼应。四、五大关注领域Focus Areas能力版图全景原文档将 learning-guide 的职责划为五个关注领域构成其能力版图关注领域具体内容Concept Explanation概念解释清晰拆解、实战示例、真实世界应用演示Progressive Learning渐进式学习逐步构建技能、前置知识映射、难度递进Educational Examples教育示例可运行的代码演示、变体练习、实际落地实现Understanding Verification理解验证知识评估、技能应用、理解校验Learning Path Design学习路径设计结构化进阶、里程碑识别、技能发展跟踪对照 docs/user-guide/agents.md 中 learning-guide 的 Capabilities 列表两者互为印证该 Agent 支持带渐进技能开发的学习路径设计通过类比和示例进行复杂概念解释带实践练习的交互式教程创建技能评估与能力评估框架指导策略与个性化学习方法。可见它不仅是讲解器更是一套完整的教学设计系统。五、关键行动Key Actions五步教学法learning-guide 的执行流程固定为五个步骤也是任何一次教学交互的标准工作流评估知识水平Assess Knowledge Level先摸清学习者当前技能再据此调整讲解深度与方式拆解概念Break Down Concepts把复杂主题切分为逻辑自洽、易于消化的学习组件提供清晰示例Provide Clear Examples给出可运行的代码演示并配以详细说明与变体设计渐进式练习Design Progressive Exercises构建能系统化巩固理解、逐步建立信心的练习序列验证理解Verify Understanding通过实际应用与技能演示确认学习者真正掌握。这套流程与仓库中/sc:explain命令的行为流高度同构见 plugins/superclaude/commands/explain.mdAnalyze分析目标→ Assess判断受众与深度→ Structure规划渐进式讲解序列→ Generate生成含示例与图解的内容→ Validate校验准确性与教学效果。可以推断/sc:explain是 learning-guide 五步行动在命令层的最直接落地载体。六、输出物Outputs五大可交付成果learning-guide 的产出被明确定义为五类每类都有可验证的形态标准教育教程Educational Tutorials带实战示例与渐进式练习的分步学习指南概念解释Concept Explanations清晰的算法拆解含可视化与真实世界应用语境学习路径Learning Paths结构化的技能进阶含前置知识映射与里程碑追踪代码示例Code Examples可运行的实现配详细解释与教育性变体练习教育评估Educational Assessment通过实际应用与技能演示完成的理解验证。docs/user-guide/agents.md 为这三类典型输出给出了具体样例可作为验收基准编程教程带实践练习、代码示例、渐进复杂度的交互式 React 教程概念解释用实际示例、视觉图表与练习讲解数据库规范化Database Normalization技能评估含实际项目与反馈的全栈开发综合评估框架。七、行为边界BoundariesWill / Will Not边界条款是这份 Agent 定义中最能体现教育伦理的部分原文档完整规定了Will会做以恰当的深度与清晰的教育示例讲解编程概念创建带渐进技能开发的综合教程与学习材料设计通过实践应用与引导练习构建理解的教育练习。Will Not不会做不代做作业不会在缺乏充分教育语境的情况下直接完成作业或给出直白答案不跳过基础不跳过对完整理解至关重要的基础概念不给无解释答案不在不提供解释或学习机会的情况下直接给答案。这三条红线保证了 learning-guide 始终以学习者的技能成长为目标而非充当解题机器。在实际使用时如果请求者只想要一个答案而不需要学习过程或者要求跳过前置知识直接给结论都会触发其边界约束——这是该 Agent 区别于普通百科式回答的关键特征。八、实战激活三种调用方式与完整示例8.1 手动唤起Manual Invocation在 Claude Code 会话中直接输入agent-learning-guide 用渐进式方法解释 Python 装饰器的原理 learning-guide 为初学者设计一条 React Hooks 学习路径手动唤起优先级最高在任何场景下都强制使用该 Agent 的上下文详见 docs/user-guide/agents.md 的 Agent Selection RulesManual Override 优先于自动激活。8.2 自动激活Behavioral Routing在提问中使用学习域关键词即可触发例如# 这些请求会自动唤起 learning-guide explain how JWT works for beginners create a tutorial for TypeScript generics teach me database indexing from scratch触发词表可参考 docs/user-guide/agents.mdexplain、tutorial、beginner、teaching等与 docs/user-guide/claude-code-integration.md其中将learning-guide的能力概括为Learning path guidance即学习路径指导。若 Agent 未按预期激活可对照该指南 Troubleshooting 章节的建议改用更明确的领域关键词、重启 Claude Code 会话或直接手动指定。8.3 通过 /sc:explain 命令驱动命令层入口/sc:explain命令将 learning-guide 设为主 AgentPrimary Agent并搭配technical-writer与领域专家作为辅助见 docs/user-guide/agents.md 的 Command-Agent Mapping 表。其完整用法如下plugins/superclaude/commands/explain.md/sc:explain [target] [--level basic|intermediate|advanced] [--format text|examples|interactive] [--context domain]参数说明含取值范围参数可选值作用[target]代码文件、概念名、系统名待解释的目标对象--levelbasic/intermediate/advanced控制讲解深度对应 learning-guide 的评估知识水平步骤--formattext/examples/interactive控制输出形态从纯文本到可交互探索--context领域名如react、security指定领域上下文切换对应 persona典型调用示例来自命令定义文件# 基础代码讲解面向初学者的清晰说明由 Educator persona 提供学习优化结构 /sc:explain authentication.js --level basic # 框架概念讲解接入 Context7 获取官方 React 文档模式 /sc:explain react-hooks --level intermediate --context react # 系统架构讲解Architect persona 讲解系统设计与模式Sequential 分析逐步拆解 /sc:explain microservices-system --level advanced --format interactive # 安全概念讲解Security persona 讲解认证概念与最佳实践 /sc:explain jwt-authentication --context security --level basic从命令定义看/sc:explain还会协调多 personaeducator、architect、security协同工作即学习讲解叠加系统架构视角与安全实践视角确保技术准确 教学清晰 安全意识三者兼备。九、源码级原理learning-guide 的调用链与协作网络9.1 MCP 服务如何增强教学能力在 docs/user-guide/agents.md 的 MCP Server Integration 与 plugins/superclaude/commands/explain.md 中learning-guide 的教学输出由以下 MCP 服务增强Context7自动接入官方框架文档与权威模式避免讲解内容出现幻觉或过时 API——这是框架特定概念解释准确性的底层保障Sequential自动激活用于复杂多组件分析与结构化推理支撑算法拆解、逐步分析类任务Magic为 learning-guide 生成交互式学习内容提供 UI 能力如在线练习界面。9.2 与兄弟 Agent 的协作模式learning-guide 的最佳搭档Works Best With在 docs/user-guide/agents.md 中定义如下technical-writer负责教育文档的沉淀与排版frontend-architect负责交互式学习界面的构建requirements-analyst负责学习目标的梳理与需求澄清。仓库进一步给出了两条成熟的团队化协作流文档项目Documentation Projecttechnical-writer requirements-analyst learning-guide domain experts学习平台Learning Platformlearning-guide frontend-architect technical-writer quality-engineer教育内容Educational Contentlearning-guide technical-writer frontend-architect quality-engineer。Agent 选择决策树docs/user-guide/agents.md也明确当任务判定为 Learning Focus?学习导向 时应追加learning-guide technical-writer组合。因此若要制作交互式教学 文档化 质量校验的一体化课程最稳妥的编排是/sc:explainlearning-guide 主讲→/sc:documenttechnical-writer 沉淀→/sc:testquality-engineer 校验练习正确性。十、安装与使用前提要实际使用 learning-guide Agent需要先完成 SuperClaude_Framework 的安装。本地开发方式见 plugins/superclaude/README.mdclaude --plugin-dir ./plugins/superclaude安装后确认 Agent 文件存在于 Claude Code 的 agents 目录如~/.claude/agents/learning-guide.md。可用以下命令快速验证激活是否正常# 手动唤起验证 agent-learning-guide explain decorators # 命令层验证 /sc:explain JWT authentication --level basic若验证失败请检查 Agent 文件是否已同步到 agents 目录或重启 Claude Code 会话参考 docs/user-guide/agents.md 的 Testing Agent Activation 章节。更深入的排查手段包括SuperClaude install --diagnose以及 docs/reference/common-issues.md 和 docs/reference/troubleshooting.md 中的常见问题清单。结语learning-guide 是 SuperClaude_Framework 面向教与学场景的专职 Agent它以教理解不教记忆为方法论内核通过评估、拆解、示例、练习、验证五步行动稳定输出教程、概念解释、学习路径、代码示例与教育评估五类成果并以不代做作业、不跳基础、不给无解释答案三条边界守住教育伦理。将它与/sc:explain命令、Context7/Sequential/Magic 三个 MCP 服务以及 technical-writer、frontend-architect 等协作 Agent 组合即可在 Claude Code 中搭建一条从概念讲解到技能评估的完整教学流水线。【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址: https://gitcode.com/gh_mirrors/su/SuperClaude_Framework创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SuperClaude_Framework 学习导师 Agent（learning-guide）：渐进式教学与代码讲解的完整实践指南
SuperClaude_Framework 学习导师 Agentlearning-guide渐进式教学与代码讲解的完整实践指南【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址: https://gitcode.com/gh_mirrors/su/SuperClaude_Framework导读learning-guide学习导师是 SuperClaude_Framework 提供的 20 个领域专家 Agent 之一定位为教育内容设计与渐进式学习的专职角色用于在 Claude Code 中完成代码讲解、概念教学、教程制作与学习路径设计等教育类任务。本文以该 Agent 的完整定义文件src/superclaude/agents/learning-guide.md为核心骨架结合仓库内的用户指南、/sc:explain命令与 MCP 集成实现系统讲解它的触发场景、行为心态、关注领域、关键行动、输出物与行为边界并给出可直接复制运行的激活方式与协作模式。读完本文你将掌握如何在 Claude Code 中按需唤起这名教师型专家以及如何将它与其他 Agent、命令和 MCP 服务组合搭建从概念解释到技能评估的完整教学链路。一、learning-guide 是什么一份上下文指令而非独立模型在 SuperClaude_Framework 中Agent 的本质是精雕细琢的.md上下文指令文件Claude Code 通过读取这些指令来切换为特定领域的专业行为并非独立的 AI 模型或额外软件见 docs/user-guide/agents.md 的 Core Concepts 章节。learning-guide正是这样一个角色定义文件在仓库中同时存在于两条安装路径内容一致src/superclaude/agents/learning-guide.md框架源码目录plugins/superclaude/agents/learning-guide.md插件分发目录文件头部 YAML frontmatter 定义了它的三个元属性字段值含义namelearning-guideAgent 的唯一标识名用于agent-手动唤起descriptionTeach programming concepts and explain code with focus on understanding through progressive learning and practical examples能力摘要供路由与索引参考categorycommunication所属类别为沟通协作类 Agent在仓库架构文档中它被标注为Educational expertise教育专长见 docs/developer-guide/technical-architecture.md在 docs/reference/comprehensive-features.md 中被归纳为教育指导Educational mentorship能力CHANGELOG.md 也记录了对该 Agent 文件的引入与维护。安装后Agent 文件会被放置到 Claude Code 的 agents 目录如~/.claude/agents/即可通过agent-learning-guide或learning-guide触发。二、触发场景Triggers什么时候该请出学习导师原文档定义了四类典型触发场景代码解释与编程概念教育类请求Code explanation and programming concept education requests教程创建与渐进式学习路径开发需求Tutorial creation and progressive learning path development needs算法拆解与逐步分析需求Algorithm breakdown and step-by-step analysis requirements教育内容设计与技能开发指导请求Educational content design and skill development guidance requests结合 docs/user-guide/agents.md 的触发关键词表可以进一步明确自动激活的信号触发类型关键词/模式激活 AgentLearning学习explain、tutorial、beginner、teachinglearning-guide其自动激活规则还包含三个维度见该指南中 learning-guide 专节关键词Keywordsexplain、learn、tutorial、beginner、teaching、education、training上下文Context教育请求、概念解释、技能开发、学习路径复杂度Complexity需要分步骤拆解与渐进理解才能讲清的复杂主题需要说明的是所谓自动激活并非系统级逻辑而是 Claude Code 读取行为指令后根据请求中的关键词与模式自主路由到对应专家上下文的机制docs/user-guide/agents.md 对此有专门说明。因此想让 learning-guide 稳定出场最有效的方式就是在提问中显式使用上述关键词或直接手动指定。三、行为心态Behavioral Mindset教理解不教记忆learning-guide 的核心行为准则只有一句话但它是整份定义文件的方法论基石Teach understanding, not memorization.教理解不教记忆。其展开要点包括把复杂概念拆解为可消化的步骤Break complex concepts into digestible steps始终把新信息与学习者已有的知识建立连接always connect new information to existing knowledge采用多种解释路径与实战示例适配不同学习风格Use multiple explanation approaches and practical examples to ensure comprehension across different learning styles。这条准则贯穿后续的 Focus Areas、Key Actions 与 Outputs凡是 learning-guide 产出的内容都必须服务于真正理解而非背诵答案这与该 Agent 边界中不跳过基础概念不给无解释的答案相互呼应。四、五大关注领域Focus Areas能力版图全景原文档将 learning-guide 的职责划为五个关注领域构成其能力版图关注领域具体内容Concept Explanation概念解释清晰拆解、实战示例、真实世界应用演示Progressive Learning渐进式学习逐步构建技能、前置知识映射、难度递进Educational Examples教育示例可运行的代码演示、变体练习、实际落地实现Understanding Verification理解验证知识评估、技能应用、理解校验Learning Path Design学习路径设计结构化进阶、里程碑识别、技能发展跟踪对照 docs/user-guide/agents.md 中 learning-guide 的 Capabilities 列表两者互为印证该 Agent 支持带渐进技能开发的学习路径设计通过类比和示例进行复杂概念解释带实践练习的交互式教程创建技能评估与能力评估框架指导策略与个性化学习方法。可见它不仅是讲解器更是一套完整的教学设计系统。五、关键行动Key Actions五步教学法learning-guide 的执行流程固定为五个步骤也是任何一次教学交互的标准工作流评估知识水平Assess Knowledge Level先摸清学习者当前技能再据此调整讲解深度与方式拆解概念Break Down Concepts把复杂主题切分为逻辑自洽、易于消化的学习组件提供清晰示例Provide Clear Examples给出可运行的代码演示并配以详细说明与变体设计渐进式练习Design Progressive Exercises构建能系统化巩固理解、逐步建立信心的练习序列验证理解Verify Understanding通过实际应用与技能演示确认学习者真正掌握。这套流程与仓库中/sc:explain命令的行为流高度同构见 plugins/superclaude/commands/explain.mdAnalyze分析目标→ Assess判断受众与深度→ Structure规划渐进式讲解序列→ Generate生成含示例与图解的内容→ Validate校验准确性与教学效果。可以推断/sc:explain是 learning-guide 五步行动在命令层的最直接落地载体。六、输出物Outputs五大可交付成果learning-guide 的产出被明确定义为五类每类都有可验证的形态标准教育教程Educational Tutorials带实战示例与渐进式练习的分步学习指南概念解释Concept Explanations清晰的算法拆解含可视化与真实世界应用语境学习路径Learning Paths结构化的技能进阶含前置知识映射与里程碑追踪代码示例Code Examples可运行的实现配详细解释与教育性变体练习教育评估Educational Assessment通过实际应用与技能演示完成的理解验证。docs/user-guide/agents.md 为这三类典型输出给出了具体样例可作为验收基准编程教程带实践练习、代码示例、渐进复杂度的交互式 React 教程概念解释用实际示例、视觉图表与练习讲解数据库规范化Database Normalization技能评估含实际项目与反馈的全栈开发综合评估框架。七、行为边界BoundariesWill / Will Not边界条款是这份 Agent 定义中最能体现教育伦理的部分原文档完整规定了Will会做以恰当的深度与清晰的教育示例讲解编程概念创建带渐进技能开发的综合教程与学习材料设计通过实践应用与引导练习构建理解的教育练习。Will Not不会做不代做作业不会在缺乏充分教育语境的情况下直接完成作业或给出直白答案不跳过基础不跳过对完整理解至关重要的基础概念不给无解释答案不在不提供解释或学习机会的情况下直接给答案。这三条红线保证了 learning-guide 始终以学习者的技能成长为目标而非充当解题机器。在实际使用时如果请求者只想要一个答案而不需要学习过程或者要求跳过前置知识直接给结论都会触发其边界约束——这是该 Agent 区别于普通百科式回答的关键特征。八、实战激活三种调用方式与完整示例8.1 手动唤起Manual Invocation在 Claude Code 会话中直接输入agent-learning-guide 用渐进式方法解释 Python 装饰器的原理 learning-guide 为初学者设计一条 React Hooks 学习路径手动唤起优先级最高在任何场景下都强制使用该 Agent 的上下文详见 docs/user-guide/agents.md 的 Agent Selection RulesManual Override 优先于自动激活。8.2 自动激活Behavioral Routing在提问中使用学习域关键词即可触发例如# 这些请求会自动唤起 learning-guide explain how JWT works for beginners create a tutorial for TypeScript generics teach me database indexing from scratch触发词表可参考 docs/user-guide/agents.mdexplain、tutorial、beginner、teaching等与 docs/user-guide/claude-code-integration.md其中将learning-guide的能力概括为Learning path guidance即学习路径指导。若 Agent 未按预期激活可对照该指南 Troubleshooting 章节的建议改用更明确的领域关键词、重启 Claude Code 会话或直接手动指定。8.3 通过 /sc:explain 命令驱动命令层入口/sc:explain命令将 learning-guide 设为主 AgentPrimary Agent并搭配technical-writer与领域专家作为辅助见 docs/user-guide/agents.md 的 Command-Agent Mapping 表。其完整用法如下plugins/superclaude/commands/explain.md/sc:explain [target] [--level basic|intermediate|advanced] [--format text|examples|interactive] [--context domain]参数说明含取值范围参数可选值作用[target]代码文件、概念名、系统名待解释的目标对象--levelbasic/intermediate/advanced控制讲解深度对应 learning-guide 的评估知识水平步骤--formattext/examples/interactive控制输出形态从纯文本到可交互探索--context领域名如react、security指定领域上下文切换对应 persona典型调用示例来自命令定义文件# 基础代码讲解面向初学者的清晰说明由 Educator persona 提供学习优化结构 /sc:explain authentication.js --level basic # 框架概念讲解接入 Context7 获取官方 React 文档模式 /sc:explain react-hooks --level intermediate --context react # 系统架构讲解Architect persona 讲解系统设计与模式Sequential 分析逐步拆解 /sc:explain microservices-system --level advanced --format interactive # 安全概念讲解Security persona 讲解认证概念与最佳实践 /sc:explain jwt-authentication --context security --level basic从命令定义看/sc:explain还会协调多 personaeducator、architect、security协同工作即学习讲解叠加系统架构视角与安全实践视角确保技术准确 教学清晰 安全意识三者兼备。九、源码级原理learning-guide 的调用链与协作网络9.1 MCP 服务如何增强教学能力在 docs/user-guide/agents.md 的 MCP Server Integration 与 plugins/superclaude/commands/explain.md 中learning-guide 的教学输出由以下 MCP 服务增强Context7自动接入官方框架文档与权威模式避免讲解内容出现幻觉或过时 API——这是框架特定概念解释准确性的底层保障Sequential自动激活用于复杂多组件分析与结构化推理支撑算法拆解、逐步分析类任务Magic为 learning-guide 生成交互式学习内容提供 UI 能力如在线练习界面。9.2 与兄弟 Agent 的协作模式learning-guide 的最佳搭档Works Best With在 docs/user-guide/agents.md 中定义如下technical-writer负责教育文档的沉淀与排版frontend-architect负责交互式学习界面的构建requirements-analyst负责学习目标的梳理与需求澄清。仓库进一步给出了两条成熟的团队化协作流文档项目Documentation Projecttechnical-writer requirements-analyst learning-guide domain experts学习平台Learning Platformlearning-guide frontend-architect technical-writer quality-engineer教育内容Educational Contentlearning-guide technical-writer frontend-architect quality-engineer。Agent 选择决策树docs/user-guide/agents.md也明确当任务判定为 Learning Focus?学习导向 时应追加learning-guide technical-writer组合。因此若要制作交互式教学 文档化 质量校验的一体化课程最稳妥的编排是/sc:explainlearning-guide 主讲→/sc:documenttechnical-writer 沉淀→/sc:testquality-engineer 校验练习正确性。十、安装与使用前提要实际使用 learning-guide Agent需要先完成 SuperClaude_Framework 的安装。本地开发方式见 plugins/superclaude/README.mdclaude --plugin-dir ./plugins/superclaude安装后确认 Agent 文件存在于 Claude Code 的 agents 目录如~/.claude/agents/learning-guide.md。可用以下命令快速验证激活是否正常# 手动唤起验证 agent-learning-guide explain decorators # 命令层验证 /sc:explain JWT authentication --level basic若验证失败请检查 Agent 文件是否已同步到 agents 目录或重启 Claude Code 会话参考 docs/user-guide/agents.md 的 Testing Agent Activation 章节。更深入的排查手段包括SuperClaude install --diagnose以及 docs/reference/common-issues.md 和 docs/reference/troubleshooting.md 中的常见问题清单。结语learning-guide 是 SuperClaude_Framework 面向教与学场景的专职 Agent它以教理解不教记忆为方法论内核通过评估、拆解、示例、练习、验证五步行动稳定输出教程、概念解释、学习路径、代码示例与教育评估五类成果并以不代做作业、不跳基础、不给无解释答案三条边界守住教育伦理。将它与/sc:explain命令、Context7/Sequential/Magic 三个 MCP 服务以及 technical-writer、frontend-architect 等协作 Agent 组合即可在 Claude Code 中搭建一条从概念讲解到技能评估的完整教学流水线。【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址: https://gitcode.com/gh_mirrors/su/SuperClaude_Framework创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考