SuperAPI AI 工具集

scaffold-exercises

通用与其它

查看项目

更新于 10-15 19:53

技能介绍

用途:按计划批量搭建练习目录结构,生成章节、练习及其变体子目录,并保证通过 lint 校验。适用于用户要求脚手架化练习、创建练习存根或新建课程章节时。

主要能力:目录命名遵循 XX-section-name/ 与 XX.YY-exercise-name/ 规则,名称使用小写连字符;每个练习至少包含 problem/、solution/、explainer/ 之一,存根默认使用 explainer/。每个子目录需有非空 readme.md,含代码时还需 main.ts(超过一行)。

使用方式:解析计划提取章节、练习与变体类型;用 mkdir -p 创建目录;为每个变体目录创建带标题的 readme 存根;运行 pnpm ai-hero-cli internal lint 校验,迭代修复直至通过;最后用 git commit 提交。重命名或移动练习时使用 git mv 保留历史,并更新数字前缀后重新 lint,例如:git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings。

lint 规则:检查子目录存在性、readme 非空、无 .gitkeep、无 speaker-notes.md、无失效链接、readme 中不得出现 pnpm run exercise 命令、非纯 readme 子目录需 main.ts。

限制:该技能从 mattpocock/skills 导入(MIT),上游为模型调用;需在具备 pnpm 与 ai-hero-cli 的环境中运行。建议先在小范围验证输出形状,再扩展到完整任务;遇到需从仓库或环境获取的事实时应自行查询而非询问用户;保持上游流程完整,偏离需明确记录。