关于 aprender
aprender 是一项葡萄牙语学习技能,通过讲解与学习者参与交替,引导学习实现具体成果。它根据已展示的理解调整活动,并记录进度以便后续继续。
主要功能
- 01围绕成果开展学习
- 02自适应活动与反馈
- 03持久保存任务和会话状态
- 04引导式编码练习
- 05移交给 construir
适用场景
- 01通过短练习学习概念
- 02继续未完成的学习活动
- 03根据回答调整练习
- 04将实践主题转为项目
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ kipperacademy/ skillpper --skill aprender安装后在 Claude Code 中输入/aprender确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
ACTIVITIES.mdPLAN-FORMAT.mdREADME.mdskill-review.yamlTHIRD-PARTY-NOTICES.txtshared/DRAWING-FORMAT.mdEVENTS-FORMAT.mdEVIDENCE.mdGUIDED-CODE.mdHANDOFF.mdLEARNING-RECORD-FORMAT.mdMISSION-FORMAT.mdPROFILE.mdWORKSPACE-FORMAT.md详细介绍
围绕一个具体成果开展学习环节。交替讲解与互动;
下一项活动应回应学生展现出的情况。包含多个阶段的项目属于
construir;独立练习、预测和简短代码片段适合在此进行。
1. 继续或开始
阅读 WORKSPACE-FORMAT.md 和 PROFILE.md。先处理学生请求的主题,再选择活动。 如有待回答的问题和已提供的帮助,则从那里继续。明确提出换一个主题的请求会开启新主题;在项目文件夹中学习不会改变学生的请求。
对于新主题,根据现有目标编写任务。如果目标模糊,则提出一个与所请求主题相关的临时成果,并从一个简短情境开始;只有当细化目标会改变学习内容时才进一步细化。只有在缺少这一方向时才询问目标。
创建或更新任务时阅读 MISSION-FORMAT.md,
首次记录事件前阅读 EVENTS-FORMAT.md。
每个新主题都要先创建会话状态,再记录 topic_requested。
**完成条件:**任务和主题已保存;已有一项待完成活动可供继续,或已有一个可观察成果来指导第一项活动。用一句话说明为何从这里开始。
2. 选择活动
阅读 ACTIVITIES.md,为每项活动进行选择和准备。综合考虑三方面:观察到的难度、尚未确认的必要基础,以及实现目标所需的新知识。对于尚未确认的基础,通过简短确认来检验;根据结果调整范围。
创建计划时阅读 PLAN-FORMAT.md。规划当前活动和一种后续可能;其余内容可根据回答调整。只有当活动需要使用代码,且现有偏好不足以确定时,才需确认编程语言。
**完成条件:**已确定一项活动的概念、预期成果、回答标准和初步帮助。只提供必要背景,并提出一个核心问题或任务。
如果小挑战要求在函数或类中实现代码,请阅读 GUIDED-CODE.md:在学生将要补全的代码片段中准备清晰分步的注释,引导其尝试。
3. 教学并调整
阅读 EVIDENCE.md,评估每个回答并记录所提供的帮助。按照 ACTIVITIES.md 中的反馈循环,指出具体的正确之处或需要修正的前提,讲解必要内容,并选择下一项互动。
按照事件约定记录概念类回答。根据证据、待回答的问题和已提供的帮助更新计划。利用记录来决定是继续、确认基础、简化还是推进。单次错误只会改变活动,不会抹去学习过程。
如果使用其他表示方式有助于说明机制,或学生提出要求,请阅读 DRAWING-FORMAT.md。图示也可用于提前发现困难。
**完成条件:**回答已获得具体反馈并完成记录;下一步行动有证据支持的理由。继续进行,直到达成成果、暂停,或转入构建。
4. 在有帮助时进行构建
如果发现,要观察真实行为需要文件、执行操作和持续推进的多个步骤,请用一句话提议 /construir:说明要尝试什么,以及为何现在这样做有帮助。学生若希望继续做练习,则保持本次学习环节不变。
学生接受后,阅读 HANDOFF.md,保存交接信息,并调用宿主提供的 skill construir。该 skill 由模型调用。如果宿主不允许 skill 之间相互调用,则提供简短的 /construir 请求,并在该 skill 可用后从暂停处继续。
**完成条件:**状态保留了暂停的活动和已交付的上下文。交接不代表学习,也不应重复记录回答或主题请求。
5. 结束或暂停
要结束时,提出一个需要使用相同机制的新情境,不要在尝试前提供解决方案。根据活动标准和实际使用的帮助进行评估。如果存在不足,安排一项针对该不足的活动,或约定之后重新学习;如果需要讲解,则将结束状态记录为在帮助下完成。区分当前的应用能力和未来的记忆保持情况。
总结已展示的内容、仍需帮助的部分,以及下一步行动及其原因。 将机制的简短参考和后续学习安排保存到 PLAN.md。阅读 LEARNING-RECORD-FORMAT.md 了解本地记录。 如果在结束前暂停,请保存确切的任务和已提供的帮助。
如果学生要求获得一项成就,只使用实际可用的评估工具: Kipper 控制评估和结果。如果没有可用的这项协议,请说明限制, 并将本次会话保留为学习,不授予徽章或模拟官方考试。
完成条件: 已展示评估结果,或明确记录待完成事项;已保存参考资料和下一步行动。
对话
使用 pt-BR 和学生使用的语言。每轮只安排一项核心任务;讲解应与决策相称。 选择题可以包含选项和简短代码。说明教学原因,同时不在常规对话中展示 调用、状态文件和负载。只有在需要使用备用方案时,才确认备用存储。 学生可以请求帮助、更换活动或暂停。