关于 construir
construir 是一项葡萄牙语技能,通过能运行的小项目让概念变得可观察,从而支持学习。它引导学习者完成涉及决策、预测、实现和调试的检查点,并保存学习证据与进度。
主要功能
- 01构建可运行的概念项目
- 02按检查点提供指导
- 03学习者参与与反馈
- 04跟踪项目状态和学习证据
- 05移交回 aprender
适用场景
- 01在可执行项目中探索机制
- 02在引导检查点练习实现
- 03调试与概念相关的故障
- 04通过项目继续学习会话
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ kipperacademy/ skillpper --skill construir安装后在 Claude Code 中输入/construir确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CHECKPOINTS.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详细介绍
构建一个能够运行、并让某个概念变得可观察的最小项目。交替进行决策、预测、实现和调试,并让学习者参与其中。构建过程应服务于学习任务。
1. 接收或继续
阅读 WORKSPACE-FORMAT.md 和 PROFILE.md。如果是从学习流程转入,请阅读 HANDOFF.md 和已保存的上下文;使用现有的学习任务、目录和证据。 只有在新会话中或数据缺失时,才需要重新查询个人资料。
已有项目应从其检查点继续,并处理待解决的帮助请求。直接进入时,使用 MISSION-FORMAT.md 创建学习任务;目标模糊时可以先设定临时结果。 记录事件前,请阅读 EVENTS-FORMAT.md。只有在开启新主题时才记录请求。 如果已有学习计划,请予以保留。
完成标准: 已确定学习任务、可用证据和下一个检查点。
2. 提议项目
仅当偏好和上下文不足时,才确认编程语言。选择能展现其运行机制的最小项目:对主题之外的内容采用简单默认设置,只需一个命令即可运行,并在 README 中说明简化之处。如果技术本身就是主题,请明确说明最低限度的准备工作,并协助完成,而不要承诺无需依赖项。
用几行说明项目成果和 3 到 6 个检查点,以及每个检查点要呈现的可观察行为。按照运行机制的依赖关系、相关难度和对学习任务的推进顺序排列;不能在学习者掌握必要基础、能够进行尝试之前就安排尚未解决的问题。
阅读 PLAN-FORMAT.md。学习者接受后,在新文件夹中创建项目;如果学习者提出要求,也可以使用当前仓库。在已有仓库中,请阅读适用的说明并保留现有工作。将 project_path 保存到学习任务中,并将计划保存到 BUILD.md。
完成标准: 范围已获接受,路径已保存,且第一个检查点及其预期行为已明确。
3. 完成一个检查点
阅读 CHECKPOINTS.md 以准备每个检查点,并阅读 shared/EVIDENCE.md 以解读回答和提供帮助。 提前准备好主题之外的基础设施。选择一个核心参与方式:给出有理由的决策、进行预测、实现概念相关部分,或调试故障。
如果检查点要求在函数或类中实现代码,请阅读 GUIDED-CODE.md:提供背景,并在编辑位置使用结构化注释引导学习者完成工作。
先让学习者尝试,再揭示解决方案。通过搭建脚手架和提供提示来支持尝试; 如果学习者已经展示出对运行机制的理解,就推进到新的决策。当学习者更希望由 AI 编写时,请先让其做出相关预测或决策,然后执行结果并与预测或决策进行对照。
如果其他形式的表达有所帮助,请阅读 DRAWING-FORMAT.md。 每次参与后都要提供反馈、记录证据并更新 BUILD.md。更换表达形式和提供明确帮助,是为陷入困境的学习者提供的支持,而不是惩罚。
完成标准: 已运行该行为并与预期结果进行比较;学习者的贡献和获得的帮助均已记录。即使仍有知识缺口,经过协助的检查点也可以继续推进;仅有 AI 编写的代码并不能证明学习已经发生。
4. 完成并交接
端到端运行项目。更新 README,说明命令、机制和简化之处。 要求在全新情境中应用:改变行为、诊断故障,或预测未展示的变化。记录已演示的内容,以及仍需帮助的部分。
保存概念参考资料。阅读 LEARNING-RECORD-FORMAT.md,了解本地记录格式。 如果内容来自学习,请使用 HANDOFF.md 交接证据和下一步;继续当前已开始的学习流程,或提供 /aprender,并要求在另一个聊天中继续。选择留在 项目中会让构建流程保持活动状态。直接进入的项目可以不经过学习流程而完成。
**完成标准:**项目可运行,结果或故障已明确说明,证据和后续步骤已保存。完成项目不会授予成就;官方评估由 Kipper 决定。
对话
每轮以一个核心参与任务为主,并在相关时提供具体反馈和可见输出。在 README 中解释与主题无关的选择;对话应聚焦于所研究的机制。暂停时,保存检查点、修改过的文件、命令、待办任务和已提供的帮助。