用途:按计划搭建练习目录结构,使其通过 pnpm ai-hero-cli internal lint 校验,并可用 git commit 提交。适用于创建练习存根、设置新课程章节。
目录命名:章节位于 exercises/ 内,格式 XX-section-name/;练习位于章节内,格式 XX.YY-exercise-name/。章节编号为 XX,练习编号为 XX.YY,名称使用 dash-case(小写加连字符)。
练习变体:每个练习至少需要一个子文件夹,problem/ 为带 TODO 的学生工作区,solution/ 为参考实现,explainer/ 为无 TODO 的概念材料。搭建时默认创建 explainer/,除非计划另有指定。
必需文件:每个子文件夹都需要 readme.md,内容不能为空且不能有损坏链接。搭建时创建带标题和描述的最小 readme,例如以“# 练习标题”开头。若子文件夹含代码,还需要 main.ts(超过 1 行);存根阶段仅 readme 也可通过。
工作流程:解析计划,提取章节名、练习名和变体类型;用 mkdir -p 创建目录;为每个变体创建 readme 存根;运行 pnpm ai-hero-cli internal lint 验证;修复错误直到通过。
Lint 规则摘要:每个练习需有子文件夹;至少存在 problem/、explainer/ 或 explainer.1/ 之一;主要子文件夹的 readme.md 存在且非空;不得有 .gitkeep 或 speaker-notes.md;readme 中不得有损坏链接或 pnpm run exercise 命令;每个子文件夹需 main.ts,除非是仅 readme。
移动或重命名练习时使用 git mv(不是 mv)以保留历史,更新数字前缀保持顺序,移动后重新运行 lint,例如 git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings。
限制:资料未说明支持的其他语言、平台或收费情况;除上述 lint 与命名约束外,暂无其他能力说明。