SuperAPI AI 工具集

scaffold-exercises

通用与其它

查看项目

更新于 10-16 06:17

技能介绍

用途:根据计划批量搭建练习目录结构,并确保其能通过仓库自带的 lint 校验。

主要能力与约定:目录结构为 exercises/ 下的 XX-section-name/ 章节文件夹,章节内为 XX.YY-exercise-name/ 练习文件夹,均使用小写连字符命名。每个练习至少需要以下子文件夹之一:problem/(含 TODO 的学生工作区)、solution/(参考实现)、explainer/(概念材料,无 TODO)。做占位(stub)时默认只建 explainer/,除非计划另有说明。每个子文件夹需有不含空内容的 readme.md,且不能有失效链接。若子文件夹含代码,还需 main.ts(超过一行);仅 readme 的练习也可接受。

使用方式:解析计划提取章节名、练习名与变体类型;用 mkdir -p 创建目录;为每个变体文件夹创建带标题的 readme 占位;运行 pnpm ai-hero-cli internal lint 校验并迭代修复至通过;最后用 git commit 提交。移动或重编号练习时使用 git mv 而非 mv 以保留历史,并更新数字前缀保持顺序,移动后重新 lint。

Lint 检查项:每个练习有子文件夹;problem/、explainer/、explainer.1/ 至少存在一个;主文件夹内 readme.md 存在且非空;不得有 .gitkeep 和 speaker-notes.md;readme 无失效链接;readme 中不得有 pnpm run exercise 命令;除仅 readme 外每子文件夹需 main.ts。

限制:资料未提供该技能的安装方式、平台支持、价格与效果信息。