dsh-learn-mode 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/client/client.js +452 -0
  2. package/cordis.patch.yml +111 -0
  3. package/index.js +19 -0
  4. package/package.json +42 -6
  5. package/skills/dsh-learn-mode/SKILL.md +190 -0
  6. package/skills/learn-synthesizer/SKILL.md +278 -0
  7. package/skills/learn-synthesizer/analysis/workspace-file-convention.md +402 -0
  8. package/skills/learn-synthesizer/evals/evals.json +72 -0
  9. package/skills/learn-synthesizer/references/axis-types.md +20 -0
  10. package/skills/learn-synthesizer/references/example-structures.md +291 -0
  11. package/skills/learn-synthesizer/references/feedback-types.md +296 -0
  12. package/skills/learn-synthesizer/references/gotchas.md +322 -0
  13. package/skills/learn-synthesizer/references/sub-agent-prompt.md +222 -0
  14. package/skills/learn-synthesizer/rules/core-principles.md +173 -0
  15. package/skills/learn-synthesizer/rules/output-format.md +355 -0
  16. package/skills/learn-synthesizer/rules/quality-gates.md +209 -0
  17. package/skills/learn-synthesizer/scripts/pdf_to_md.py +124 -0
  18. package/skills/learn-synthesizer/templates/MISSION.md +38 -0
  19. package/skills/learn-synthesizer/templates/deep-dive.md +73 -0
  20. package/skills/learn-synthesizer/templates/map-evolution.md +38 -0
  21. package/skills/learn-synthesizer/templates/understanding-map.md +42 -0
  22. package/skills/learn-synthesizer/workflows/stage0.5-mission.md +141 -0
  23. package/skills/learn-synthesizer/workflows/stage1-collect.md +214 -0
  24. package/skills/learn-synthesizer/workflows/stage2-extract.md +254 -0
  25. package/skills/learn-synthesizer/workflows/stage2.5-importance.md +197 -0
  26. package/skills/learn-synthesizer/workflows/stage3-merge.md +492 -0
  27. package/skills/learn-synthesizer/workflows/stage3.5-gap.md +317 -0
  28. package/skills/learn-synthesizer/workflows/stage4-chapter-agent.md +342 -0
  29. package/skills/learn-synthesizer/workflows/stage4-ref-extract.md +111 -0
  30. package/skills/learn-synthesizer/workflows/stage4-write.md +355 -0
  31. package/skills/learn-synthesizer/workflows/stage4.5-verify.md +327 -0
  32. package/skills/learn-synthesizer/workflows/stage5-review.md +196 -0
  33. package/skills/learn-synthesizer/workflows/stage5.5-iterate.md +297 -0
  34. package/skills/learn-synthesizer/workflows/stage6-finalize.md +310 -0
  35. package/skills/learn-synthesizer/workflows/stage6-progressive.md +173 -0
  36. package/skills-provider.mjs +99 -0
  37. package/workbench-host.mjs +425 -0
  38. package/README.md +0 -3
@@ -0,0 +1,402 @@
1
+ # 工作区文件结构规范 (Workspace File Structure Specification)
2
+
3
+ > 版本: 1.0
4
+ > 适用范围: learn-synthesizer v0.0.5+
5
+ > 规范对象: 所有阶段产出的中间文件、验证报告、最终交付物
6
+
7
+ ---
8
+
9
+ ## 目录
10
+
11
+ 1. [问题陈述](#1-问题陈述)
12
+ 2. [设计原则](#2-设计原则)
13
+ 3. [规范工作区结构](#3-规范工作区结构)
14
+ 4. [文件命名规则](#4-文件命名规则)
15
+ 5. [文件分类与生命周期](#5-文件分类与生命周期)
16
+ 6. [README.md 模板](#6-readmemd-模板)
17
+ 7. [各阶段集成改动](#7-各阶段集成改动)
18
+ 8. [现有工作区迁移指南](#8-现有工作区迁移指南)
19
+
20
+ ---
21
+
22
+ ## 1. 问题陈述
23
+
24
+ ### 当前存在的问题
25
+
26
+ 以实际产出工作区 `数据处理与模型训练教程` 为例,暴露了以下问题:
27
+
28
+ #### 1.1 命名不一致
29
+
30
+ | 问题 | 实例 | 影响 |
31
+ |------|------|------|
32
+ | **知识报告编号** | `report-02.json` 起步(01 丢失),跳跃编号 | 无法确定是否有遗漏 |
33
+ | **验证报告命名** | `verify-ch01-03.md`、`verify-ch10-11-14.md` | 范围不规则(有的连续、有的跳号),无法从文件名推断实际覆盖范围 |
34
+ | **中英文混用** | `资料清单.md`(中文)vs `domain-overview.md`(英文) | 风格不统一,部分用户看不懂英文文件名 |
35
+ | **序号填充** | diagrams 用 2 位补零(`01-01`),knowledge-reports 编号 `02` 也是补零,但各文件命名没有统一规范 | 排序可能乱 |
36
+
37
+ #### 1.2 目录结构混乱
38
+
39
+ ```
40
+ 当前工作区根目录(10+ 个文件平铺):
41
+ ├── MISSION.md ← 顶层文档
42
+ ├── session-state.md ← 会话状态
43
+ ├── 资料清单.md ← 阶段1
44
+ ├── domain-overview.md ← 阶段3.0
45
+ ├── importance-ratings.json ← 阶段3
46
+ ├── outline.md ← 阶段3
47
+ ├── outline-stats.json ← 阶段3
48
+ ├── quality-report.md ← 阶段4.5
49
+ ├── verify-ch01-03.md ← 阶段4.5
50
+ ├── verify-ch04-06.md ← 阶段4.5(共5个验证文件)
51
+ ├── ...
52
+ ├── diagrams/ ← 阶段4
53
+ ├── knowledge-reports/ ← 阶段2
54
+ └── 数据处理与模型训练-tutorial/ ← 阶段6 最终交付
55
+ ```
56
+
57
+ **问题:** 中间产物(`verify-*.md`、`quality-report.md`、`outline.md`)与永久文档(`MISSION.md`、`session-state.md`)混在一起。用户打开工作区后无法一眼分辨哪些是过程文件、哪些是交付物。
58
+
59
+ #### 1.3 缺少元数据
60
+
61
+ - 没有 `README.md`:用户(或未来的自己)不清楚目录含义
62
+ - 没有文件索引:逐一打开才知道内容
63
+ - 没有生命周期说明:哪些可以删、哪些必须保留
64
+
65
+ ---
66
+
67
+ ## 2. 设计原则
68
+
69
+ 1. **一眼可辨**:从文件名和目录位置就能判断文件性质(中间/最终/元数据)
70
+ 2. **统一序数**:所有与章节/资料关联的文件使用一致的零填充格式(`NN` = 2位补零,章节号≥10 也只需 2 位)
71
+ 3. **英文优先**:技术性文件名使用英文(便于脚本处理);面向用户的说明用中文
72
+ 4. **内部分离**:中间产物收入 `_internal/` 目录,与最终交付物隔离
73
+ 5. **自文档化**:每个工作区必须包含 `README.md`
74
+ 6. **可追溯**:中间产物命名包含阶段标识,可回溯到生成它的 workflow
75
+
76
+ ---
77
+
78
+ ## 3. 规范工作区结构
79
+
80
+ ```
81
+ {主题}-workspace/ ← 工作区根目录
82
+ │
83
+ ├── README.md ← [永久] 工作区说明(模板见 §6)
84
+ ├── MISSION.md ← [永久] 学习使命(阶段 0.5 产出)
85
+ ├── session-state.md ← [持久] 会话状态(各阶段更新)
86
+ ├── understanding-map.md ← [永久] 学习进度跟踪(阶段 6 产出)
87
+ ├── 00-地图.md ← [永久] 领域地图层(阶段 3 产出,主轴≠概念依赖时;规模大了拆为 00-地图/ 目录)
88
+ │
89
+ ├── _internal/ ← [中间] 所有构建过程产物
90
+ │ ├── 01-collect/ ← 阶段 1 产物
91
+ │ │ └── source-list.md ← 资料清单(原 资料清单.md)
92
+ │ │
93
+ │ ├── 02-extract/ ← 阶段 2 产物
94
+ │ │ └── kp-NN-{shortname}.json ← 知识报告(原 report-NN.json)
95
+ │ │
96
+ │ ├── 03-merge/ ← 阶段 3 产物
97
+ │ │ ├── domain-overview.md
98
+ │ │ ├── importance-ratings.json
99
+ │ │ ├── outline.md
100
+ │ │ └── outline-stats.json
101
+ │ │
102
+ │ └── 04-verify/ ← 阶段 4.5 产物
103
+ │ ├── quality-report.md
104
+ │ └── verify-NN-{range}.md ← 验证报告(按章节批次)
105
+ │
106
+ ├── tutorial/ ← [最终] 教程交付物(阶段 4-6 产出)
107
+ │ ├── 00-学习路线图.md
108
+ │ ├── {模块名}/ ← 按模块分组的章节
109
+ │ │ ├── 01-{章节标题}.md
110
+ │ │ ├── 02-{章节标题}.md
111
+ │ │ └── ...
112
+ │ ├── {NN}-{参考资源}.md ← 外部参考资源索引
113
+ │ └── reference/ ← 独立参考文档(阶段 4.2 产出)
114
+ │ ├── GLOSSARY.md
115
+ │ ├── COMMANDS.md
116
+ │ ├── TEMPLATES.md
117
+ │ └── TROUBLESHOOTING.md
118
+ │
119
+ └── diagrams/ ← [最终] drawio 图表(阶段 4 产出)
120
+ └── ch{NN}-{seq:02d}_{name}.drawio
121
+ ```
122
+
123
+ ### 结构说明
124
+
125
+ | 层级 | 目录/文件 | 性质 | 用户需要关心? |
126
+ |------|----------|------|-------------|
127
+ | 根 | `README.md` | 永久 | ✅ 第一个看的文件 |
128
+ | 根 | `MISSION.md` | 永久 | ✅ 学习目标 |
129
+ | 根 | `session-state.md` | 持久 | ⚠️ AI 维护,用户不需要手动编辑 |
130
+ | 根 | `understanding-map.md` | 永久 | ✅ 跟踪学习进度 |
131
+ | 根 | `00-地图.md` | 永久 | ✅ 领域地图层(主轴≠概念依赖时存在) |
132
+ | `_internal/` | 全部内容 | 中间 | ❌ 构建过程产物,用户不需要查看 |
133
+ | `tutorial/` | 全部内容 | 最终 | ✅ 核心交付物 |
134
+ | `diagrams/` | drawio 文件 | 最终 | ✅ 图表源文件,可编辑复用 |
135
+
136
+ ---
137
+
138
+ ## 4. 文件命名规则
139
+
140
+ ### 4.1 通用规则
141
+
142
+ | 规则 | 说明 | 示例 |
143
+ |------|------|------|
144
+ | 序号补零 | 章节号/资料号统一用 2 位补零(`01`-`99`) | `ch01` ✓ / `ch1` ✗ |
145
+ | 英文优先 | 技术性文件名用英文小写 + 连字符 | `domain-overview.md` ✓ |
146
+ | 中文保留场景 | 面向用户的文件名可用中文,但内部索引用英文 | `tutorial/01-数据清洗.md` ✓ |
147
+ | 版本标记 | 增量更新时在文件内用 `[NEW in V1.1]` 标注,不在文件名中加版本号 | — |
148
+ | 禁止特殊字符 | 文件名不含空格、括号、中文标点 | `kp-01-huggingface.md` ✓ / `kp-01 (HuggingFace).md` ✗ |
149
+
150
+ ### 4.2 按文件类型的命名规则
151
+
152
+ #### 知识报告(`_internal/02-extract/`)
153
+
154
+ ```
155
+ 格式: kp-{index:02d}-{source-shortname}.json
156
+ 规则:
157
+ - index: 资料序号,从 01 开始连续递增
158
+ - source-shortname: 资料简称(英文小写+连字符,≤30字符)
159
+ - 必须从 01 开始,不允许跳号
160
+ - 如果某份资料提取失败被跳过,保留序号占位并记录到 session-state
161
+
162
+ 示例:
163
+ kp-01-official-syllabus.json ← 资料1: 竞赛官方讲义
164
+ kp-02-huggingface-transformers.json
165
+ kp-03-peft-lora.json
166
+ kp-07-pandas-sklearn.json
167
+ ```
168
+
169
+ #### 验证报告(`_internal/04-verify/`)
170
+
171
+ ```
172
+ 格式: verify-{batch-index:02d}-ch{start:02d}-ch{end:02d}.md
173
+ 规则:
174
+ - batch-index: 验证批次号,从 01 开始
175
+ - start/end: 该批次覆盖的章节范围,2位补零
176
+ - 如果批次只覆盖单个章节: verify-{batch:02d}-ch{num:02d}.md
177
+
178
+ 示例:
179
+ verify-01-ch01-ch03.md ← 第1批: 验证 1-3 章
180
+ verify-02-ch04-ch06.md ← 第2批: 验证 4-6 章
181
+ verify-03-ch07-ch09.md
182
+ verify-04-ch10-ch11.md ← 注意: ch10-ch11,不是 ch10-11-14(范围必须连续)
183
+ verify-05-ch12-ch14.md
184
+ ```
185
+
186
+ #### 图表文件(`diagrams/`)
187
+
188
+ ```
189
+ 格式: ch{chapter:02d}-{seq:02d}_{description}.drawio
190
+ 规则:
191
+ - chapter: 所属章节号,2位补零
192
+ - seq: 该章节内图序号,从 01 开始
193
+ - description: 图表描述(英文小写+连字符,或保留中文)
194
+
195
+ 示例:
196
+ ch01-01_data-processing-pipeline.drawio
197
+ ch04-02_labelstudio-sft-workflow.drawio
198
+ ch06-01_layer-wise-investigation.drawio
199
+ ```
200
+
201
+ #### 教程章节(`tutorial/{模块}/`)
202
+
203
+ ```
204
+ 格式: {chapter:02d}-{章节标题}.md
205
+ 规则:
206
+ - chapter: 章节序号,2位补零
207
+ - 标题: 可含中文
208
+ - 00 预留给学习路线图
209
+ - 最后一个序号预留给参考资源索引
210
+
211
+ 示例:
212
+ 00-学习路线图.md
213
+ 模块一-数据处理与标注/
214
+ 01-数据处理闭环与数据清洗.md
215
+ 02-数据格式转换:从业务表到SFT.md
216
+ ...
217
+ 模块二-模型训练与评估/
218
+ 06-训练环境与参数高效微调.md
219
+ ...
220
+ 15-参考资源.md
221
+ ```
222
+
223
+ ---
224
+
225
+ ## 5. 文件分类与生命周期
226
+
227
+ ### 5.1 三类文件
228
+
229
+ | 类别 | 存放位置 | 生命周期 | 用户操作 |
230
+ |------|---------|---------|---------|
231
+ | **永久** | 工作区根目录 | 与工作区同寿,绝不删除 | 阅读、编辑 |
232
+ | **持久** | 工作区根目录 | AI 持续更新,不主动删除 | 不手动编辑 |
233
+ | **中间** | `_internal/` | 阶段完成后可归档,教程交付后可整体删除 | 不需要关心 |
234
+
235
+ ### 5.2 逐文件分类
236
+
237
+ | 文件 | 类别 | 产生阶段 | 说明 |
238
+ |------|------|---------|------|
239
+ | `README.md` | 永久 | 阶段 0(初始创建) | 阶段 6 最终更新 |
240
+ | `MISSION.md` | 永久 | 阶段 0.5 | 用户可随时修改 |
241
+ | `session-state.md` | 持久 | 各阶段(AI 写入) | 流水线断点续传用,用户不编辑 |
242
+ | `understanding-map.md` | 永久 | 阶段 6 | 用户标记学习进度 |
243
+ | `_internal/01-collect/source-list.md` | 中间 | 阶段 1 | 归档后用户不需要 |
244
+ | `_internal/02-extract/kp-*.json` | 中间 | 阶段 2 | 阶段 4 质量验证时回溯用,交付后可删除 |
245
+ | `_internal/03-merge/*` | 中间 | 阶段 3 | 大纲构建过程记录 |
246
+ | `_internal/04-verify/*` | 中间 | 阶段 4.5 | 质量验证记录,交付后可删除 |
247
+ | `tutorial/*` | 最终 | 阶段 4-6 | 核心交付物 |
248
+ | `tutorial/reference/*` | 最终 | 阶段 4.2 | 独立参考文档 |
249
+ | `diagrams/*` | 最终 | 阶段 4 | 图表源文件 |
250
+
251
+ ### 5.3 清理规则
252
+
253
+ 阶段 6 完成后,面向用户给出清理建议:
254
+
255
+ ```
256
+ 教程已交付。
257
+
258
+ [可选] 工作区中的 `_internal/` 目录包含构建过程的中间文件
259
+ (知识提取报告、验证记录、大纲草稿等),这些文件在教程交付后
260
+ 不再需要。如希望精简工作区,可以删除 `_internal/` 整个目录。
261
+
262
+ 要保留的内容:
263
+ ✅ README.md
264
+ ✅ MISSION.md
265
+ ✅ session-state.md
266
+ ✅ understanding-map.md
267
+ ✅ tutorial/(教程交付物)
268
+ ✅ diagrams/(图表源文件)
269
+
270
+ 可安全删除:
271
+ ❌ _internal/(整个目录)
272
+ ```
273
+
274
+ ---
275
+
276
+ ## 6. README.md 模板
277
+
278
+ 每个新工作区在创建时必须生成 `README.md`。阶段 6 交付时更新。
279
+
280
+ ```markdown
281
+ # {主题} — 学习教程工作区
282
+
283
+ > 由 learn-synthesizer 生成 | 创建日期: {YYYY-MM-DD} | 最后更新: {YYYY-MM-DD}
284
+
285
+ ## 这是什么
286
+
287
+ 本工作区包含 [{主题}] 的系统学习教程。
288
+ 教程聚焦于 [{Mission.Why}],目标为 [{Mission.Success}]。
289
+
290
+ ## 目录导航
291
+
292
+ | 想看什么 | 打开 |
293
+ |---------|------|
294
+ | 📖 开始学习 | [`tutorial/00-学习路线图.md`](tutorial/00-学习路线图.md) |
295
+ | 🎯 为什么学 | [`MISSION.md`](MISSION.md) |
296
+ | 📝 学习进度追踪 | [`understanding-map.md`](understanding-map.md) — 学完一部分回来打勾 |
297
+ | 📋 术语速查 | [`tutorial/reference/GLOSSARY.md`](tutorial/reference/GLOSSARY.md) |
298
+ | ⌨️ 命令速查 | [`tutorial/reference/COMMANDS.md`](tutorial/reference/COMMANDS.md) |
299
+ | 📐 配置模板 | [`tutorial/reference/TEMPLATES.md`](tutorial/reference/TEMPLATES.md) |
300
+ | 🐛 常见错误 | [`tutorial/reference/TROUBLESHOOTING.md`](tutorial/reference/TROUBLESHOOTING.md) |
301
+ | 🗂️ 图表源文件 | [`diagrams/`](diagrams/) |
302
+
303
+ ## 目录结构说明
304
+
305
+ - `tutorial/` — 📖 教程交付物(核心内容,你应该从这里开始)
306
+ - `diagrams/` — 🗂️ 流程图/架构图源文件(.drawio 格式,可编辑)
307
+ - `_internal/` — 🔧 构建过程产物(不需要关心,可删除)
308
+ - `MISSION.md` — 🎯 学习目标和范围
309
+ - `understanding-map.md` — 📝 学习进度地图(学完一章回来标记)
310
+
311
+ ## 渐进深化
312
+
313
+ 这不仅是教程——它是一个持续陪伴的知识空间。学完后可以回来:
314
+
315
+ 1. "我学完了第 X-Y 章" → AI 标记已掌握,推荐后续路径
316
+ 2. "第 X 章太浅了,帮我深挖" → 补充搜索,重写该章
317
+ 3. "[主题] 出新版本了" → 增量更新
318
+ 4. "帮我生成配套练习" → 生成 quiz + coding exercise
319
+ 5. "按我现在进度,推荐下一步" → 分析进度,推荐优先补缺
320
+
321
+ ## 生成信息
322
+
323
+ - 学习模式: {快速参考 / 完整教程}
324
+ - 资料来源: {N} 份(一手 {A} / 二手 {B} / 三手 {C})
325
+ - 质量验证: 合格率 {X}%,教学质量均分 {X.X}/5.0
326
+ - learn-synthesizer 版本: v{version}
327
+ ```
328
+
329
+ ---
330
+
331
+ ## 7. 各阶段集成改动
332
+
333
+ ### 7.1 需要修改的 workflow 文件
334
+
335
+ | 文件 | 改动 |
336
+ |------|------|
337
+ | `stage1-collect.md` | 资料清单保存路径从根目录 `资料清单.md` → `_internal/01-collect/source-list.md` |
338
+ | `stage2-extract.md` | 知识报告保存路径从 `knowledge-reports/report-NN.json` → `_internal/02-extract/kp-NN-{shortname}.json`;新增短名称要求 |
339
+ | `stage3-merge.md` | 大纲产物保存路径从根目录 → `_internal/03-merge/` |
340
+ | `stage4-write.md` | 教程章节产出路径无变化(已在 `tutorial/` 下);确保图表命名使用 `ch{NN}-{seq}_{desc}.drawio` |
341
+ | `stage4-ref-extract.md` | 参考文档产出路径无变化(已在 `tutorial/reference/` 下) |
342
+ | `stage4.5-verify.md` | 验证报告保存路径从根目录 → `_internal/04-verify/`;文件名使用 `verify-{batch}-ch{start}-ch{end}.md` 格式 |
343
+ | `stage6-finalize.md` | 增加 README.md 更新步骤;增加清理建议;引用 `understanding-map.md`(已在根目录) |
344
+ | `SKILL.md` | session-state.md 格式模板中的路径更新;RACK 表增加新条目 |
345
+
346
+ ### 7.2 向后兼容
347
+
348
+ - 现有工作区不强制迁移(参见 §8 迁移指南)
349
+ - `session-state.md` 中的旧路径作为历史记录保留
350
+ - 新工作区创建时直接采用本规范
351
+
352
+ ---
353
+
354
+ ## 8. 现有工作区迁移指南
355
+
356
+ 对于已生成的工作区(如 `数据处理与模型训练教程`),执行以下迁移:
357
+
358
+ ### 步骤1:创建 `_internal/` 目录结构
359
+
360
+ ```bash
361
+ mkdir -p _internal/01-collect
362
+ mkdir -p _internal/02-extract
363
+ mkdir -p _internal/03-merge
364
+ mkdir -p _internal/04-verify
365
+ ```
366
+
367
+ ### 步骤2:移动文件
368
+
369
+ | 原路径 | 新路径 |
370
+ |--------|--------|
371
+ | `资料清单.md` | `_internal/01-collect/source-list.md` |
372
+ | `knowledge-reports/report-*.json` | `_internal/02-extract/kp-*.json`(重命名) |
373
+ | `domain-overview.md` | `_internal/03-merge/domain-overview.md` |
374
+ | `importance-ratings.json` | `_internal/03-merge/importance-ratings.json` |
375
+ | `outline.md` | `_internal/03-merge/outline.md` |
376
+ | `outline-stats.json` | `_internal/03-merge/outline-stats.json` |
377
+ | `quality-report.md` | `_internal/04-verify/quality-report.md` |
378
+ | `verify-ch*.md` | `_internal/04-verify/`(保持原名,或按规范重命名) |
379
+
380
+ ### 步骤3:创建 README.md
381
+
382
+ 按 §6 模板生成,填入实际数据。
383
+
384
+ ### 步骤4:更新 session-state.md
385
+
386
+ 将阶段输出中的文件路径更新为新路径。
387
+
388
+ ---
389
+
390
+ ## 附录 A:当前工作区问题对照
391
+
392
+ 以 `数据处理与模型训练教程` 为例:
393
+
394
+ | # | 问题 | 具体表现 | 本规范解决 |
395
+ |---|------|---------|-----------|
396
+ | 1 | 知识报告从 02 开始 | `report-02.json`(01 丢失) | 要求从 01 开始连续编号 |
397
+ | 2 | 验证报告范围不规则 | `verify-ch10-11-14.md`(跳过了 12-13,但10-11,14 分在同一批次) | 格式化为 `verify-NN-chXX-chYY.md`(连续范围) |
398
+ | 3 | 中间文件散落根目录 | 10+ 个文件(verify×5 + quality-report + outline + ...) | 收入 `_internal/` 子目录 |
399
+ | 4 | 没有 README.md | 用户不知道从哪里开始 | 阶段 0 创建模板,阶段 6 最终填充 |
400
+ | 5 | 中英文命名混用 | `资料清单.md` vs `domain-overview.md` | 内部用英文,用户面向用中文 |
401
+ | 6 | diagrams 命名含中文 | `01-01_数据处理五阶段闭环.drawio` | 允许中文(draw.io 本身支持),但序号格式已规范 |
402
+ | 7 | session-state 引用旧路径 | 指向根目录的 verify 文件 | 更新为新路径 |
@@ -0,0 +1,72 @@
1
+ {
2
+ "skill_name": "learn-synthesizer",
3
+ "evals": [
4
+ {
5
+ "id": 1,
6
+ "name": "html-complete-tutorial",
7
+ "prompt": "我想系统学习 HTML,我在 <LEARN_ROOT> 目录里放了 12 份文档(Basic Tags.md、Textual Tags.md、Grouping Text.md、Standard Attributes.md、Lists and Types.md、Table Tag.md、Embedding Media.md、Using Forms.md、Styling Basics.md、Including JavaScript.md、Markup Languages.md、Frontend Development.md)。帮我把这些文档整合成一份从入门到精通的完整中文 HTML 教程,输出到 <USER_HOME>\\Desktop\\Learn\\html-tutorial 目录",
8
+ "expected_output": "包含学习路线图 + 分章节教程的文件夹,知识点按初学/熟练/精通三级分类,主体为中文,专业术语保留英文",
9
+ "files": ["<LEARN_ROOT>\\"],
10
+ "assertions": [
11
+ {
12
+ "id": "a1",
13
+ "name": "输出为多文件结构",
14
+ "description": "输出目录中存在至少 3 个 .md 文件(内容超过 3000 字应分章节)"
15
+ },
16
+ {
17
+ "id": "a2",
18
+ "name": "包含学习路线图",
19
+ "description": "输出目录中存在以 '00' 或 '路线图' 命名的文件,或单文件中包含'学习路线图'章节"
20
+ },
21
+ {
22
+ "id": "a3",
23
+ "name": "知识分级标记存在",
24
+ "description": "输出文件中包含 [初学]/[熟练]/[精通] 文本分级标记"
25
+ },
26
+ {
27
+ "id": "a4",
28
+ "name": "中文主体输出",
29
+ "description": "教程主体为简体中文,专业术语保留英文原文(如 <p> tag、attribute 等)"
30
+ },
31
+ {
32
+ "id": "a5",
33
+ "name": "包含代码示例",
34
+ "description": "教程中包含至少 5 个代码块(HTML 示例代码)"
35
+ }
36
+ ]
37
+ },
38
+ {
39
+ "id": 2,
40
+ "name": "html-quick-reference",
41
+ "prompt": "我是零基础前端新手,时间有限,只想快速了解 HTML 核心概念。请参考这三份文档帮我快速梳理:<LEARN_ROOT>\\Basic Tags.md、<LEARN_ROOT>\\Standard Attributes.md、<LEARN_ROOT>\\Styling Basics.md",
42
+ "expected_output": "单个 markdown 笔记文件,包含核心概念大纲和关键知识点,不需要完整教程",
43
+ "files": [
44
+ "<LEARN_ROOT>\\Basic Tags.md",
45
+ "<LEARN_ROOT>\\Standard Attributes.md",
46
+ "<LEARN_ROOT>\\Styling Basics.md"
47
+ ],
48
+ "assertions": [
49
+ {
50
+ "id": "a1",
51
+ "name": "正确识别快速参考模式",
52
+ "description": "输出应为单个 .md 文件或精简笔记,而非多文件文件夹"
53
+ },
54
+ {
55
+ "id": "a2",
56
+ "name": "中文主体输出",
57
+ "description": "笔记主体为简体中文"
58
+ },
59
+ {
60
+ "id": "a3",
61
+ "name": "覆盖三个文档主题",
62
+ "description": "笔记中包含 Tag/标签、Attribute/属性、CSS 样式三个主题的内容"
63
+ },
64
+ {
65
+ "id": "a4",
66
+ "name": "初学者友好",
67
+ "description": "包含知识等级标记或明确说明哪些是核心必学概念,没有深入底层原理"
68
+ }
69
+ ]
70
+ }
71
+ ]
72
+ }
@@ -0,0 +1,20 @@
1
+ # 领域主轴分类法(Organizing Axis)
2
+
3
+ > 在阶段0.5 初判、阶段3.0 校验时使用。主轴决定:地图形态、深潜的纵轴叙事方式、深度档判定标准、评估维度配套。
4
+ > 判错是可纠正的:阶段3.0 用收集到的资料复核,翻案属正常流程,不算返工事故。
5
+
6
+ ## 四类主轴
7
+
8
+ | 主轴 | 典型领域 | 判定线索 | 地图形态 | 深潜纵轴叙事 | 深度档判定标准 | 评估维度配套 |
9
+ |------|---------|---------|---------|-------------|---------------|-------------|
10
+ | **概念依赖** | 数学、力学、ML/DL 理论 | 概念间前置关系密集;"X 是 Y 的前提"高频出现 | 概念依赖图(大纲本身即地图,不重复产出) | 从前置到推论的逻辑推导链 | 是否必经节点(抽掉它下游全断) | 必经性、推导深度、应用广度 |
11
+ | **任务路径** | 工具、框架、平台使用 | 学习目标是"会用/做对事";资料以操作步骤为主 | 任务进阶路径图(安装 → 核心工作流 → 高级场景 → 排错) | 功能/工作流进阶链 | 使用频率 × 任务关键性 | 生态活跃度、学习曲线、可替代性、维护状态 |
12
+ | **时间×因果链** | 技术史、范式演进 | 核心问题是"为什么出现、取代了谁";资料时间线索密集 | 演变全景图(瓶颈→突破链;模板 `templates/map-evolution.md`) | 来龙去脉(瓶颈 → 突破 → 新瓶颈) | 范式层级 / 因果链必经节点 | 六维评估轴:瓶颈驱动力、范式层级、Scaling 亲和度、遗产与淘汰、工程成熟度、能力边界 |
13
+ | **横截面格局** | 生态、选型、市场 | 核心问题是"现在格局如何、选谁" | 竞争格局图(横轴为主 + 简史纵轴) | 简史(压缩版,只保留塑造当下格局的关键节点) | 生态位重要性 × 与 Mission 相关度 | 份额与趋势、护城河、风险、替代成本 |
14
+ | **混合 / 其他** | — | 单一轴装不下 | 阶段3.0 复核时与用户共同定形 | 自定义 | 自定义并写入 MISSION.md | 自定义并写入 MISSION.md |
15
+
16
+ ## 通用规则
17
+
18
+ - **横轴通用**:四类主轴的深潜都包含横轴对比(同类/同期方案对比 + "为什么是它活下来/被选中"),变化的只是纵轴。
19
+ - **主轴不等于章节顺序**:章节顺序永远是学习路径(由依赖和难度决定);主轴决定的是教程之外的地图层与深潜方式。
20
+ - **概念依赖轴不产出地图层**:它的地图就是大纲本身,重复产出只会腐烂。