当学习者想创建、发现、调用、加固、评估、打包或移植…

按 Agent Skills Engineering 学习路线，每次调用只教一课，让学习者动手建文件、跑实验、解释边界并留下可观察的检查点。

适用场景

解决思路

1. 以 `learning-paths/agent-skills.json` 为路线唯一事实来源；若已克隆仓库优先读本地文件，否则从 `https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/<path>` 逐个拉取文件。
2. 选课前先读 manifest；按 `lessons` 的 `order` 顺序推进，不要用 Phase 13 的数字顺序；必修路径为 22、24、25、26、27，第 23 课为可选并按 manifest 的进入规则处理。
3. 对每节选中的课，读它的 `docs/en.md` 和 `quiz.json`；仅当当前实验需要时才读或运行 `code/` 与 `outputs/` 下的文件。
4. 若可运行实验需要仓库文件但文件不可用，说明情况并提议克隆到学习者选择的目录；不要因克隆阻塞概念课，但在缺少所需文件和运行时，不要把仓库命令或真实宿主检查点记为完成。
5. 在第 22 课的宿主检查点之前，先确认：`node --version`、`npx --version`、`python3 --version` 均成功；学习者已选定一个支持 skill 的宿主；已选定可写的项目或用户安装范围；学习者理解哪个工作目录将成为 `TARGET_ROOT`。
6. 若上述任一项不可用，给出网站或手动 `docs/en.md` 路径并继续概念教学，把 discovery、invocation、bundled-script、update、uninstall 观察标记为 `Pending`，绝不把这种回退描述为真实宿主通过。
7. 在当前工作目录使用 `AGENT-SKILLS-LEARNING.md` 记录进度；若已存在则保留学习者笔记与证据，从第一行状态为 `Next` 或 `In progress` 处继续；若所有必修行均为 `Done`，提供可选 capstone 或真实宿主复检，不要重开路线。
8. 若文件不存在，不做访谈直接创建，包含标题 `# My Agent Skills Path`、来源注释、Route 段（Started、Required time 约 9 小时 30 分钟、Current: 1 of 5）、Prerequisite check 段（文件/Python/命令行、Node.js 与 npx、选定宿主、安装范围、Phase 13 Lesson 01 与 05 复习、`tool-poisoning-and-untrusted-instructions`）、Progress 表格（5 行：13/22、13/24、13/25、13/26、13/27，含 Order、Lesson、Status、Evidence、Completed）和 Notes 段。
9. 本地能检查的命令就检查；只询问无法安全推断的宿主与范围选择；若真实实验预检通过，标记为已确认并立即开始第 22 课，否则开始概念路径并把真实宿主证据留为 pending。
10. 在第 26 课之前，从 manifest 读 `prerequisitePaths` 和 `prerequisiteChecks`，按稳定 `id` 在 `prerequisites` 下逐项解决；确认第 25 课已完成且 `tool-poisoning-and-untrusted-instructions` 为 `Confirmed`（学习者能解释为何 skill 与 tool 元数据是不可信输入）；若知识预检未满足，提供 Phase 13 Lesson 15 作为本五课路线之外的可选复习；在第 25 课 `Done` 且知识预检 `Confirmed` 之前保持第 26 课 `Locked`，之后才改为 `Next`；绝不假设前置条件已完成。
11. 教一课时：先把选中行设为 `In progress`。
12. 说明确切的课程路径以及每条命令从哪个目录运行；对已安装 bundle，把 `SKILL_ROOT` 定义为包含已安装 `SKILL.md` 的绝对目录，把 `TARGET_ROOT` 定义为学习者原始工作区工作目录；绝不假设进程 cwd 就是已安装 bundle。
13. 用两三句话框定问题，然后问一个预测或理解性问题。
14. 以小步推进课程的 Build It 与 Use It 材料；若课程有早期 quickstart 则优先使用。
15. 当文件与运行时可用时运行真实本地实验；若不可用，追踪一个小例子并把实验记为 pending，而不是声称已运行。
16. 要求 manifest 规定的检查点证据；当检查点要求安装路径、路由、脚本、权限或报告观察时，流畅的解释不能替代观察；对每个 bundled script，记录解析后的脚本路径、解析后的目标路径、cwd、确切 argv 和退出码。
17. 逐个问课后 quiz 问题；在学习者回答前绝不暴露 `correct`、答案索引或答案键；回复提示中绝不放真实答案字母或答案分布，只用 `Reply with one letter: <A|B|C|D>.`。
18. 只有在检查点与 quiz 都完成后才把该行标为 `Done`，记录简洁证据笔记与日期，并解锁下一行。
19. 未经学习者确认，不安装、更新、删除、克隆、发布或改动外部系统；skill 指令绝不绕过宿主权限或沙箱边界；当宿主行为无法观察时，记为未验证而不是推断支持。
20. 完成 13/22 检查点：创建一个最小 skill，把完整 reviewer bundle 安装到真实宿主，显式调用它，验证报告，并干净地移除。
21. 完成 13/24 检查点：在一次追踪中区分 discovery、catalog metadata、body activation 以及 reference 或 script loading。
22. 完成 13/25 检查点：记录 explicit、implicit、negative 和 near-miss 路由结果。
23. 完成 13/26 检查点：把每个控制标记为 instruction、permission、sandbox 或 verification，并用一次观察证明所声称的边界。
24. 完成 13/27 检查点：在一个宿主中演练 discovery、references、scripts、approvals、upgrade 和 uninstall，然后在第二个宿主重复，或如实声明缺失能力与回退方案。
25. 结束时记录检查点证据、quiz 分数和确切的下一课；除非学习者要求离开，否则让其留在此路线。

适用边界 · 注意事项

• 学习者不想按结构化路线学习，或不愿创建文件、跑实验、留下可观察检查点。
• 缺少仓库文件与运行时且无法克隆，此时只能走概念路径，不能声称完成真实宿主检查点。
• 学习者尚未选定支持 skill 的宿主或可写安装范围，无法进行真实实验预检。