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
- 参考文档prompts/run-lesson-smith-retrofit.md2.0 KB
- 参考文档ref/retrofit-workflow.md11.0 KB
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
upskill-quiz-cn
这门课的面试式自测. 一道道问下去, 逼你说清为什么, 而不只是是什么.
upskill-learn-cn
这门课的领路人. 要地图, 要拆开某一处, 或者卡住了出不来, 都找它.
upskill-quiz-cn
这门课的面试式自测. 一道道问下去, 逼你说清为什么, 而不只是是什么.
upskill-learn-cn
这门课的领路人. 要地图, 要拆开某一处, 或者卡住了出不来, 都找它.
showcase-quiz-cn
这门课的面试式自测. 一道道问下去, 逼你说清为什么, 而不只是是什么.
showcase-publish-cn
把这个 repo 变成能放上你自己 GitHub 的作品. 抹掉教学痕迹, 再回头查一遍.