Learn From Scratch（从零学习）

在用户没有原始资料时：调研权威来源 → 写入本仓库 → 按需链式调用其他 skills。

何时使用

「想学 / 学习 / 教我 / 帮我理解 …」且未提供 PDF、讲义等
只给一个关键词（如「harness」）
「查官方文档再整理成笔记」「写入知识库」

何时不用（负向触发）

工具对比、选型 → 先简短对比，再问是否写入知识库
用户明确「不要写文件」「口头说说就行」
用户已提供完整资料 → 从 study-notes-creator 开始，跳过调研

注意：「X 是什么」若一词多义且未指明领域 → 必须先澄清（见附录 A），不能先猜再答。

歧义短问 — 必须先问清

立刻用 AskUserQuestion（无则用编号选项并等待回复）
禁止澄清前：WebSearch、写 StudyVault、写测验
选定后：口头解释走快速档；要学则再问档位

深度档位

| 档位 | 内容 | |------|------| | 快速 | 澄清 → 调研 → 笔记 | | 标准（默认） | 快速 + 测验卷 | | 完整 | 标准 + 正式文档 + 询问 tutor |

命名

{slug}：英文小写连字符，如 harness-io
{标题}：显示名，如 Harness.io CI/CD

项目路径

| 用途 | 路径 | |------|------| | 调研 | 来源材料/调研/{slug}/ | | 笔记 | StudyVault/{slug}/concepts/ | | 概念追踪 | StudyVault/concepts/{slug}.md | | 仪表盘 | StudyVault/学习仪表盘.md | | 测验 | 测验/{slug}-{YYYY-MM-DD}.md | | 文档 | 文档/explanation/（仅完整档） |

工作流

0. 澄清主题与档位

歧义短问 → 附录 A；确定 slug/标题/档位；已有主题见附录 F。

1. 调研【快速+】

按附录 B。产出 sources.md、摘录.md。

2. 初始化 StudyVault 【新主题】

创建目录、concepts/{slug}.md、仪表盘新行（附录 C）。

3. 笔记【快速+】

附录 E；路径 StudyVault/{slug}/concepts/{slug}-入门.md。

4. 正式文档【仅完整档】

文档/explanation/{slug}.md。

5. 测验【标准+】

测验/{slug}-{日期}.md，附录 E。

6. tutor 【完整档且用户同意】

4 题诊断，更新仪表盘与概念追踪。

依赖 Skills（需另行安装）

| Skill | 安装 | |-------|------| | study-notes-creator | npx skills add szeyu/vibe-study-skills@study-notes-creator -y | | quiz-creator | npx skills add szeyu/vibe-study-skills@quiz-creator -y | | documentation-writer | npx skills add github/awesome-copilot@documentation-writer -y | | tutor | npx skills add roundtable02/tutor-skills@tutor -y |

附录 A：歧义澄清

短问「是什么」+ 多义 + 未指明领域 → 必须选项澄清
Harness 示例：Harness.io / Test harness / 其他
选定后：搞懂→快速档+口头答；要学→走全流程；不确定→对比差异后再选

附录 B：调研策略

优先官方 docs、GitHub README；403 标无法访问不编造
≥2 来源含 1 官方；不足标待核实
摘录以摘要为主，附 URL 与查阅日期

附录 C：模板摘录

仪表盘新行： | [{标题}]({slug}/) | 0 | 0 | - | ⬜ 未测验 | [[concepts/{slug}]] |

笔记 frontmatter： title, slug, created, updated, sources, depth

附录 D：检查清单

启动：歧义已清、档位已定 → 调研 → StudyVault → 按档位产出 → 汇报

附录 E：子 Skill 要点

笔记：mermaid + 小结表 + 例子
测验：多题型 + details 答案
文档：Diátaxis，仅完整档

附录 F：已有主题

不覆盖旧入门篇；追加笔记与 sources；复习可跳过调研直接 tutor