scaffold-exercises by mattpocock/skills
npx skills add https://github.com/mattpocock/skills --skill scaffold-exercises创建能通过 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)XX,练习编号 = XX.YY广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
每个练习至少需要包含以下子文件夹之一:
problem/ - 包含待办事项的学生工作区solution/ - 参考实现explainer/ - 概念性材料,无待办事项创建存根时,除非计划另有说明,否则默认使用 explainer/。
每个子文件夹(problem/、solution/、explainer/)都需要一个 readme.md 文件,该文件:
创建存根时,创建一个包含标题和描述的最小化 readme:
# 练习标题
此处为描述
如果子文件夹包含代码,则还需要一个 main.ts 文件(>1 行)。但对于存根,仅包含 readme 的练习也可以。
mkdir -preadme.mdpnpm ai-hero-cli internal lint 进行验证linter (pnpm ai-hero-cli internal lint) 检查以下内容:
problem/、solution/、explainer/)problem/、explainer/ 或 explainer.1/ 中的一个readme.md 且非空.gitkeep 文件speaker-notes.md 文件pnpm run exercise 命令main.ts当重新编号或移动练习时:
git mv(而不是 mv)重命名目录 - 保留 git 历史记录示例:
git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings
给定如下计划:
Section 05: Memory Skill Building
- 05.01 Introduction to Memory
- 05.02 Short-term Memory (explainer + problem + solution)
- 05.03 Long-term Memory
创建:
mkdir -p exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer
mkdir -p exercises/05-memory-skill-building/05.02-short-term-memory/{explainer,problem,solution}
mkdir -p exercises/05-memory-skill-building/05.03-long-term-memory/explainer
然后创建 readme 存根:
exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer/readme.md -> "# Introduction to Memory"
exercises/05-memory-skill-building/05.02-short-term-memory/explainer/readme.md -> "# Short-term Memory"
exercises/05-memory-skill-building/05.02-short-term-memory/problem/readme.md -> "# Short-term Memory"
exercises/05-memory-skill-building/05.02-short-term-memory/solution/readme.md -> "# Short-term Memory"
exercises/05-memory-skill-building/05.03-long-term-memory/explainer/readme.md -> "# Long-term Memory"
每周安装量
452
代码仓库
GitHub 星标
9.5K
首次出现
11 天前
安全审计
已安装于
codex433
cursor430
gemini-cli429
github-copilot429
opencode429
amp428
Create exercise directory structures that pass pnpm ai-hero-cli internal lint, then commit with git commit.
XX-section-name/ inside exercises/ (e.g., 01-retrieval-skill-building)XX.YY-exercise-name/ inside a section (e.g., 01.03-retrieval-with-bm25)XX, exercise number = XX.YYEach exercise needs at least one of these subfolders:
problem/ - student workspace with TODOssolution/ - reference implementationexplainer/ - conceptual material, no TODOsWhen stubbing, default to explainer/ unless the plan specifies otherwise.
Each subfolder (problem/, solution/, explainer/) needs a readme.md that:
When stubbing, create a minimal readme with a title and a description:
# Exercise Title
Description here
If the subfolder has code, it also needs a main.ts (>1 line). But for stubs, a readme-only exercise is fine.
mkdir -p for each pathreadme.md per variant folder with a titlepnpm ai-hero-cli internal lint to validateThe linter (pnpm ai-hero-cli internal lint) checks:
problem/, solution/, explainer/)problem/, explainer/, or explainer.1/ existsreadme.md exists and is non-empty in the primary subfolder.gitkeep filesspeaker-notes.md filespnpm run exercise commands in readmesWhen renumbering or moving exercises:
git mv (not mv) to rename directories - preserves git historyExample:
git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings
Given a plan like:
Section 05: Memory Skill Building
- 05.01 Introduction to Memory
- 05.02 Short-term Memory (explainer + problem + solution)
- 05.03 Long-term Memory
Create:
mkdir -p exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer
mkdir -p exercises/05-memory-skill-building/05.02-short-term-memory/{explainer,problem,solution}
mkdir -p exercises/05-memory-skill-building/05.03-long-term-memory/explainer
Then create readme stubs:
exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer/readme.md -> "# Introduction to Memory"
exercises/05-memory-skill-building/05.02-short-term-memory/explainer/readme.md -> "# Short-term Memory"
exercises/05-memory-skill-building/05.02-short-term-memory/problem/readme.md -> "# Short-term Memory"
exercises/05-memory-skill-building/05.02-short-term-memory/solution/readme.md -> "# Short-term Memory"
exercises/05-memory-skill-building/05.03-long-term-memory/explainer/readme.md -> "# Long-term Memory"
Weekly Installs
452
Repository
GitHub Stars
9.5K
First Seen
11 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex433
cursor430
gemini-cli429
github-copilot429
opencode429
amp428
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
138,300 周安装
Claude 文件规划技能:使用 Markdown 文件作为持久工作记忆,提升 AI 协作效率
11,500 周安装
通用发布工作流技能 - 支持多语言更新日志,自动检测项目配置
12,000 周安装
Tavily AI 搜索技能:为 LLM 优化的网络搜索 API,支持高级过滤与 OAuth 认证
11,900 周安装
OpenClaw技能安全审计指南:skill-vetter工具详解与安装前安全检查
12,200 周安装
Gemini Web API 客户端:文本与图像生成工具,支持多轮对话和逆向工程API
12,100 周安装
Google Workspace Drive API v3 命令行工具 - 管理云端硬盘文件与权限
12,200 周安装
main.ts required per subfolder unless it's readme-only