SuperAPI AI 工具集

learn-agent-skills

智能体与模型

查看项目

更新于 10-15 21:40

技能介绍

用途:这是 AI Engineering from Scratch 中 Agent Skills Engineering 路线的专注交互 tutor,面向想创建、发现、调用、保护、评估、打包或迁移 Agent Skills 的学习者。每次调用覆盖一节课,学习者需创建文件、运行 lab、解释边界,并在课程标记完成前留下可观察的 checkpoint。

调用方式:可移植 skill 名称为 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/fancyboi999/ai-engineering-from-scratch-zh/main/<path> 获取。选课前先读 manifest,按 lessons 的 order 进行,不要按第 13 阶段数字序列。必修路径为 22、24、25、26、27,第 23 课可选。每节课读取 docs/zh.md 和 quiz.json,仅在当前 lab 需要时读取或运行 code/ 与 outputs/ 下文件。

进度文件:在当前工作目录使用 AGENT-SKILLS-LEARNING.md。存在则保留笔记与证据,从第一个 Next 或 In progress 行继续;全部必修 Done 时提供可选 capstone 或真实宿主复查,不重启路线。不存在则不经访谈直接创建,包含 Route、Prerequisite check、Progress 表格与 Notes。

真实 lab 预检:进行第 22 课宿主 checkpoint 前,需确认 node --version、npx --version、python3 --version 均成功,学习者已选择支持 skill 的宿主、可写入的 project 或 user install scope,并理解哪个工作目录会成为 TARGET_ROOT。项目不可用时给出网站或手动 docs/zh.md 路径并继续概念教学,将 discovery、invocation、bundled-script、update 和 uninstall 观察记录为 Pending,绝不描述成真实宿主通过。

教学与限制:将选中行设为 In progress,说明精确课程路径及每条命令运行目录;已安装 bundle 中 SKILL_ROOT 为包含已安装 SKILL.md 的绝对目录,TARGET_ROOT 由学习者初始 workspace 工作目录定义,不假设进程 cwd 是已安装 bundle。逐题提问 post-stage quiz,学习者回答前不暴露答案。仅在 checkpoint 和 quiz 都完成后标记 Done。没有学习者确认,不安装、更新、移除、克隆、发布或改变外部系统;skill 指令不绕过宿主权限或 sandbox 边界;宿主行为无法观察时记录为未验证。

课程 checkpoint:13/22 创建最小 skill、安装完整 reviewer bundle、显式调用、验证 report 并干净移除;13/24 在一条 trace 中区分 discovery、catalog metadata、body activation 与 reference 或 script loading;13/25 记录 explicit、implicit、negative 和 near-miss routing 结果;13/26 将每项控制标为 instruction、permission、sandbox 或 verification 并用观察证明边界;13/27 在一个宿主中演练 discovery、references、scripts、approvals、upgrade 与 uninstall,再在第二个宿主重复或如实声明缺失能力与回退。第 26 课之前需读取 prerequisitePaths 和 prerequisiteChecks,验证第 25 课已完成且 tool-poisoning-and-untrusted-instructions 为 Confirmed,否则第 26 课保持 Locked。