用途:根据计划批量创建练习目录结构,使其通过 pnpm ai-hero-cli internal lint 校验,之后可用 git commit 提交。
主要能力:按章节与题目组织练习;每个练习至少包含 problem/、solution/、explainer/ 之一;为各子文件夹生成非空 readme.md 占位文件;汇总 lint 规则并支持迭代修复。
目录命名:章节为 exercises/ 下的 XX-section-name/(如 01-retrieval-skill-building);练习为章节内的 XX.YY-exercise-name/(如 01.03-retrieval-with-bm25)。名称使用小写连字符。默认占位使用 explainer/,除非计划另有指明。
必要用法:解析计划提取章节、题目与变体类型;用 mkdir -p 创建路径;为每个变体文件夹写含标题的 readme 占位;运行 pnpm ai-hero-cli internal lint 校验;按报错迭代修复,直至通过。移动或重命名练习时用 git mv 保留历史,并更新数字前缀,随后重新 lint。示例:git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings。
限制:子文件夹的 readme 不能为空、不得有坏链;不得包含 .gitkeep 或 speaker-notes.md;readme 中不得出现 pnpm run exercise 命令;子文件夹含代码时需 main.ts(>1 行),纯 readme 练习可接受。官方文本与收费信息暂未提供。