re0-tutorial

通过三个级别推进由人选择的练习，对学习者提交的作品评分，并追加一条私有尝试记录。

目标

依次教授一项技能的最佳实践、对组合的推理，以及在真实问题中的应用。完成仅表示提交的练习符合其约定。人的完成情况和迁移能力仍未测量；模拟学习者和调用轨迹都无法衡量学习效果。

工作流

1. 仅在收到人工调用时开始。商定目标、级别和练习标识符。阅读已安装目标技能及其约定，包括 Verification。根据技能的教学内容选择技能，不要偏好某条调用路径。在学习者开始前说明所需提交内容和评分标准。
2. 使用下表定义级别。解释任务及其触发条件，但不要代替学习者执行步骤、生成其提交内容，或提供 L3 的组合。等待学习者完成任务。
3. 恢复时，从此技能文件夹运行 node scripts/attempt.mjs --exercise <id> --skills <skill folders...> [--json]，并传入练习所用的技能文件夹。该脚本会对其内容生成摘要并统一换行符，读取 .re0/tutorial/<exercise>/ 下的练习记录，将最新记录与当前安装版本进行比较，并打印状态（fresh、match、version-only、content-difference、stale 或 unreadable）以及下一个未使用的尝试记录路径。退出代码：0 表示 fresh、match 或 version-only；3 表示 content-difference 或 stale；4 表示 unreadable；2 表示用法错误，即运行失败：修正命令后重新运行。根据该状态应用下方的恢复规则；不要擅自替换为更名后的依赖项。
4. 检查提交是否存在并确认作者身份，然后依据该级别的标准评分。记录决定性证据和理由。调用、参与者标签或主机轨迹只能提供上下文，不能证明学习者的表现，也不能消除作者身份上的歧义。
5. 在第 3 步打印的 next path 位置写入一条新的、不可变的尝试记录（.re0/tutorial/<exercise>/<version>-<attempt>.local.md）；首次尝试时，脚本也会打印该路径。报告评分、需要澄清的事项以及记录路径。只有 completed 评分才能获得练习完成徽章。

级别	学习者的任务和所需提交内容	评分标准
L1	选择一个自己实际创作的作品，应用一项技能，并提交生成的作品。	指明触发条件，并引用目标技能自己的 Verification 部分；依据该部分检查作品，绝不能依据课程文本检查。
L2	完成给定的两个或更多技能的组合；提交生成的作品，以及自己撰写的关于顺序、省略步骤和执行权限的说明。	检查每一步为何先于下一步、为何省略某项步骤，以及根据已发布的约定，每一步必须由谁执行；同时检查作品。若“无需跳过”或“此处没有仅限用户执行的步骤”的理由充分且符合实际，则可通过。缺少推理，或虚构跳过步骤或仅限用户执行的步骤，则不通过。
L3	从当前代码库中的真实文件抽取一道经过刻意随机化的问题，自行选择组合，并提交生成的作品。	判断作品是否能够独立解决所述问题，绝不评判过程叙述。由 Agent 提供的组合不通过。

评分

按以下顺序应用这些判定，确保每份提交只获得一个评分：

1. 缺少必需的成果或账户：not-completed，不颁发徽章。
2. Agent 完成了要求的工作：not-completed，不颁发徽章；绝不判为“在协助下完成”。
3. 提交已提供，但结论不明确，或无法确定、无法明确确认学习者是否为作者：not-completed，附上 pending-clarification 说明，指出能解决问题的具体学习者证据，不颁发徽章。不得根据轨迹推断答案。
4. 已确认由学习者完成，且通过该级别的所有标准：completed；徽章仅表示完成了本练习。任何一项标准的明确失败都应判为 not-completed，说明原因且不颁发徽章。

本地记录与恢复

每条记录包含 exercise、version、attempt、learner-action、evidence 和 result；其中，evidence 是学习者提交的成果或账户，应予以保留或持久化引用。添加明确标注为仅供参考背景的 actor 和 host-trace，以及标识已安装技能及其内容的 skill-set digest，以便区分练习依赖项的变化与无关的版本变化。记录级别、依赖项标识、评分依据、原因，以及解读本次尝试所需的任何澄清或前序记录链接。

记录簿仅供其所有者查看，保存在本机中，由 .re0/ 和 *.local* 忽略，且绝不随项目分发。保留失败和放弃的尝试，并注明原因。绝不编辑、覆盖或删除已有记录。对已有记录的尝试进行重复恢复时，应创建一条关联到前一条记录的新记录，绝不能修订原记录。只有新的学习者证据才能在后续记录中改变先前的 not-completed 判定。

• 如果版本和摘要匹配，则从已保存的位置继续练习。继续尚未记录的尝试不会创建重复记录；一旦已有记录，后续记录必须使用新的尝试标识符。
• 如果只有已安装的版本不同，且练习自身的技能未发生变化，则继续练习，并在新的关联记录中注明差异。版本差异本身既不能判定提交通过，也不能判定失败。
• 在常规恢复时，如果某个依赖项的名称未变，但其已安装内容与记录的技能集摘要不同，则保留先前记录，并在新的关联尝试记录中注明内容差异。如果练习中引用的 Verification 段落在当前技能正文中仍然逐字一致，则继续练习，并依据该段落评分。如果该段落缺失，则必需文本缺失：按照过时规则将先前尝试归类为 stale，并开启新的带版本标记的尝试，不颁发徽章。
• 如果依赖项已重命名、停用或缺失，则在新的当前版本尝试记录中将先前尝试归类为 stale，并引用先前记录。保留先前文件及其原始版本和结果不变，并开启新的练习尝试，不颁发徽章。不得将旧练习重新映射到重命名后的技能，也不得假装依赖项仍然存在来评分。
• 中断记录为 incomplete，与 failed 不同。只有版本匹配时，才能继续中断的练习；否则应开启新的带版本标记的尝试。此中断规则优先于常规的仅版本变化恢复规则。
• incomplete、failed 和 stale 描述的是尝试的生命周期状态，不是额外的提交评分。它们均不颁发徽章。

规则

• 由用户主动发起：开始分级练习必须是学习者的主动选择。
• 对提交内容评分并记录尝试；绝不替学习者完成练习、撰写其作品或账号内容，也不把角色扮演其行动当作学习证据。仅限用户执行的操作应留给人类主动发起。
• 即使存在流水线，也要保留 L2：固定的执行顺序不能证明学习者具备关于顺序、遗漏和权限的推理能力。
• 推进练习；将目录导航和路由交由其他部分处理。无需安装指南。不要把课程变成执行流水线或通用工作流推荐器。
• 不声称具备能力、获得认证或排名，也不声称学习效果经过测量。人类迁移能力需要人类将技能应用于新任务，本教程不会对此进行测量。

验证

完成前，按照规则核对以下七种互不重叠的情形。恢复情形应在提交评分前决定生命周期处理方式；它们不能代替提交评分。每行只有一种结果和一种记录操作。

情形	唯一结果	唯一记录操作
存在：所有必需作品均可确认为学习者本人撰写，符合级别标准，且依赖项有效。	completed，仅授予练习徽章。	写入一条新的尝试记录，包含提交证据、契约检查结果和徽章。
缺失：缺少必需作品或账号。	not-completed，不授予徽章。	写入一条新的尝试记录，注明缺失的提交内容。
无法确定：必需作品已提交但无法得出结论，或者作者身份未知或存在歧义，且尚无证据确认由 Agent 撰写。	not-completed，附带 pending-clarification 注记，不授予徽章。	写入一条新的尝试记录，准确说明需要哪些学习者证据才能判定。
Agent 撰写：必需作品已提交，且已确认由 Agent 生成。	not-completed，不授予徽章。	写入一条新的尝试记录，将 Agent 生成的作品列为未通过原因。
依赖项过期：恢复时，必需技能已重命名、弃用或缺失。	之前的尝试标记为 stale；不授予新徽章。	写入一条新的当前版本尝试记录，将其关联的前置尝试标记为过期，同时完整保留前置记录文件。
仅版本不同：普通恢复，并非中断的尝试，且练习依赖项未变。	允许恢复；现有评分不变，版本检查不产生新徽章。	写入一条新的关联尝试记录，注明版本差异以及依赖项对比结果未变。
依赖项仅内容不同：普通恢复，依赖项名称未变，但已安装内容与记录中的技能集摘要不同，无论版本是否有差异。	如果当前技能正文中仍逐字包含所引用的 Verification 段落，则允许恢复，并依据该段落评分；否则，由于缺少必需文本，按照现有过期规则将之前的尝试标记为 stale，并开启一条标记新版本的尝试，不授予徽章。	写入一条新的关联尝试记录，注明内容差异以及所引用的段落是否仍逐字存在；若不存在，则将前置尝试标记为过期，同时完整保留其文件。

确认每条记录都使用未占用的路径，包含必需字段，且不改动早前的记录。报告实际评分或恢复结果；验证过程中不得声称人类已完成学习或将所学迁移应用。