Skill（技能）是一段沉淀好的操作说明——把"遇到某类需求该怎么一步步做、该调哪些工具"写成一个 Markdown 文件（SKILL.md）。任务匹配时，这段说明会被注入给模型，让它照着做。

对比 Day 12 的 MCP：MCP 提供"工具"（能力），Skill 提供"流程"（怎么用这些能力办成一件事）。比如一个 "code-review" skill 告诉模型"审代码时先看 diff、按这几个维度检查、用 X 格式输出"。核心代码 src/skills/。

一个 SKILL.md = YAML frontmatter（元数据）+ Markdown 正文（给模型的指令）。解析在 parseSkillFrontmatterFields（loadSkillsDir.ts:185），真实识别的字段（:217、:252、:260）：

---
name: code-review                    # 显示名
description: 审查代码变更             # 缺失时从正文首段推断
when_to_use: 用户要求 review 时       # → 代码里的 whenToUse
user-invocable: true                 # 用户能否 /code-review 直接调（默认 true）
disable-model-invocation: false      # 模型能否自己调
context: fork                        # → executionContext='fork'：当子代理跑
allowed-tools: Read, Grep, Bash      # 限制可用工具
paths: "src/**/*.ts"                 # 条件技能：触碰匹配文件才可见（L05）
model: inherit                       # 跟随主模型
---

# 审查流程
1. 先看 diff...
2. 按这几个维度检查...

getSkillDirCommands（loadSkillsDir.ts:638，memoized）扫描三处目录：托管 → 用户 ~/.claude/skills → 项目（从 cwd 向上直到 home 的各级 .claude/skills）+ --add-dir 附加目录。

• 每个 skill 必须是 目录/SKILL.md 形式（单个 .md 不行）。
• 旧式 .claude/commands/ 仍兼容（loadedFrom: 'commands_DEPRECATED'）。
• 符号链接去重：用 realpath 算文件真实身份，同一技能通过软链出现在多处只算一次。

带 paths frontmatter 的条件技能：平时"隐身"，只有当模型读写到匹配的文件时才激活可见。

• discoverSkillDirsForPaths（:861）：模型读写文件时，从文件路径向上找嵌套的 .claude/skills（跳过 gitignored 目录）。
• activateConditionalSkillsForPaths（:997）：用 ignore 库匹配 paths glob，命中才把技能激活进 dynamicSkills。

Skill 有两种被触发的方式：

Day 11 说"skill 本质是 type:'prompt' 的 Command"。这是真实代码——createSkillCommand（loadSkillsDir.ts:270）把一个 SKILL.md 包成的东西（:317）：

function createSkillCommand({ skillName, description, whenToUse, userInvocable,
                              executionContext, hooks, paths, ... }): Command {
  return {
    type: 'prompt',                    // ← ★ 就是一个 prompt 命令！
    name: skillName,
    description,
    whenToUse,
    userInvocable,
    context: executionContext,         // inline / fork
    disableModelInvocation,
    paths,                             // 条件技能
    isHidden: !userInvocable,
    async getPromptForCommand(args, toolUseContext) { ... },  // 展开成给模型的内容
  }
}

✋ 动手：对着真实代码读一遍

# 1. frontmatter 解析字段（L03）
sed -n '185,270p' src/skills/loadSkillsDir.ts | grep -n "when_to_use\|user-invocable\|context\|whenToUse\|executionContext"

# 2. skill = prompt Command（L07，本页精华）
sed -n '317,345p' src/skills/loadSkillsDir.ts

# 3. 发现与条件技能（L04/L05）
sed -n '861,900p' src/skills/loadSkillsDir.ts

# 4. 内置 skill 长什么样
ls src/skills/bundled/ && sed -n '1,20p' src/skills/bundled/simplify.ts

# 5. 自己写一个 skill 试试
mkdir -p .claude/skills/hello && printf -- '---\nname: hello\ndescription: 打招呼\n---\n说你好' > .claude/skills/hello/SKILL.md