用途:按计划批量搭出练习(exercise)目录骨架,使其通过 pnpm ai-hero-cli internal lint 校验,随后用 git commit 提交。
目录命名:分节为 exercises/ 下的 XX-section-name/(如 01-retrieval-skill-building);练习为分节下的 XX.YY-exercise-name/(如 01.03-retrieval-with-bm25)。分节编号为 XX,练习编号为 XX.YY,名称用连字符小写(dash-case)。
练习变体:每个练习至少需要 problem/(含 TODO 的学生工作区)、solution/(参考实现)、explainer/(概念材料,无 TODO)中的一个;打桩时默认用 explainer/,除非计划另有说明。
必需文件:每个子文件夹需有非空 readme.md(哪怕只有一行标题),且不得有失效链接。打桩时创建含标题与描述的最小 readme,如“# Exercise Title”加描述。若子文件夹含代码,还需 main.ts(多于一行);打桩阶段仅 readme 也可。
工作流:解析计划提取分节、练习与变体类型;用 mkdir -p 建目录;为每个变体创建 readme 占位;运行 pnpm ai-hero-cli internal lint 校验;按报错迭代直到通过。
lint 规则要点:每个练习需有 problem/、solution/、explainer/ 子文件夹;至少存在 problem/、explainer/ 或 explainer.1/ 之一;主文件夹的 readme.md 存在且非空;不得有 .gitkeep、speaker-notes.md、失效链接,readme 中不得出现 pnpm run exercise 命令;非仅 readme 时每个子文件夹需 main.ts。
移动或重编号练习时用 git mv(不用 mv)以保留 git 历史,更新数字前缀维持顺序,移动后重新 lint,例如:git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings。
适用场景:需要从计划快速生成大量练习骨架并保证规范一致时。限制:依赖 pnpm ai-hero-cli 与约定目录结构;资料未提供价格、平台支持范围等信息。