用途:根据计划(plan)批量生成课程练习目录结构,产出能通过 lint 的 exercise stubs,并可用 git commit 提交。
目录命名:章节为 exercises/ 下的 XX-section-name/(如 01-retrieval-skill-building);题目为章节下的 XX.YY-exercise-name/(如 01.03-retrieval-with-bm25)。名称使用 dash-case(小写、连字符)。
变体子目录:每个练习至少包含 problem/(学生工作区,含 TODO)、solution/(参考实现)、explainer/(概念材料,不含 TODO)之一。创建桩时,除非计划另行指定,默认使用 explainer/。
必需文件:每个子目录需要非空 readme.md,无失效链接;桩的最小 readme 为标题加描述(如 # Exercise Title 与 Description here)。若子目录含代码,还需 main.ts(多于 1 行);仅 readme 的练习可接受。
工作流:解析计划提取章节名、题目名与变体类型;用 mkdir -p 建目录;为每个变体目录创建带标题的 readme.md 桩;运行 pnpm ai-hero-cli internal lint 校验;迭代修复直至通过。
Lint 检查:每个练习有子目录;至少存在 problem/、explainer/ 或 explainer.1/ 之一;主目录中有非空 readme.md;无 .gitkeep 文件;无 speaker-notes.md 文件;readme 无失效链接;readme 中无 pnpm run exercise 命令;除非仅 readme,否则每个子目录需 main.ts。
移动或重命名练习:用 git mv 而非 mv 以保留历史;更新数字前缀维持顺序;移动后重新运行 lint。示例:git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings。
从计划生成桩的示例:对章节 05 的三个题目,分别 mkdir -p 对应 explainer/ 以及 05.02 的 explainer、problem、solution,然后为每个变体目录创建对应标题的 readme.md 桩。
限制:资料未说明该技能支持的具体平台、价格、性能或其他扩展能力;输出内容依赖计划输入,不具备自动规划课程内容的能力。