用途：按既有的七模块指南进行有边界的本地学习，引擎只选择前置条件已完成的模块，不在当前项目 .claude/learning/ 目录之外保存任何内容，要求非空证据笔记，并拒绝损坏状态。
起步：先运行 /self-assessment quick 再选轨道。它是自我报告辅助，不是认证。结果映射：Beginner→Beginner，Intermediate→Practitioner，Advanced→Production；Maintainer 不是自评结果，仅在目标为共享治理（如维护团队指令、控制或证据实践）时手动选择。选择覆盖当前目标的最低轨道：Beginner（安全的首个日常工作流，模块 01–03）、Practitioner（可复用项目工作流，01–05）、Production（带验证控制的自动化，01–07）、Maintainer（共享实践与治理，01–07）。模块定义、指南引用、练习、前置条件与复习间隔在 assets/path.yaml。
命令（在被学习的仓库或项目中运行，CLAUDE_SKILL_DIR 为 Claude Code 提供的已安装技能目录，--root "$PWD" 使当前项目成为唯一状态目标）：
python3 "${CLAUDE_SKILL_DIR}/scripts/progress.py" --root "$PWD" init --track Beginner
python3 "${CLAUDE_SKILL_DIR}/scripts/progress.py" --root "$PWD" status
python3 "${CLAUDE_SKILL_DIR}/scripts/progress.py" --root "$PWD" next
python3 "${CLAUDE_SKILL_DIR}/scripts/progress.py" --root "$PWD" complete module-01
--evidence "Installed Claude Code, ran /help, and recorded the version."
python3 "${CLAUDE_SKILL_DIR}/scripts/progress.py" --root "$PWD" due
状态文件为 .claude/learning/claude-code-guide-progress.json，属于学习者项目而非已安装技能。init 拒绝覆盖已有状态文件。除非有意共享证据，否则保持状态本地。
完成门槛：完成模块前需阅读链接的指南页、在真实项目中做链接的练习、记录他人可检查的具体证据笔记（如命令、更改的文件、测试结果或评审产物），并用 next 获取下一个解锁模块。空笔记、未满足前置条件、未知模块、所选轨道之外的模块或损坏状态均为错误。工具不会根据百分比、命令退出码或学习者断言推断完成。
复习：每次完成会精确安排在记录完成日期后的 1、3、7、14、30、60、90 天复习。due 返回今天或之前到期的所有复习。若知识已变化，重访链接练习并更新单独的证明产物。
安全边界：所有写入均为本地且原子。格式错误的状态文件会失败关闭并保持原样以供检查或恢复。原型不调用网络服务、不安装包、不自动评估能力、不编辑指南。
验证边界：运行时用 Python 的 JSON 解析器验证 path.yaml，因为该文件使用 YAML 的 JSON 子集。捆绑的 quick_validate.py 技能验证器在解析 SKILL.md frontmatter 前导入 PyYAML；若该导入失败，此 frontmatter 验证为 UNKNOWN，而非成功的技能验证。无依赖的运行时测试仍可确认此确切路径定义可加载。