[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AR8CD5Y53HM8CB1AT1GE7E":3,"skill-same:01M7AR8CD5Y53HM8CB1AT1GE7E":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7AR8CD5Y53HM8CB1AT1GE7E","scaffold-exercises",null,"创建包含章节、题目、解答与讲解的练习目录结构，且能通过 lint。在用户想搭建练习、创建练习桩，或设置新课程章节时使用。","shenjunjian\u002Fmatt-skill-cn","shenjunjian","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6848520?v=4","01M7AR6EQAH157Z6EXRJV4QSBG","申君健","01M7AR6ERC1W67CKYK9FBKDQG9",0,"MIT","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: scaffold-exercises\ndescription: 创建包含章节、题目、解答与讲解的练习目录结构，且能通过 lint。在用户想搭建练习、创建练习桩，或设置新课程章节时使用。\n---\n\n# 搭建练习\n\n创建能通过 `pnpm ai-hero-cli internal lint` 的练习目录结构，然后用 `git commit` 提交。\n\n## 目录命名\n\n- **章节**：`exercises\u002F` 内的 `XX-section-name\u002F`（例如 `01-retrieval-skill-building`）\n- **练习**：章节内的 `XX.YY-exercise-name\u002F`（例如 `01.03-retrieval-with-bm25`）\n- 章节编号 = `XX`，练习编号 = `XX.YY`\n- 名称使用 dash-case（小写、连字符）\n\n## 练习变体\n\n每个练习至少需要这些子文件夹中的一个：\n\n- `problem\u002F` - 带 TODO 的学员工作区\n- `solution\u002F` - 参考实现\n- `explainer\u002F` - 概念材料，无 TODO\n\n搭建桩时，除非计划另有指定，默认使用 `explainer\u002F`。\n\n## 必需文件\n\n每个子文件夹（`problem\u002F`、`solution\u002F`、`explainer\u002F`）都需要一个 `readme.md`，且：\n\n- **不能为空**（必须有真实内容，哪怕只有一行标题也行）\n- 没有损坏的链接\n\n搭建桩时，创建带标题和描述的最小 readme：\n\n```md\n# Exercise Title\n\nDescription here\n```\n\n如果子文件夹有代码，还需要一个 `main.ts`（多于 1 行）。但对于桩，仅有 readme 的练习也可以。\n\n## 工作流\n\n1. **解析计划** - 提取章节名、练习名和变体类型\n2. **创建目录** - 为每条路径执行 `mkdir -p`\n3. **创建桩 readme** - 每个变体文件夹一个带标题的 `readme.md`\n4. **运行 lint** - 用 `pnpm ai-hero-cli internal lint` 校验\n5. **修复任何错误** - 迭代直到 lint 通过\n\n## Lint 规则摘要\n\nlinter（`pnpm ai-hero-cli internal lint`）会检查：\n\n- 每个练习有子文件夹（`problem\u002F`、`solution\u002F`、`explainer\u002F`）\n- 至少存在 `problem\u002F`、`explainer\u002F` 或 `explainer.1\u002F` 之一\n- 主子文件夹中存在且非空的 `readme.md`\n- 没有 `.gitkeep` 文件\n- 没有 `speaker-notes.md` 文件\n- readme 中没有损坏的链接\n- readme 中没有 `pnpm run exercise` 命令\n- 每个子文件夹需要 `main.ts`，除非它是仅 readme 的\n\n## 移动\u002F重命名练习\n\n重新编号或移动练习时：\n\n1. 用 `git mv`（不要用 `mv`）重命名目录——保留 git 历史\n2. 更新数字前缀以维持顺序\n3. 移动后重新运行 lint\n\n示例：\n\n```bash\ngit mv exercises\u002F01-retrieval\u002F01.03-embeddings exercises\u002F01-retrieval\u002F01.04-embeddings\n```\n\n## 示例：根据计划搭建桩\n\n给定类似这样的计划：\n\n```\nSection 05: Memory Skill Building\n- 05.01 Introduction to Memory\n- 05.02 Short-term Memory (explainer + problem + solution)\n- 05.03 Long-term Memory\n```\n\n创建：\n\n```bash\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002F{explainer,problem,solution}\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\n```\n\n然后创建 readme 桩：\n\n```\nexercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\u002Freadme.md -> \"# Introduction to Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fexplainer\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fproblem\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fsolution\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\u002Freadme.md -> \"# Long-term Memory\"\n```\n","# 搭建练习\n\n创建能通过 `pnpm ai-hero-cli internal lint` 的练习目录结构，然后用 `git commit` 提交。\n\n## 目录命名\n\n- **章节**：`exercises\u002F` 内的 `XX-section-name\u002F`（例如 `01-retrieval-skill-building`）\n- **练习**：章节内的 `XX.YY-exercise-name\u002F`（例如 `01.03-retrieval-with-bm25`）\n- 章节编号 = `XX`，练习编号 = `XX.YY`\n- 名称使用 dash-case（小写、连字符）\n\n## 练习变体\n\n每个练习至少需要这些子文件夹中的一个：\n\n- `problem\u002F` - 带 TODO 的学员工作区\n- `solution\u002F` - 参考实现\n- `explainer\u002F` - 概念材料，无 TODO\n\n搭建桩时，除非计划另有指定，默认使用 `explainer\u002F`。\n\n## 必需文件\n\n每个子文件夹（`problem\u002F`、`solution\u002F`、`explainer\u002F`）都需要一个 `readme.md`，且：\n\n- **不能为空**（必须有真实内容，哪怕只有一行标题也行）\n- 没有损坏的链接\n\n搭建桩时，创建带标题和描述的最小 readme：\n\n```md\n# Exercise Title\n\nDescription here\n```\n\n如果子文件夹有代码，还需要一个 `main.ts`（多于 1 行）。但对于桩，仅有 readme 的练习也可以。\n\n## 工作流\n\n1. **解析计划** - 提取章节名、练习名和变体类型\n2. **创建目录** - 为每条路径执行 `mkdir -p`\n3. **创建桩 readme** - 每个变体文件夹一个带标题的 `readme.md`\n4. **运行 lint** - 用 `pnpm ai-hero-cli internal lint` 校验\n5. **修复任何错误** - 迭代直到 lint 通过\n\n## Lint 规则摘要\n\nlinter（`pnpm ai-hero-cli internal lint`）会检查：\n\n- 每个练习有子文件夹（`problem\u002F`、`solution\u002F`、`explainer\u002F`）\n- 至少存在 `problem\u002F`、`explainer\u002F` 或 `explainer.1\u002F` 之一\n- 主子文件夹中存在且非空的 `readme.md`\n- 没有 `.gitkeep` 文件\n- 没有 `speaker-notes.md` 文件\n- readme 中没有损坏的链接\n- readme 中没有 `pnpm run exercise` 命令\n- 每个子文件夹需要 `main.ts`，除非它是仅 readme 的\n\n## 移动\u002F重命名练习\n\n重新编号或移动练习时：\n\n1. 用 `git mv`（不要用 `mv`）重命名目录——保留 git 历史\n2. 更新数字前缀以维持顺序\n3. 移动后重新运行 lint\n\n示例：\n\n```bash\ngit mv exercises\u002F01-retrieval\u002F01.03-embeddings exercises\u002F01-retrieval\u002F01.04-embeddings\n```\n\n## 示例：根据计划搭建桩\n\n给定类似这样的计划：\n\n```\nSection 05: Memory Skill Building\n- 05.01 Introduction to Memory\n- 05.02 Short-term Memory (explainer + problem + solution)\n- 05.03 Long-term Memory\n```\n\n创建：\n\n```bash\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002F{explainer,problem,solution}\nmkdir -p exercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\n```\n\n然后创建 readme 桩：\n\n```\nexercises\u002F05-memory-skill-building\u002F05.01-introduction-to-memory\u002Fexplainer\u002Freadme.md -> \"# Introduction to Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fexplainer\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fproblem\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.02-short-term-memory\u002Fsolution\u002Freadme.md -> \"# Short-term Memory\"\nexercises\u002F05-memory-skill-building\u002F05.03-long-term-memory\u002Fexplainer\u002Freadme.md -> \"# Long-term Memory\"\n```\n",{"name":5,"description":7},"main","79daa74053d0a8173c9b7678a8de7987bc73cee2","skills\u002Fmisc\u002Fscaffold-exercises","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn","https:\u002F\u002Fgithub.com\u002Fshenjunjian","前端开发","2026-08-19 15:58:38",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add shenjunjian\u002Fmatt-skill-cn --skill scaffold-exercises",{"tool":37,"command":38},"bunx","bunx skills add shenjunjian\u002Fmatt-skill-cn --skill scaffold-exercises",{"tool":40,"command":41},"pnpm","pnpm dlx skills add shenjunjian\u002Fmatt-skill-cn --skill scaffold-exercises","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",102,"https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002Fagents\u002Fopenai.yaml",[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7AR8ZSQPSVC5H6QV068JWW4","writing-for-agents","为 agent 写文档。在创建或编辑 skill，或修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7AR8WVSQYDJWM785VHY2204","wait-what","停。上一条消息没落地——重新讲一遍。","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AR8TE6THPZGTNZWXBTF1ER","to-questionnaire","把你无法独自完全回答的决策变成一份问卷，交给别人填。","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AR8QH5KCYB8JWJ0YMCAZQP","teach","在本工作区内教用户一项新技能或概念。","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AR8P40KPWP498430CHCG3A","handoff","把当前对话压缩成交接文档，供另一个 agent 接手。","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7AR8MKY639QRKXQN6TCKZ1T","grilling","就计划、决策或想法对用户毫不放松地 grilling。在用户想压力测试自己的思考，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002Fshenjunjian\u002Fmatt-skill-cn\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]