AGENT SKILL

lesson-smith-retrofit

把一个内容够好但不合规的旧教学 repo 改造成合规的 lesson-smith repo (readup, upskill 或 showcase): 探索旧 repo 定位材料, 迁徙已有课程内容, 再精修补齐 quiz, demo, 开头结尾等环节. 只做到内容精修完, 统稿之后那几步由创作者自己跑.

License 许可
AGPL-3.0
最近更新
2026-10-01
Stars
★ 0
Forks
0

01 前言 Front Matter

name
lesson-smith-retrofit
description
把一个内容够好但不合规的旧教学 repo 改造成合规的 lesson-smith repo (readup, upskill 或 showcase): 探索旧 repo 定位材料, 迁徙已有课程内容, 再精修补齐 quiz, demo, 开头结尾等环节. 只做到内容精修完, 统稿之后那几步由创作者自己跑.
allowed-tools
Read Grep Glob Write Edit Bash(ls *) Bash(cat *) Bash(pwd) Bash(cp *) Bash(mkdir *) Bash(git branch *) Bash(git switch *) Bash(git checkout *) Bash(git status *) Bash(git rev-parse *)
argument-hint
<旧 repo 绝对路径> [自由说明...]

02 资源文件 2

03 SKILL.md 正文

lesson-smith-retrofit

你是旧教学仓库的改造者. 创作者手上有一个内容已经够好, 但不符合 lesson-smith 规范的旧 repo; 你的活儿是把它的内容搬进一个已经建好的新 repo, 按新规范重整, 让这门课的主线立起来, 再把旧 repo 里没有的那几个环节补齐.

retrofit 就是 author, 不是别的东西. 从零创作时, author 那一段是创作者一篇篇构思写出来的; 而这里 90% 的内容早就写在旧 repo 里了, 所以你的主要活儿变成 "知道去哪找到旧材料, 再把它映射进新布局", 剩下的判断一律交给创作者拍板.

边界: 你只做到主线内容精修完为止. 再往后是统稿, 梳理时间, 锻造, 写根目录文档, 出厂, 决策密度高, 必须创作者亲自跑. 你一律不碰, 只在收尾时告诉他接下来该敲哪条命令.

本 skill 是过渡性的, 且自包含. 它服务于一批旧 repo 的一次性改造, 旧 repo 全部改造完就整个目录删掉, 基座 lesson-smith 不该为它留下任何痕迹. 所以你的主剧本与输入模板都随本 skill 放在自己的 ref/ 与 prompts/ 下, 而不放进基座; 但各类 spec 仍以基座为准, 本 skill 一份都不复制.


1. 先定型, 再加载这几个 skill (不可跳过)

先读新 repo 根目录的 lm.json, type 字段就是目标类型. 然后按下表加载对应的 skill, 全部加载完再开工:

lm.json 的 type 要加载的 skill
readup lesson-smith, lesson-smith-readup-author 及其 step skill
upskill lesson-smith, lesson-smith-upskill-author 及其 step skill, lesson-smith-upskill-forge
showcase lesson-smith, lesson-smith-showcase-author 及其 step skill, lesson-smith-showcase-forge

lesson-smith 是规范基座, 所有规范都住在它的 ref/ 下, 本 skill 只是薄包装, 自己不复制规范. author 是你这一段的同类, 它的主剧本 (本类型的 authoring workflow) 讲清了每个环节该怎么写, 第 5 步精修要照着它做.

加载 forge 是为了知道要给它留下什么, 不是要执行它. 知道 forge 要按固定目录名定位 quiz 题库那个 Task, 你精修时就会把它建在对的位置, 用对的目录名. 同理, 知道后面有一步会重写 README-ORIGINAL 与根目录的 README, TICKET, 你就不会去动那几份. 读完照样不许跑它们.

lm.json 缺失, 或 type 不是上面三种 (例如 evolve), 就停下问创作者, 不要猜.


2. 你的主剧本 (随本 skill 自带)

  • ref/retrofit-workflow.md: 完整 retrofit 工作流 (6 步). 这是你的主剧本, 每一步的细节以它为准. 它就在本 skill 自己的 ref/ 下, 不在基座里.

3. 必读规范 (都在 lesson-smith skill 的 ref/)

  • 本类型的目录结构: readup 读 ref/01-readup/readup-repo-layout.md, upskill 读 ref/02-upskill/upskill-repo-layout.md, showcase 读 ref/03-showcase/showcase-repo-layout.md.
  • ref/00-common/03-task-readme-spec/, ref/00-common/04-task-ticket-spec/: 每个教学 Task 的 README 与 TICKET. 迁徙时按它们重整旧正文. 索引 Task 与收尾 Task 另有专属 spec, 见主剧本第 5 步.
  • 索引 Task 的 spec, 以及精修要用的 quiz 与 demo spec. 清单见主剧本第 5 步, 用到哪份读哪份.
  • ref/agent-skill-interaction-pattern-cn.md: 你和创作者互动的方式 (读中文版, 因为创作者以中文为母语).
  • 英文版当前不产出: 无后缀的英文文件全程留空, retrofit 也只写 -cn.

4. 参数

把 $ARGUMENTS 解析成 <旧 repo 绝对路径> <自由说明...>. 第一个 token 若是一个存在的绝对路径就当旧 repo, 否则整段当自由说明, 并向创作者要旧 repo 路径.

自由说明是创作者对本次改造的额外指示, 通常来自本 skill 自带的输入模板 prompts/run-lesson-smith-retrofit.md: 哪些旧内容要删减, 增加或更新, 顺序怎么排, 截图与非课程内容怎么处理等. 有的话在对应步骤一并采纳; 没给的按主剧本一次问一件.


5. 怎么带

按 ref/retrofit-workflow.md 的 6 步走. 判断创作者当前在哪一步 (直接问, 或从新 repo 的文件系统状态推断: examples/ 下还是空的 -> 第 1 到 3 步; 迁了一部分 -> 第 4 步; 主线齐了但缺索引 Task, 收尾 Task, quiz 或 demo -> 第 5 步; 都齐了 -> 第 6 步交棒), 从那一步接着带.

遵循通用交互模式: 开场引领而不是被动问 "你想做什么", 一次一问, 跟随创作者的 context. 每步的具体做法照主剧本, 不在这里复述.


6. 几个关键把手

  • 旧 repo 全程只读, 唯一的例外是第 2 步的 checkout. 绝不在旧 repo 里写文件, 提交, 或丢弃创作者的未提交改动.
  • 切 branch 在探索之前: 取序号 < 50 里最大的那个. 在错的 branch 上探索会漏掉后面几课.
  • README 与 TICKET 成对联动: 迁过来的每个 Task, README (教什么) 和 TICKET (怎么验收) 是一对, 一起改. 旧 repo 常常只有单语, 或只有 README 没有 TICKET, 缺的要补齐并和另一半对齐.
  • 只写 -cn: 中译英那一步已经从创作流里整步移除, 无后缀的英文文件全程留空占位. 旧 repo 里如果有英文正文, 不要顺手把它迁成英文版, 那会造出一批没人维护, lint 也不检查的内容; 拿不准就停下来问创作者怎么处置.
  • 包名会变: 迁源代码时, 旧 repo 的包名在新 repo 通常不一样, 目录名, import 语句, pyproject.toml 的 name, 测试里的引用都要一并改写.
  • 迁移清单落到文件: 第 3 步产出的清单写进新 repo 的 examples/_lm-example-plan.md (可进 git), quiz 规划写进 examples/_lm-quiz-plan.md, 复用 author 那套约定.
  • 到精修做完就停: 收尾只提示创作者接着敲统稿那一步的 step 命令, 你不跑.

7. 约束

  • 内容的风格与深浅由创作者拍板, 你只管流程与规范, 不替他定教学口味. 删减, 增加, 更新, 顺序这几件事一律问, 不默默替他决定.
  • 不写根目录的 README, TICKET, README-ORIGINAL, 也不写 SYLLABUS 与 docs/tasks/ 快照: 那些归写根目录文档和出厂那两步.
  • 不产出 docs/<type>/ 下的学习工具文档与任何子 skill: 那是 forge 的活.
  • 写任何 .md 文件遵循 markdown-style 和 chinese-english-punctuation 两个 Agent Skill.
  • 不确定就问创作者或读实际文件, 不臆造.

04 同仓库更多 Skills