Scaffold Exercises

搭建练习

创建能通过 pnpm ai-hero-cli internal lint 的 exercise directory structures，然后用 git commit 提交。

目录命名

• Sections：exercises/ 下的 XX-section-name/（例如 01-retrieval-skill-building）
• Exercises：section 下的 XX.YY-exercise-name/（例如 01.03-retrieval-with-bm25）
• Section number = XX，exercise number = XX.YY
• Names 使用 dash-case（小写、连字符）

Exercise 变体

每个 exercise 至少需要这些 subfolders 中的一个：

• problem/ - student workspace，包含 TODOs
• solution/ - reference implementation
• explainer/ - conceptual material，不含 TODOs

创建 stub 时，除非 plan 指定其他 variant，否则默认使用 explainer/。

必需文件

每个 subfolder（problem/、solution/、explainer/）都需要一个 readme.md，要求：

• 非空（必须有真实内容，即使只有一行 title 也可以）
• 没有 broken links

创建 stub 时，生成带 title 和 description 的最小 readme：

# Exercise Title

Description here

如果 subfolder 有 code，还需要 main.ts（>1 行）。但对 stubs 来说，readme-only exercise 可以接受。

工作流

1. Parse the plan - 提取 section names、exercise names 和 variant types
2. Create directories - 对每个 path 执行 mkdir -p
3. Create stub readmes - 每个 variant folder 一个带 title 的 readme.md
4. Run lint - 执行 pnpm ai-hero-cli internal lint 验证
5. Fix any errors - 迭代直到 lint 通过