start-learning

GitHub

引导用户完成AI工程课程入门,通过访谈和分级测验生成个性化学习计划LEARNING.md。支持续学路由、MCP及Agent Skills专用路线切换,并管理学习状态文件。

.claude/skills/start-learning/SKILL.md fancyboi999/ai-engineering-from-scratch-zh

Trigger Scenarios

开始学习 设置课程 开始课程 带我入门 创建学习计划 start learning set up the course begin the curriculum onboard me create my learning plan

Install

npx skills add fancyboi999/ai-engineering-from-scratch-zh --skill start-learning -g -y
More Options

Non-standard path

npx skills add https://github.com/fancyboi999/ai-engineering-from-scratch-zh/tree/main/.claude/skills/start-learning -g -y

Use without installing

npx skills use fancyboi999/ai-engineering-from-scratch-zh@start-learning

指定 Agent (Claude Code)

npx skills add fancyboi999/ai-engineering-from-scratch-zh --skill start-learning -a claude-code -g -y

安装 repo 全部 skill

npx skills add fancyboi999/ai-engineering-from-scratch-zh --all -g -y

预览 repo 内 skill

npx skills add fancyboi999/ai-engineering-from-scratch-zh --list

SKILL.md

Frontmatter
{
    "name": "start-learning",
    "tags": [
        "onboarding",
        "curriculum",
        "ai-engineering",
        "learning-plan"
    ],
    "version": "1.0.0",
    "description": "AI Engineering from Scratch 课程的一次性入门流程(523 节课、20 个阶段)。访谈学习者、 运行分级测验,并写入由 learn skill 驱动的持久学习计划 LEARNING.md。触发短语: “开始学习”、“设置课程”、“开始课程”、“带我入门”、“创建学习计划”,或 \"start learning\", \"set up the course\", \"begin the curriculum\", \"onboard me\", \"create my learning plan\"\n"
}

开始学习

你正在引导学习者进入 AI Engineering from Scratch 课程:20 个阶段、523 节课,从线性代数到自主 agent。你的任务是在当前目录产出 LEARNING.md,这份单一文件记录他们为何学习、应从哪里开始以及学习路径。之后每次 learn session 都会读取并更新它,因此把它当作学习者的唯一事实来源。

适用于任何 agent。环境有结构化问题/选项工具时,每个问题都使用它;否则用纯文本展示带字母选项并等待回复。

宿主调用契约

skill 名称可移植,但调用语法属于宿主。展示下一条命令前,使用正确形式:

  • Codex:start-learninglearncourse-guideskill-name 形式,或告诉学习者从 /skills 选择 skill。
  • Claude Code:/start-learning/learn/course-guide/skill-name 形式。
  • 其他兼容宿主:使用自然语言,例如 Use learn to start my first lesson.

绝不把 Claude Code 的斜杠命令说成通用语法。宿主未知时,使用自然语言。

跨课程模式的续学路由

通用入门前,将每个“继续”或“续学”请求按以下支持的状态文件和路线所有者解析:

  • LEARNING.md 属于完整课程的 learn
  • MCP-LEARNING.md 属于 Model Context Protocol (MCP) 路线的 learn-mcp
  • MCP-ENGINEERING-LEARNING.md 是同一 learn-mcp 路线的旧文件名,不是独立路线。
  • AGENT-SKILLS-LEARNING.md 属于 learn-agent-skills
  • CLAUDE-CERTIFICATION.md 属于 claude-certification

学习者在续学请求中点名路线时,即使其他状态文件存在,也立即分派给该所有者,然后停止此 skill。

未点名的续学请求,收集存在状态文件的所有者,并将两个 MCP 文件名归为 learn-mcp。若仅剩一个路线所有者,在通用入门前调用它并停止此 skill。learn-mcp 负责旧文件迁移及冲突报告。若有两个或更多所有者,列出面向学习者的路线名,在进行定位或改动任何状态前询问要恢复哪一条。没有文件时继续通用入门。绝不依据文件修改时间推断路线,也绝不将一个路线的进度并入其他状态文件。

旧 runtime 可能将 learn-mcp-engineering 暴露为别名。只接受它以到达 learn-mcp;面向学习者的交接一律渲染为 learn-mcp,路线名称为 Model Context Protocol (MCP)。

专门 MCP 交接

学习者明确想学习 Model Context Protocol (MCP) 而非完整课程时,不运行定位,也不创建 LEARNING.md。路由至可移植 skill learn-mcp,其来源为 learning-paths/model-context-protocol.json,状态文件为 MCP-LEARNING.md。在 Codex 使用 learn-mcp、Claude Code 使用 /learn-mcp,或要求其他兼容宿主使用 learn-mcp。专用 tutor 拥有课程选择、wire evidence 及 public-deployment security gate。

专门 Agent Skills 交接

学习者明确想学习 Agent Skills 而非完整课程,或存在 AGENT-SKILLS-LEARNING.md 且其要求恢复该路线时,不运行定位,也不创建 LEARNING.md。路由至可移植 skill learn-agent-skills,来源是 learning-paths/agent-skills.json,状态文件是 AGENT-SKILLS-LEARNING.md。在 Codex 使用 learn-agent-skills、Claude Code 使用 /learn-agent-skills,或要求其他兼容宿主使用 learn-agent-skills。专用 tutor 拥有五课顺序、真实宿主证据、sandbox boundaries、第 26 课前的第 25 课和 tool-poisoning prerequisite gate,以及 release gate。

LEARNING.md 已存在,绝不覆盖。概述它的内容(mission、entry point、目前进度),并只提供恰好三条路径:

  • 恢复: 使用上方宿主语法调用 learn;完全跳过访谈与定位。
  • 重新定位: 再次进行测验,然后只更新 Placement 部分和 Path 状态;保留 Mission、Progress log 与 Review queue。
  • 重新开始: 仅在明确确认后,将当前文件改名为 LEARNING-<YYYY-MM-DD>.md 作为归档,随后进行下方完整入门。绝不静默删除或覆盖历史。

第 1 步:访谈(3 个问题,保持简短)

  1. 你为什么学习 AI engineering? 自由文本。可给出的示例:ship an AI product、职业转型、理解自己每天使用的东西、研究。用其自己的话记录回答,因为它会为之后所有课程解释提供锚点。
  2. 每周能投入多少时间? 选项:约 2 h、约 5 h、约 10 h、“尽可能快”。只用于如实表述节奏,绝不用来删减内容。
  3. 结束时最想构建什么? 一行即可。一个 agent、一个训练后的模型、一个 RAG product,“暂时不确定”也可以。

不要多问。分级测验衡量知识;访谈只记录意图。

第 2 步:定位

运行随此 skill 安装的 find-your-level skill 分级测验:5 个领域、10 道题,映射到一个起始阶段。保持该 skill 的答案隔离契约:不要预加载之后轮次的答案键,也不要用真实选项字母替换中性 <letter> 占位符。

学习者已说清想从哪开始(“直接从第 7 阶段开始”)时,尊重选择并跳过测验,但仍遵守与测验相同的输出契约,确保 learn tutor 始终能找到格式正确的计划:

  • 验证阶段在 0-19 之间并解析其规范名称;无法解析时,列出 20 个阶段要求选择。
  • Path 表中,入口前阶段为 Skip,入口及其后为 Do(没有可从领域分数推断的 Review 行);Est. hours 总数为所有 Do 行的和。
  • Placement 部分写入 Score: self-selected,不能写数值。

第 3 步:写入 LEARNING.md

在当前目录创建 LEARNING.md,严格使用以下 sections:

# My AI Engineering Path
<!-- Managed by the ai-engineering-from-scratch learning skills.
     Repo: https://github.com/fancyboi999/ai-engineering-from-scratch-zh -->

## Mission
<their answer to question 1, in their words, plus the build goal from question 3>

## Placement
- Date: <YYYY-MM-DD>
- Score: <total>/10 with the area breakdown, or exactly `self-selected` when the quiz was skipped
- Entry point: Phase <N>: <name>
- Pace: ~<hours>/week

## Path
| Phase | Name | Status | Est. hours |
|-------|------|--------|------------|
<all 20 phases; Status is Skip, Review, Do, or Done from the placement
result. Hours come from ROADMAP.md: read it locally if the repo is cloned,
otherwise fetch
https://raw.githubusercontent.com/fancyboi999/ai-engineering-from-scratch-zh/main/ROADMAP.md>

## Progress log
| Date | Lesson | Quiz | Note |
|------|--------|------|------|

## Review queue
<empty for now; learn adds lessons the quizzes flag>

第 4 步:交接

收尾仅三行,不能更多:

  • 学习者的入口和 Review + Do 阶段的预计总时数。
  • 给出宿主正确的 learn 调用方式,并说明它会开始第一课且每次都从此文件继续。
  • 给出宿主正确的 course-guide <topic> 调用方式,并说明它可跳转到特定主题。

Version History

  • fa22e2d Current 2026-09-03 00:52

Same Skill Collection

.claude/skills/check-understanding/SKILL.md
.claude/skills/claude-certification/SKILL.md
.claude/skills/course-guide/SKILL.md
.claude/skills/find-your-level/SKILL.md
.claude/skills/learn-agent-skills/SKILL.md
.claude/skills/learn-mcp/SKILL.md
.claude/skills/learn/SKILL.md
phases/13-tools-and-protocols/22-skills-and-agent-sdks/outputs/skill-contract-reviewer/SKILL.md
phases/13-tools-and-protocols/25-skill-invocation-and-routing/outputs/skill-invocation-router/SKILL.md
phases/13-tools-and-protocols/26-skill-permissions-sandboxes-and-trust/outputs/skill-safety-reviewer/SKILL.md
phases/13-tools-and-protocols/27-skill-evals-packaging-and-portability/outputs/skill-release-gate/SKILL.md
skills/check-understanding/SKILL.md
skills/claude-certification/SKILL.md
skills/course-guide/SKILL.md
skills/find-your-level/SKILL.md
skills/learn-agent-skills/SKILL.md
skills/learn-mcp/SKILL.md
skills/learn/SKILL.md
skills/start-learning/SKILL.md
phases/13-tools-and-protocols/24-skill-discovery-and-progressive-disclosure/outputs/skill-catalog-builder/SKILL.md

Metadata

Files
0
Version
fa22e2d
Hash
73dbfd89
Indexed
2026-09-03 00:52

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-04 07:29
浙ICP备14020137号-1 $Carte des visiteurs$