该技能用于搭建能通过 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);名称为小写短横线命名法。
练习变体:每个练习至少需要 problem/、solution/、explainer/ 之一。problem/ 为学生工作区(含 TODO),solution/ 为参考实现,explainer/ 为概念讲解(不含 TODO)。创建模板时默认使用 explainer/。
必需文件:每个子文件夹需一个 readme.md,不能为空、不能有损坏链接。创建模板时用极简 readme(标题与描述)。若子文件夹含代码,还需 main.ts(超过一行);仅含 readme 的模板也可通过。
工作流程:解析计划提取章节、练习与变体类型;用 mkdir -p 创建目录;创建 readme 模板;运行 pnpm ai-hero-cli internal lint 验证;反复修复直到通过。
Lint 规则摘要:每个练习须有子文件夹;至少存在 problem/、explainer/ 或 explainer.1/ 之一;主要子文件夹中的 readme.md 不为空;无 .gitkeep;无 speaker-notes.md;readme 无损坏链接;readme 无 pnpm run exercise 命令;每个子文件夹需 main.ts,除非仅有 readme。
移动或重命名:用 git mv 保留历史,更新数字前缀,移动后重跑 lint,例如 git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings。
适用场景:按计划批量创建或重排课程练习目录,确保结构合规。限制:依赖 pnpm ai-hero-cli 工具;具体课程内容与收费信息暂未提供。