dsh-learn-mode 0.1.2 → 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.
- package/client/client.js +452 -0
- package/cordis.patch.yml +20 -16
- package/index.js +19 -0
- package/package.json +42 -13
- package/skills/dsh-learn-mode/SKILL.md +7 -5
- package/skills/learn-synthesizer/SKILL.md +278 -0
- package/skills/learn-synthesizer/analysis/workspace-file-convention.md +402 -0
- package/skills/learn-synthesizer/evals/evals.json +72 -0
- package/skills/learn-synthesizer/references/axis-types.md +20 -0
- package/skills/learn-synthesizer/references/example-structures.md +291 -0
- package/skills/learn-synthesizer/references/feedback-types.md +296 -0
- package/skills/learn-synthesizer/references/gotchas.md +322 -0
- package/skills/learn-synthesizer/references/sub-agent-prompt.md +222 -0
- package/skills/learn-synthesizer/rules/core-principles.md +173 -0
- package/skills/learn-synthesizer/rules/output-format.md +355 -0
- package/skills/learn-synthesizer/rules/quality-gates.md +209 -0
- package/skills/learn-synthesizer/scripts/pdf_to_md.py +124 -0
- package/skills/learn-synthesizer/templates/MISSION.md +38 -0
- package/skills/learn-synthesizer/templates/deep-dive.md +73 -0
- package/skills/learn-synthesizer/templates/map-evolution.md +38 -0
- package/skills/learn-synthesizer/templates/understanding-map.md +42 -0
- package/skills/learn-synthesizer/workflows/stage0.5-mission.md +141 -0
- package/skills/learn-synthesizer/workflows/stage1-collect.md +214 -0
- package/skills/learn-synthesizer/workflows/stage2-extract.md +254 -0
- package/skills/learn-synthesizer/workflows/stage2.5-importance.md +197 -0
- package/skills/learn-synthesizer/workflows/stage3-merge.md +492 -0
- package/skills/learn-synthesizer/workflows/stage3.5-gap.md +317 -0
- package/skills/learn-synthesizer/workflows/stage4-chapter-agent.md +342 -0
- package/skills/learn-synthesizer/workflows/stage4-ref-extract.md +111 -0
- package/skills/learn-synthesizer/workflows/stage4-write.md +355 -0
- package/skills/learn-synthesizer/workflows/stage4.5-verify.md +327 -0
- package/skills/learn-synthesizer/workflows/stage5-review.md +196 -0
- package/skills/learn-synthesizer/workflows/stage5.5-iterate.md +297 -0
- package/skills/learn-synthesizer/workflows/stage6-finalize.md +310 -0
- package/skills/learn-synthesizer/workflows/stage6-progressive.md +173 -0
- package/skills-provider.mjs +99 -0
- package/workbench-host.mjs +425 -0
|
@@ -0,0 +1,492 @@
|
|
|
1
|
+
# 阶段3:合并大纲
|
|
2
|
+
|
|
3
|
+
汇总所有知识报告,先建立领域整体认知,再通过"分级三问"对知识点分类、去重、验证,生成结构化大纲。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 3.0 领域学习路径认知(先于分级三问执行)
|
|
8
|
+
|
|
9
|
+
**目的**:在开始堆砌知识点之前,先对"这个领域是什么,从浅到深的主线是什么"建立整体认知,避免教程成为知识点的堆砌而失去学习脉络。
|
|
10
|
+
|
|
11
|
+
### 执行步骤
|
|
12
|
+
|
|
13
|
+
**步骤1:汇总 topic_context**
|
|
14
|
+
|
|
15
|
+
从所有知识报告中收集 `topic_context` 字段(origin / evolution / current_status / applications),去重合并,生成 `_internal/03-merge/domain-overview.md`:
|
|
16
|
+
|
|
17
|
+
```markdown
|
|
18
|
+
# [主题] 领域概览
|
|
19
|
+
|
|
20
|
+
## 是什么
|
|
21
|
+
[汇总各资料的领域定位描述]
|
|
22
|
+
|
|
23
|
+
## 怎么来的(起源与演进)
|
|
24
|
+
[汇总 origin + evolution,按时间线梳理]
|
|
25
|
+
|
|
26
|
+
## 当前发展现状与前景
|
|
27
|
+
[汇总 current_status]
|
|
28
|
+
|
|
29
|
+
## 典型应用
|
|
30
|
+
[汇总 applications,列主要使用场景]
|
|
31
|
+
|
|
32
|
+
## 由浅入深的学习主线
|
|
33
|
+
[根据知识报告中的知识点,手动归纳出 3-5 个核心学习阶段,例如:"环境安装 → 基础语法 → 核心 API → 项目实战 → 性能优化"。这是路线图的骨架。]
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**步骤2:向用户展示领域概览**
|
|
37
|
+
|
|
38
|
+
> "已汇总领域背景。[主题] 的核心学习主线为:
|
|
39
|
+
> [学习主线]
|
|
40
|
+
>
|
|
41
|
+
> 接下来将基于这条主线合并知识点大纲。是否继续?"
|
|
42
|
+
|
|
43
|
+
用户确认后,进入 3.1。
|
|
44
|
+
|
|
45
|
+
**注意**:`topic_context` 字段来自资料,某些字段可能为 null。null 字段直接省略,不要根据先验知识补全。
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
### 输出决策(在此阶段确定,不等到撰写期)
|
|
50
|
+
|
|
51
|
+
根据领域概览中的"学习主线"和主题宽窄,**现在**决定最终输出形式:
|
|
52
|
+
|
|
53
|
+
| 判断标准 | 输出形式 | 说明 |
|
|
54
|
+
|---------|---------|------|
|
|
55
|
+
| 主题宽泛,学习主线有 3+ 个明显阶段 | 文件夹(多文件) | 各阶段内容独立,章节间有依赖顺序 |
|
|
56
|
+
| 主题专一,聚焦单一技术或特性 | 单 Markdown 文件 | 知识点关联紧密,拆章节反而割裂 |
|
|
57
|
+
| 快速参考模式(无论主题宽窄) | 单文件笔记 | 用户只需快速建立工作认知 |
|
|
58
|
+
|
|
59
|
+
> 如果判断存在争议,默认推荐**文件夹**(可扩展,后续不用重构),需用户确认后执行。
|
|
60
|
+
|
|
61
|
+
向用户告知决定:"本主题较[宽泛/专一],将生成[文件夹/单文件]格式的教程,确认吗?"
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
### 主轴校验(复核阶段0.5 的初判)
|
|
66
|
+
|
|
67
|
+
domain-overview.md 汇总了资料中的 origin/evolution/current_status 线索,用它复核 MISSION.md 中的主轴字段:
|
|
68
|
+
|
|
69
|
+
- 资料线索与初判一致 → 确认,MISSION.md 复核状态改为"阶段3.0 已复核"
|
|
70
|
+
- 资料线索与初判矛盾(如初判"任务路径",但资料大量篇幅在讲版本演进与方案更替)→ 向用户展示证据,建议翻案;用户同意后更新 MISSION.md 主轴字段,后续地图/深潜按新主轴执行
|
|
71
|
+
- 主轴为 [跳过](快速参考模式)→ 跳过本步骤
|
|
72
|
+
|
|
73
|
+
### 地图层产出决策
|
|
74
|
+
|
|
75
|
+
- 主轴为**概念依赖** → 大纲本身就是地图,不重复产出
|
|
76
|
+
- 主轴为**其他三类或混合** → 大纲确认后生成地图层文件 `00-地图.md`(工作区根目录,单文件起步;节点规模大到单文件难维护时拆为 `00-地图/` 目录),形态与字段按 `references/axis-types.md` 中该主轴的配套执行;时间×因果链主轴使用 `templates/map-evolution.md` 模板
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 3.1 分级三问(分类器)
|
|
81
|
+
|
|
82
|
+
> 本章节使用**学习阶段体系**(初学/熟练/精通),目的是给知识点分类到正确的学习阶段,决定放在教程的哪个章节。
|
|
83
|
+
|
|
84
|
+
对每个知识点,逐一追问以下三个问题。
|
|
85
|
+
|
|
86
|
+
**核心目的**:给每个知识点找到正确的位置,**不是过滤掉它**。学习教程需要系统完整性,特别是初学阶段的内容,宁多勿少。
|
|
87
|
+
|
|
88
|
+
### 问题1:这个知识点属于哪个学习等级?
|
|
89
|
+
|
|
90
|
+
| 等级 | 判断依据 | 示例 |
|
|
91
|
+
|------|---------|------|
|
|
92
|
+
| `初学` | 入门必须理解、是其他概念的前提、教程第一章通常涵盖 | "什么是组件"、"如何创建变量" |
|
|
93
|
+
| `熟练` | 日常开发频繁使用、不掌握无法完成实际项目 | "状态管理"、"异步处理" |
|
|
94
|
+
| `精通` | 底层原理、性能调优、高级设计模式、官方文档 Advanced 章节 | "虚拟 DOM 原理"、"编译优化" |
|
|
95
|
+
|
|
96
|
+
**拿不准时**:标注「等级待确认」,不要强行归类。在 §3.4 展示大纲时一并列出所有「待确认」项,请用户裁决。
|
|
97
|
+
|
|
98
|
+
### 问题2:是否与已有条目完全重复?
|
|
99
|
+
|
|
100
|
+
| 情况 | 处理方式 |
|
|
101
|
+
|------|---------|
|
|
102
|
+
| 完全重复(相同内容、相同角度) | 合并进已有条目,保留来源更权威的描述 |
|
|
103
|
+
| 有新补充或不同表达角度 | 合并到已有条目,丰富其 summary |
|
|
104
|
+
| 来自不同技术年代的同名概念 | **不合并**,按 `tech_era` 隔离分组 |
|
|
105
|
+
|
|
106
|
+
**示例**:
|
|
107
|
+
- 资料A说"useState 用于状态管理",资料B说"useState 是 React Hook,用于在函数组件中添加状态" → 合并,保留B的描述(更详细)
|
|
108
|
+
- 资料A讲"jQuery 时代的 AJAX",资料B讲"现代 fetch API" → 不合并,按 `tech_era` 隔离
|
|
109
|
+
|
|
110
|
+
### 问题3:来源是否可靠?
|
|
111
|
+
|
|
112
|
+
| 情况 | 处理方式 |
|
|
113
|
+
|------|---------|
|
|
114
|
+
| 一手资料或至少两份来源支持 | 直接纳入,标注所有来源 |
|
|
115
|
+
| 仅来自单一三手资料 | 纳入大纲,标注「待验证」,建议用户后续查阅官方文档确认 |
|
|
116
|
+
|
|
117
|
+
**规则**:所有知识点都应进入大纲(即使是「待验证」状态),唯一真正剔除的是**与已有条目内容和角度完全相同的副本**。
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## 3.2 冲突处理
|
|
122
|
+
|
|
123
|
+
**绝不静默解决矛盾**。遇到 Sub-agent 报告中的 `conflicts` 时:
|
|
124
|
+
|
|
125
|
+
### 处理原则
|
|
126
|
+
|
|
127
|
+
1. **保留双方观点**和各自的 `evidence`
|
|
128
|
+
2. **在大纲中标注** `[VERSION_CONFLICT]`,记录来源
|
|
129
|
+
3. **不同 `tech_era` 的方案强制隔离**,不合并
|
|
130
|
+
|
|
131
|
+
### 冲突标注格式
|
|
132
|
+
|
|
133
|
+
```
|
|
134
|
+
特性D:一句话描述
|
|
135
|
+
[VERSION_CONFLICT]
|
|
136
|
+
- 旧方案(jQuery 时代):xxx | 来源:文档A | 依据:xxx
|
|
137
|
+
- 新方案(React 18+):xxx | 来源:文档B | 依据:xxx
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### 错误示例
|
|
141
|
+
|
|
142
|
+
- [错误] "文档A说方案X,但文档B更新,所以采用文档B的方案Y"
|
|
143
|
+
- [错误] "这两份资料矛盾,我选择来自官方文档的说法"
|
|
144
|
+
|
|
145
|
+
### 正确示例
|
|
146
|
+
|
|
147
|
+
- [正确] 保留双方观点,标注 `[VERSION_CONFLICT]`
|
|
148
|
+
- [正确] 在最终教程中用表格展示版本差异(参见 `rules/output-format.md`)
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 3.2.5 大纲组织原则:任务驱动优先于等级堆砌
|
|
153
|
+
|
|
154
|
+
**默认组织方式 = 任务驱动 → 原理深入,而非按初学/熟练/精通等级堆砌。**
|
|
155
|
+
|
|
156
|
+
大纲合并时,优先思考:
|
|
157
|
+
1. 如果读者要完成一件事(如"在预训练中从头训练一个模型"),他需要按什么顺序知道什么?
|
|
158
|
+
2. 上一个知识点自然引出下一个知识点的桥梁是什么?
|
|
159
|
+
|
|
160
|
+
只有以下情况允许按等级组织:
|
|
161
|
+
- 主题缺少自然工作流(如"编程语言特性对比"、"前端框架横评")
|
|
162
|
+
- 用户 Mission 明确标注"按深度分层学习"
|
|
163
|
+
|
|
164
|
+
**验证方法**:大纲完成后自检——相邻两个知识点之间是否存在自然的叙事推进(A→B),还是仅靠等级标签("初学→熟练")维持关系。如果出现连续的等级标签跳跃而无叙事连接,回到任务流重新组织。
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 3.3 合并后大纲格式
|
|
169
|
+
|
|
170
|
+
```markdown
|
|
171
|
+
主题:[学习领域]
|
|
172
|
+
|
|
173
|
+
[初学]
|
|
174
|
+
- 概念A:一句话描述 | 来源:文档X、文档Y | 示例:有
|
|
175
|
+
- 概念B:一句话描述 | 来源:文档Y | 【待验证】
|
|
176
|
+
|
|
177
|
+
[熟练]
|
|
178
|
+
- 特性C:一句话描述 | 来源:文档X、文档Z
|
|
179
|
+
- 特性D:一句话描述
|
|
180
|
+
[VERSION_CONFLICT]
|
|
181
|
+
- 旧方案(jQuery 时代):xxx | 来源:文档A | 依据:xxx
|
|
182
|
+
- 新方案(React 18+):xxx | 来源:文档B | 依据:xxx
|
|
183
|
+
|
|
184
|
+
[精通]
|
|
185
|
+
- 原理E:一句话描述 | 来源:文档Z
|
|
186
|
+
|
|
187
|
+
[待补充]
|
|
188
|
+
- 缺失主题1(来自 coverage_gaps)
|
|
189
|
+
- 缺失主题2(来自 coverage_gaps)
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## 3.3.5 Mission 驱动的 Out of Scope 降级
|
|
195
|
+
|
|
196
|
+
大纲合并完成后,若工作区中存在已固化的 `MISSION.md` 且 `Out of Scope` 非空,执行以下处理:
|
|
197
|
+
|
|
198
|
+
**对每个知识点检查**:该知识点或其所属领域是否与 Mission.Out of Scope 中列出的内容匹配。
|
|
199
|
+
|
|
200
|
+
| 匹配情况 | 处理 |
|
|
201
|
+
|---------|------|
|
|
202
|
+
| 知识点直接属于 Out of Scope 领域 | 学习阶段不变,**重要性强制降为 [了解]**,标注 `[已排除: Mission Out of Scope]` |
|
|
203
|
+
| 知识点与 Out of Scope 相关但非核心 | 学习阶段不变,重要性降一档(核心→重要,重要→了解),标注 `[降级: 非 Mission 重点]` |
|
|
204
|
+
|
|
205
|
+
**降级不等于删除**:降级为 [了解] 的知识点仍保留在大纲中,阶段4撰写时只给简述+外链。用户后续若改变需求,可通过渐进深化恢复完整深度。
|
|
206
|
+
|
|
207
|
+
Mission 为 [UNDEFINED] 时跳过此步。
|
|
208
|
+
|
|
209
|
+
---
|
|
210
|
+
|
|
211
|
+
## 3.4 向用户展示大纲并确认
|
|
212
|
+
|
|
213
|
+
展示大纲摘要(章节标题层级),说明:
|
|
214
|
+
|
|
215
|
+
> "大纲合并完成。
|
|
216
|
+
>
|
|
217
|
+
> **统计信息**:
|
|
218
|
+
> - 各等级知识点数量:初学 N 个 / 熟练 M 个 / 精通 K 个
|
|
219
|
+
> - 合并去重:X 个重复知识点已合并
|
|
220
|
+
> - 版本冲突:发现 Y 处版本差异
|
|
221
|
+
> - 覆盖缺口:Z 个主题在资料中被提及但未详细说明
|
|
222
|
+
> - 等级待确认:W 个知识点等级不确定,需要您裁决
|
|
223
|
+
>
|
|
224
|
+
> **大纲预览**:
|
|
225
|
+
> [初学]
|
|
226
|
+
> - 概念A
|
|
227
|
+
> - 概念B
|
|
228
|
+
> [熟练]
|
|
229
|
+
> - 特性C
|
|
230
|
+
> - 特性D [VERSION_CONFLICT]
|
|
231
|
+
> [待确认]
|
|
232
|
+
> - 概念X(当前暂归「熟练」,请确认等级)
|
|
233
|
+
> - 概念Y(当前暂归「精通」,请确认等级)
|
|
234
|
+
> ...
|
|
235
|
+
>
|
|
236
|
+
> 请确认大纲是否满意?"
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## 3.4.5 主题级重要性评级(大纲确认后立即执行)
|
|
241
|
+
|
|
242
|
+
> 本章节使用**重要性深度体系**(核心/重要/了解),目的是决定每个知识点的撰写深度和资源分配。与 §3.1 的学习阶段体系相互独立。
|
|
243
|
+
|
|
244
|
+
大纲确认后,在进入阶段3.5缺口识别之前,对大纲中每个**知识点(主题)**进行重要性评级,决定撰写深度。
|
|
245
|
+
|
|
246
|
+
这一步与阶段2.5的领域评级形成两个层级:阶段2.5解决"哪个领域需要更多资料",阶段3.4.5解决"哪个知识点需要写得更深"。
|
|
247
|
+
|
|
248
|
+
### 步骤1:AI 初评
|
|
249
|
+
|
|
250
|
+
读取 `_internal/03-merge/importance-ratings.json` 中 `domains` 的评级结果。大纲中属于"核心必掌握"领域的知识点,默认初评为"核心"或"重要";属于"了解即可"领域的知识点默认初评为"了解"。
|
|
251
|
+
|
|
252
|
+
在此基础上,对每个知识点再用以下两个**细粒度维度**校正:
|
|
253
|
+
|
|
254
|
+
| 维度 | 高 | 低 |
|
|
255
|
+
|------|---|---|
|
|
256
|
+
| **该知识点在该领域内的基础性** | 领域内其他知识点的前置 | 独立知识,不是其他的前提 |
|
|
257
|
+
| **误解该知识点的典型后果** | 产生难以察觉的 bug 或安全问题 | 只影响代码风格或性能 |
|
|
258
|
+
|
|
259
|
+
两个维度都高:升一级;都低:降一级;一高一低:保持领域默认等级。
|
|
260
|
+
|
|
261
|
+
### 步骤2:向用户展示初评,批量确认
|
|
262
|
+
|
|
263
|
+
按章节组织展示,格式紧凑:
|
|
264
|
+
|
|
265
|
+
```
|
|
266
|
+
> **主题重要性评级——请确认或指出需调整项**
|
|
267
|
+
>
|
|
268
|
+
> **第2章 Hooks(领域等级:核心必掌握)**
|
|
269
|
+
> | 知识点 | 细粒度调整 | 最终等级 | 撰写深度 |
|
|
270
|
+
> |--------|-----------|---------|---------|
|
|
271
|
+
> | useState 基本用法 | 前置↑、bug↑ → 升级 | [核心] | 3例+深度原理 |
|
|
272
|
+
> | useState 异步性 | 前置↑、bug↑ → 升级 | [核心] | 3例+深度原理 |
|
|
273
|
+
> | useEffect 依赖数组 | 前置↑、bug↑ → 升级 | [核心] | 3例+深度原理 |
|
|
274
|
+
> | useEffect 清理函数 | 前置-、bug↑ → 保持 | [重要] | 1-2例 |
|
|
275
|
+
> | 自定义 Hook | 前置-、bug- → 降级 | [了解] | 简述+外链 |
|
|
276
|
+
>
|
|
277
|
+
> **第4章 性能优化(领域等级:重要)**
|
|
278
|
+
> | 知识点 | 细粒度调整 | 最终等级 | 撰写深度 |
|
|
279
|
+
> ...
|
|
280
|
+
>
|
|
281
|
+
> 如需调整,请说明(如"将自定义 Hook 调整为重要")。确认后回复"确认"。
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
### 步骤3:将主题评级写入 importance-ratings.json
|
|
285
|
+
|
|
286
|
+
用户确认后,填入 `topics` 数组:
|
|
287
|
+
|
|
288
|
+
```json
|
|
289
|
+
{
|
|
290
|
+
"topics": [
|
|
291
|
+
{
|
|
292
|
+
"chapter": "02-Hooks.md",
|
|
293
|
+
"topic": "useState 异步性",
|
|
294
|
+
"level": "core",
|
|
295
|
+
"depth": {
|
|
296
|
+
"examples": 3,
|
|
297
|
+
"search_supplement": true,
|
|
298
|
+
"extra_search_count": 2
|
|
299
|
+
}
|
|
300
|
+
},
|
|
301
|
+
{
|
|
302
|
+
"chapter": "02-Hooks.md",
|
|
303
|
+
"topic": "自定义 Hook",
|
|
304
|
+
"level": "reference",
|
|
305
|
+
"depth": {
|
|
306
|
+
"examples": 0,
|
|
307
|
+
"search_supplement": false,
|
|
308
|
+
"extra_search_count": 0
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
]
|
|
312
|
+
}
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
### 步骤3.5:深度档判定(深潜 / 通读 / 知晓)
|
|
316
|
+
|
|
317
|
+
重要性等级决定"写多深",深度档回答另一个问题:**对用户而言,现在值不值得花时间**。深度档是动态属性,随学习进程可上调下调。
|
|
318
|
+
|
|
319
|
+
**前置条件**:必须先读取 MISSION.md 的 Why/Success——深度档是学习目的的函数,不是知识点的固有属性。Mission 为 [UNDEFINED] 时,深度档只给临时档,并在展示时提示"补写 Mission 后需重评"。
|
|
320
|
+
|
|
321
|
+
**判定标准**(按 MISSION.md 的主轴选择,详见 `references/axis-types.md`):
|
|
322
|
+
|
|
323
|
+
| 主轴 | 深度档判定标准 |
|
|
324
|
+
|------|---------------|
|
|
325
|
+
| 概念依赖 | 是否必经节点(抽掉它下游全断) |
|
|
326
|
+
| 任务路径 | 使用频率 × 任务关键性 |
|
|
327
|
+
| 时间×因果链 | 范式层级 / 因果链必经节点 |
|
|
328
|
+
| 横截面格局 | 生态位重要性 × 与 Mission 相关度 |
|
|
329
|
+
|
|
330
|
+
**档位与映射**:
|
|
331
|
+
|
|
332
|
+
| 深度档 | 含义 | 与重要性等级的映射 | 产物 |
|
|
333
|
+
|--------|------|-------------------|------|
|
|
334
|
+
| 【深潜】 | 现在值得完整讲透 | ≈核心,且另产出独立深潜文档(模板 `templates/deep-dive.md`) | 教程章节写透 + 深潜文档 |
|
|
335
|
+
| 【通读】 | 知道是什么、为什么、在地图的哪个位置 | ≈重要 | 教程章节内完整覆盖 |
|
|
336
|
+
| 【知晓】 | 一句话定位+链接,明确"现在不值得花时间" | ≈了解 | 地图节点一句话+外链 |
|
|
337
|
+
|
|
338
|
+
深度档写入 importance-ratings.json 的 topics 条目(新增 `depth_tier` 字段:`dive` / `read` / `aware`),并在地图层文件(如有)的节点上标注。
|
|
339
|
+
|
|
340
|
+
### 步骤4:核心主题专项搜索
|
|
341
|
+
|
|
342
|
+
对 `level: "core"` 且 `search_supplement: true` 的知识点,在阶段3.5之前补搜额外资料:
|
|
343
|
+
|
|
344
|
+
- 搜索关键词聚焦该知识点的**难点、边界、常见错误**
|
|
345
|
+
- 每个核心知识点补搜 1-2 篇(避免膨胀,精准搜索)
|
|
346
|
+
- **去重规则**:搜索到的 URL 若已存在于阶段1或阶段2.5的资料清单中,直接复用已有知识报告,不重复派发 Sub-agent 提取。仅在 URL 为新来源时派发 Sub-agent,新报告保存到 `_internal/02-extract/`
|
|
347
|
+
- 补搜阶段与阶段2.5是互补关系:阶段2.5解决"领域资料是否充分"(广度),这里解决"某个核心知识点的边界和难点有没有资料覆盖"(深度)。两轮补搜结果不重复处理同一 URL
|
|
348
|
+
|
|
349
|
+
---
|
|
350
|
+
|
|
351
|
+
## 3.5 进入下一阶段
|
|
352
|
+
|
|
353
|
+
### 分支判断(阶段决策树)
|
|
354
|
+
|
|
355
|
+
**检查是否需要进入阶段3.5(缺口识别)**:
|
|
356
|
+
|
|
357
|
+
参见 SKILL.md 的"阶段决策树",满足以下任一条件时触发阶段3.5:
|
|
358
|
+
- 某章节的所有知识点来自同一份资料(来源单一)
|
|
359
|
+
- coverage_gaps 中提到的主题在大纲中没有对应章节(覆盖不足)
|
|
360
|
+
- 某知识点有 VERSION_CONFLICT 但双方证据都来自三手资料(冲突未解)
|
|
361
|
+
|
|
362
|
+
**如果满足条件**:
|
|
363
|
+
1. 向用户展示缺口报告
|
|
364
|
+
2. 询问是否补充搜索
|
|
365
|
+
3. 用户确认后进入 `workflows/stage3.5-gap.md`
|
|
366
|
+
|
|
367
|
+
**如果都不满足**:
|
|
368
|
+
1. 向用户说明:"大纲质量检查通过,所有章节都有多来源支持,覆盖完整。"
|
|
369
|
+
2. 询问:"是否需要额外补充资料?(通常不需要)"
|
|
370
|
+
3. 用户回复"不需要" → 进入阶段4
|
|
371
|
+
|
|
372
|
+
---
|
|
373
|
+
|
|
374
|
+
## 3.6 保存大纲
|
|
375
|
+
|
|
376
|
+
将合并后的大纲保存到工作区:
|
|
377
|
+
|
|
378
|
+
```
|
|
379
|
+
工作区/
|
|
380
|
+
├── outline.md ← 大纲文件
|
|
381
|
+
└── outline-stats.json ← 统计信息
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
**outline-stats.json 格式**:
|
|
385
|
+
```json
|
|
386
|
+
{
|
|
387
|
+
"total_knowledge_points": 50,
|
|
388
|
+
"by_level": {
|
|
389
|
+
"初学": 15,
|
|
390
|
+
"熟练": 25,
|
|
391
|
+
"精通": 10
|
|
392
|
+
},
|
|
393
|
+
"merged_duplicates": 8,
|
|
394
|
+
"version_conflicts": 3,
|
|
395
|
+
"coverage_gaps": ["主题1", "主题2"],
|
|
396
|
+
"sources": {
|
|
397
|
+
"primary": 5,
|
|
398
|
+
"secondary": 10,
|
|
399
|
+
"tertiary": 3
|
|
400
|
+
}
|
|
401
|
+
}
|
|
402
|
+
```
|
|
403
|
+
|
|
404
|
+
---
|
|
405
|
+
|
|
406
|
+
## 3.7 保存会话状态
|
|
407
|
+
|
|
408
|
+
用户确认大纲后,更新工作区的 `session-state.md`:
|
|
409
|
+
|
|
410
|
+
```markdown
|
|
411
|
+
# 会话状态
|
|
412
|
+
主题: [主题名]
|
|
413
|
+
更新时间: [当前时间]
|
|
414
|
+
学习模式: [快速参考 / 完整教程]
|
|
415
|
+
工作区: [工作区绝对路径]
|
|
416
|
+
|
|
417
|
+
---
|
|
418
|
+
|
|
419
|
+
## 进度
|
|
420
|
+
当前阶段: 4
|
|
421
|
+
已完成阶段: 1, 2, 3
|
|
422
|
+
|
|
423
|
+
## 阶段输出
|
|
424
|
+
- **阶段1**: 资料清单.md — [N]份资料([A]一手 / [B]二手 / [C]三手)
|
|
425
|
+
- **阶段2**: _internal/02-extract/ — [X]个知识点(初学[a]/熟练[b]/精通[c])
|
|
426
|
+
- **阶段3**: domain-overview.md(领域概览)、outline.md, outline-stats.json — 输出形式:[文件夹/单文件],[Y]处VERSION_CONFLICT,[Z]项coverage_gap
|
|
427
|
+
|
|
428
|
+
## 阶段4 章节状态
|
|
429
|
+
已完成: (暂无)
|
|
430
|
+
待完成:
|
|
431
|
+
- [根据 outline.md 列出所有待写章节文件名]
|
|
432
|
+
|
|
433
|
+
---
|
|
434
|
+
|
|
435
|
+
## 恢复指令
|
|
436
|
+
读取 outline.md 了解大纲结构,读取 outline-stats.json 了解知识点统计,继续阶段4(生成教程)。从第一个"待完成"章节开始撰写。
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
---
|
|
440
|
+
|
|
441
|
+
## 3.8 进入阶段4
|
|
442
|
+
|
|
443
|
+
用户确认大纲满意后,读取 `workflows/stage4-write.md` 执行阶段4。
|
|
444
|
+
|
|
445
|
+
---
|
|
446
|
+
|
|
447
|
+
## 常见问题
|
|
448
|
+
|
|
449
|
+
**Q1:如何判断两个知识点是否"完全重复"?**
|
|
450
|
+
|
|
451
|
+
A:检查以下维度:
|
|
452
|
+
1. 概念名称相同
|
|
453
|
+
2. 描述的核心内容相同
|
|
454
|
+
3. 讲解角度相同(如都是"基本用法",而非一个讲"基本用法"、一个讲"高级用法")
|
|
455
|
+
|
|
456
|
+
**Q2:不同 Sub-agent 对同一知识点的等级判断不一致怎么办?**
|
|
457
|
+
|
|
458
|
+
A:
|
|
459
|
+
1. 优先采用一手资料的判断
|
|
460
|
+
2. 如果都是一手资料,取较高的等级(如一个说"初学"、一个说"熟练",取"熟练")
|
|
461
|
+
3. 标注「等级待确认」,在阶段5让用户裁决
|
|
462
|
+
|
|
463
|
+
**Q3:coverage_gaps 列出的缺失主题太多(>10个),是否全部加入大纲?**
|
|
464
|
+
|
|
465
|
+
A:
|
|
466
|
+
1. 按重要程度排序(根据该主题在多少份资料中被提及)
|
|
467
|
+
2. 只将前5个最重要的缺失主题加入"[待补充]"
|
|
468
|
+
3. 其余的记录在 `_internal/03-merge/outline-stats.json` 的 `low_priority_gaps` 字段
|
|
469
|
+
|
|
470
|
+
**Q4:某个知识点没有 `tech_era` 字段(值为 null),是否需要手动判断?**
|
|
471
|
+
|
|
472
|
+
A:
|
|
473
|
+
- 如果该知识点是跨时代通用的(如"变量声明"),保持 null
|
|
474
|
+
- 如果该知识点明显有时代特征(如"class component"),根据资料内容推断年代
|
|
475
|
+
- 拿不准时保持 null,在阶段4撰写时再判断
|
|
476
|
+
|
|
477
|
+
---
|
|
478
|
+
|
|
479
|
+
## 执行检查清单
|
|
480
|
+
|
|
481
|
+
完成阶段3后,自检:
|
|
482
|
+
- [ ] 所有知识点都经过分级三问
|
|
483
|
+
- [ ] 重复知识点已合并
|
|
484
|
+
- [ ] 版本冲突已标注 `[VERSION_CONFLICT]`
|
|
485
|
+
- [ ] 不同 `tech_era` 的方案已隔离分组
|
|
486
|
+
- [ ] 大纲已保存到工作区
|
|
487
|
+
- [ ] 统计信息已展示给用户
|
|
488
|
+
- [ ] 已判断是否需要进入阶段3.5
|
|
489
|
+
|
|
490
|
+
- [ ] session-state.md 已更新,列出所有待完成章节
|
|
491
|
+
|
|
492
|
+
如果任一项为"否",补充完成后再进入下一阶段。
|