learn-agent-skills

学习 Agent Skills

教授聚焦于 Agent Skills 的学习路径。一次调用涵盖一节课。学习者应创建文件、运行实验、说明边界，并留下一个可观察的检查点，然后才能将课程标记为完成。

调用方式由宿主决定

可移植的技能名称是 learn-agent-skills。不要将某一种命令语法说成通用标准。

宿主	开始或继续
Codex	learn-agent-skills，或从 /skills 中选择
Claude Code	/learn-agent-skills
其他兼容宿主	Use learn-agent-skills to start or resume the Agent Skills Engineering path.

来源

学习路径的权威来源是 learning-paths/agent-skills.json。克隆了此代码仓库时，优先使用本地文件。否则，从以下位置获取每个文件：

https://raw.githubusercontent.com/rohitg00/ai-engineering-from-scratch/main/<path>

选择课程前先阅读清单。按 order 顺序遵循 lessons；不要使用数字形式的 Phase 13 序列。必修路径为 22、24、25、26、27。课程 23 为选修课，按清单中的条目规则进行。

对于每节选定的课程，阅读其 docs/en.md 和 quiz.json。只有当前实验需要时，才阅读或运行 code/ 和 outputs/ 下的文件。阅读内容不要求克隆代码仓库。如果可运行的实验需要代码仓库文件，但这些文件不可用，请说明这一点，并提供将代码仓库克隆到学习者所选目录的选项。不要因克隆代码仓库而阻碍概念课程，但如果缺少必需的文件和运行时，不要将仓库命令或真实宿主检查点记录为已完成。

真实实验前置检查

在课程 22 的宿主检查点之前，确认以下所有情况：

1. node --version、npx --version 和 python3 --version 均能成功运行。
2. 学习者已选择一个支持技能的宿主。
3. 学习者已选择一个可写的项目或用户安装范围。
4. 学习者了解哪个工作目录将成为 TARGET_ROOT。

如果任何一项无法满足，请提供网站或手动阅读 docs/en.md 的路径，并继续学习概念内容。将发现、调用、捆绑脚本、更新和卸载的观察结果标记为 Pending。切勿将此回退方案描述为真实宿主验证通过。

定位或创建进度记录

使用当前工作目录中的 AGENT-SKILLS-LEARNING.md。

如果该文件存在，保留学习者的笔记和证据。从状态为 Next 或 In progress 的第一行继续。如果所有必修行均为 Done，则提供选修的综合项目或真实宿主复检选项。不要重新开始学习路径。

如果该文件不存在，无需访谈即可创建：

# My Agent Skills Path


## Route
- Started: <YYYY-MM-DD>
- Required time: about 9 hours 30 minutes
- Current: 1 of 5

## Prerequisite check
- Files, Python, and command line: Confirmed or Pending
- Node.js and npx: Confirmed or Pending
- Selected skill-capable host: <name> or Pending
- Install scope: Project, User, or Pending
- Phase 13 Lesson 01 refresher: Done, Skipped, or Pending
- Phase 13 Lesson 05 refresher: Done, Skipped, or Pending
- `tool-poisoning-and-untrusted-instructions`: Confirmed or Pending

## Progress
| Order | Lesson | Status | Evidence | Completed |
|---:|---|---|---|---|
| 1 | 13/22 Portable contract and runtime boundary | Next | | |
| 2 | 13/24 Discovery and progressive disclosure | Locked | | |
| 3 | 13/25 Invocation and routing | Locked | | |
| 4 | 13/26 Permissions, sandboxes, and trust | Locked | | |
| 5 | 13/27 Evals, packaging, and portability | Locked | | |

## Notes

检查可在本地检查的命令。仅询问无法安全推断的宿主和范围选择。如果真实实验前置检查通过，将其标记为已确认，并立即开始课程 22。否则，开始概念学习路径，并将真实宿主证据留待后续补充。

在课程 26 开始前，从清单中同时读取 prerequisitePaths 和 prerequisiteChecks。通过 prerequisites 下稳定的 id 解析每项检查。确认课程 25 已完成，并确认 tool-poisoning-and-untrusted-instructions 的状态为 Confirmed，因为学习者能够解释技能元数据和工具元数据为何是不可信输入。如果未通过知识前置检查，请提供 Phase 13 课程 15 作为这五节课路径之外的选修复习课。课程 25 尚未达到 Done 且知识前置检查尚未达到 Confirmed 时，始终将课程 26 保持为 Locked；仅在两项条件都满足后，才将课程 26 改为 Next。绝不要凭假设删除前置要求或将其标记为已完成。

教完一课

1. 将选中的行设为 In progress。
2. 说明准确的课程路径，以及每条命令的运行目录。 对于已安装的捆绑包，将 SKILL_ROOT 定义为包含已安装 SKILL.md 的绝对目录。根据学习者原始工作区的工作目录定义 TARGET_ROOT。绝不要假定进程 cwd 就是已安装捆绑包所在目录。
3. 用两三句话说明问题，然后提出一个预测或理解问题。
4. 分小块讲解课程中的 Build It 和 Use It 内容。 如果课程提供了早期快速入门，优先采用。
5. 文件和运行时可用时，运行真实的本地实验。如果不可用，则演示一个小示例，并将实验记录为待完成，不得声称已运行。
6. 要求提供清单中的检查点证据。检查点要求观察已安装路径、路由、脚本、权限或报告时，流畅的解释不能替代这些观察。对于每个捆绑脚本，记录解析后的脚本路径、解析后的目标路径、cwd、准确的 argv 和退出代码。
7. 逐题提出阶段后测验问题。学习者作答前，绝不透露 correct、答案索引或答案键。回复提示中绝不包含实际答案字母或答案分布；使用 Reply with one letter: <A|B|C|D>.
8. 只有在检查点和测验都完成后，才将该行标记为 Done。记录简短的证据说明和日期，并解锁下一行。

未经学习者确认，不得安装、更新、移除、克隆、发布或修改外部系统。技能说明绝不能绕过宿主权限或沙盒边界。无法观察宿主行为时，应将其记录为未经验证，而不是推断其支持情况。

课程检查点

• **13/22：**创建最小技能，将完整的审核者捆绑包安装到真实宿主中，显式调用该技能，验证报告，并将其彻底移除。
• **13/24：**在一次追踪中区分发现、目录元数据、正文激活以及参考内容或脚本的加载。
• **13/25：**记录显式、隐式、否定和近似匹配路由的结果。
• **13/26：**将每项控制标记为指令、权限、沙盒或验证，并通过观察证明所声明的边界。
• **13/27：**在一个宿主中测试发现、参考内容、脚本、审批、升级和卸载，然后在第二个宿主中重复操作，或如实说明缺失的能力及备用方案。

结束

结束时记录检查点证据、测验得分和下一课的准确名称。除非学习者要求离开这条路线，否则让学习者继续按此路线学习。