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.
Files changed (37) hide show
  1. package/client/client.js +452 -0
  2. package/cordis.patch.yml +20 -16
  3. package/index.js +19 -0
  4. package/package.json +42 -13
  5. package/skills/dsh-learn-mode/SKILL.md +7 -5
  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
@@ -0,0 +1,327 @@
1
+ # 阶段4.5:内容质量抽样验证
2
+
3
+ 在教程章节生成完成后、进入人工审核前,执行此阶段验证内容质量。
4
+
5
+ **设计思路**:参照大模型微调中的"数据质量评估与抽样检验"步骤。章节 agent 可能因输入不足、理解偏差或"脑补"产生低质量内容。阶段4.5在用户看到内容前拦截这些问题。
6
+
7
+ ---
8
+
9
+ ## 验证流程概览
10
+
11
+ ```
12
+ 所有章节撰写完成
13
+ ↓
14
+ 随机抽样知识点(20%-30%)
15
+ ↓
16
+ 并行派发验证 agent(每个抽样知识点一个)
17
+ ↓
18
+ 汇总判定(pass / 条件通过 / 不通过)
19
+ ↓
20
+ ├─ [通过] 通过 → 进入阶段5展示给用户
21
+ ├─ [条件] 条件通过 → 重新生成 fail/borderline 章节 → 再验证
22
+ └─ [失败] 不通过 → 向用户报告,建议返回阶段2补充搜索
23
+ ```
24
+
25
+ ---
26
+
27
+ ## 步骤1:随机抽样
28
+
29
+ 从所有已生成的章节中抽取知识点:
30
+
31
+ | 教程规模 | 抽样比例 | 最少抽样数 |
32
+ |---------|---------|-----------|
33
+ | 小型(< 30 知识点) | 30% | 5个 |
34
+ | 中型(30-100 知识点) | 20% | 10个 |
35
+ | 大型(> 100 知识点) | 15% | 15个 |
36
+
37
+ **抽样方法**:系统抽样(每 N 个知识点取1个),确保覆盖所有章节。
38
+
39
+ ---
40
+
41
+ ## 步骤2:派发验证 agent
42
+
43
+ 为每个抽样知识点并行派发一个独立验证 Sub-agent。所有验证 agent 在**同一轮**中发出。
44
+
45
+ ### 验证 agent 指令模板
46
+
47
+ ```
48
+ 你是内容质量审查员。客观、严格地评估教程章节中某个知识点的撰写质量。
49
+
50
+ ## 待评估内容
51
+
52
+ **知识点 ID**: [kp-XXX]
53
+ **所在章节**: [章节文件名]
54
+ **章节文件路径**: [工作区绝对路径]/[章节文件名]
55
+ **重要性等级**: [[核心] / [重要] / [了解]](来自 importance-ratings.json)
56
+
57
+ ## ground truth(事实依据)
58
+
59
+ 从阶段2知识报告中提取的源材料:
60
+
61
+ **知识报告 summary**:
62
+ [阶段2提取的完整 summary — WHAT+WHY+使用场景+核心原理]
63
+
64
+ **源材料摘录**(source_excerpt):
65
+ "[阶段2逐字引用的原文段落]"
66
+
67
+ [注意] 如果源材料摘录为空,此项无法验证事实准确性,请注记在 verdict 中。
68
+
69
+ ## 待评估的教程内容
70
+
71
+ 从章节文件中提取该知识点对应的撰写内容:
72
+ [摘录该知识点在章节中的完整段落 — 包括概念解释、类比、示例、注意事项]
73
+
74
+ ## 评估前:确认重要性等级
75
+
76
+ **评估开始前,先读取知识点的重要性等级**(来自上方"重要性等级"字段),并对照下表选择对应的评估方案:
77
+
78
+ | 等级 | 适用评估方案 | 教学价值检查项 | 强制 fail 条件 |
79
+ |------|------------|-------------|--------------|
80
+ | [核心] | 全量评估(4维度,pedagogy满6项) | 全部6项 | pedagogy < 2 |
81
+ | [重要] | 标准评估(4维度,pedagogy 4项) | 项1定义准确、项2有WHY、项4类比回归、项5自查可验证 | pedagogy < 2 |
82
+ | [了解] | 精简评估(仅2维度:准确性+示例相关性) | 仅项1定义准确(其余项对[了解]不适用,不计分) | 无强制fail(只要定义不错误即可) |
83
+
84
+ **[了解] 等级说明**:这是有意设计的精简写法(一句定义 + 可选示例),不应因"缺少WHY"或"只有一个示例"被扣分。评估时只检查"定义是否准确"和"示例是否相关"。
85
+
86
+ ---
87
+
88
+ ## 评估维度
89
+
90
+ ### 1. 事实准确性(权重 30%)
91
+ 对照源材料摘录和知识报告 summary,逐条检查生成的教程内容,包括定义精确度和术语规范性。
92
+
93
+ 打分标准:
94
+ - 5分:所有陈述与源材料完全一致,无任何编造或歪曲。技术细节精确,定义边界清晰,术语规范。
95
+ - 4分:整体正确,有轻微概括但不影响准确性,定义基本清晰。
96
+ - 3分:整体方向正确但有一两处过度概括导致精度损失,或缺少关键限定条件,或以类比替代了定义未作精确补充。
97
+ - 2分:多处不精确,或混入源材料没有的"常识性补充",或核心概念只有类比没有定义。
98
+ - 1分:存在与源材料明确矛盾的事实错误,或概念范畴根本性错误。
99
+
100
+ ### 2. 完整性(权重 25%)
101
+ 检查生成的教程是否覆盖了源材料中的关键信息。
102
+
103
+ 打分标准:
104
+ - 5分:完整覆盖了源材料的 WHAT+WHY+HOW+使用场景。重要细节无一遗漏。
105
+ - 4分:覆盖了绝大部分,遗漏1个次要细节但不影响理解。
106
+ - 3分:覆盖了主要内容但遗漏了1-2个关键细节(如边界条件、性能考量)。
107
+ - 2分:只覆盖了表层描述,大量核心信息丢失。
108
+ - 1分:与源材料相比,信息大量丢失,仅做了标题级别的描述。
109
+
110
+ ### 3. 教学价值(权重 30%)最重要维度
111
+ 评估生成的教程是否真正在"教",而非仅仅"列概念"。
112
+
113
+ **检查清单**(按重要性等级选择适用项,不适用的项不参与计分):
114
+
115
+ | 项 | 检查内容 | [核心] | [重要] | [了解] |
116
+ |----|---------|---------|--------|------|
117
+ | 1 | 有准确的专业定义——给出范畴、关键属性、边界条件,不以类比替代 | 适用 | 适用 | 适用 |
118
+ | 2 | 有 WHY——解释了为什么需要这个概念,不掌握的后果 | 适用 | 适用 | 不适用 |
119
+ | 3 | 有渐进式构建——从简单用法开始,逐步叠加复杂度 | 适用 | 不适用 | 不适用 |
120
+ | 4 | 如有类比,类比之后有"对应到技术上……"的精确回归 | 适用 | 适用 | 不适用 |
121
+ | 5 | 自查问题有针对性——不是泛泛的"理解了吗",而是可验证的具体问题 | 适用 | 适用 | 不适用 |
122
+ | 6 | 语言有教学温度——不是在读 API 文档,而是在和人对话 | 适用 | 不适用 | 不适用 |
123
+ | 7 | 引入顺序是问题先行——概念从场景/问题出发,非直接抛定义/公式 | 适用 | 适用 | 不适用 |
124
+ | 8 | 核心概念有常见错误演示——"如果做错了会怎样" | 适用 | 不适用 | 不适用 |
125
+
126
+ **适用项说明**(不适用的项不参与计分):
127
+
128
+ **[核心](8项,满分5分)**:
129
+ - 5分:满足7-8项,概念被真正讲透
130
+ - 4分:满足5-6项,整体优质
131
+ - 3分:满足3-4项,偏概念罗列
132
+ - 2分:满足1-2项,概念堆叠或只有类比无定义
133
+ - 1分:满足0项,纯名词堆砌
134
+
135
+ **[重要](5项,满分5分)**:
136
+ - 5分:满足全部5项
137
+ - 4分:满足4项
138
+ - 3分:满足2-3项
139
+ - 2分:仅满足1项
140
+ - 1分:0项(连定义都没有)
141
+
142
+ **[了解](仅项1,满分5分)**:
143
+ - 5分:一句准确定义,技术边界清晰
144
+ - 4分:定义基本准确,有轻微概括
145
+ - 3分:定义方向正确但有精度损失
146
+ - 2分:定义模糊,无法区分与相似概念的边界
147
+ - 1分:无定义或定义错误
148
+
149
+ ### 4. 示例相关性(权重 15%)
150
+ 检查示例代码是否有效支撑了概念理解。
151
+
152
+ 打分标准:
153
+ - 5分:示例直接演示核心概念,代码可运行,有逐行注释说明。优先使用了源材料的示例。
154
+ - 4分:示例正确但有轻微改进空间(如缺少一行关键注释)。
155
+ - 3分:有示例但与概念的关联不够紧密,或缺少运行说明。
156
+ - 2分:示例过于简单无法说明概念,或示例有运行错误。
157
+ - 1分:无示例,或示例明显与概念无关。
158
+
159
+ ## 输出格式
160
+
161
+ 只输出以下 JSON,不输出其他内容:
162
+
163
+ {
164
+ "kp_id": "kp-XXX",
165
+ "chapter": "章节文件名",
166
+ "scores": {
167
+ "accuracy": {"score": 4, "reason": "一句话说明打分原因"},
168
+ "completeness": {"score": 4, "reason": "一句话说明打分原因"},
169
+ "pedagogy": {"score": 4, "reason": "一句话说明打分原因 — 这是最重要的维度,请给出具体判断依据"},
170
+ "example_relevance": {"score": 4, "reason": "一句话说明打分原因"}
171
+ },
172
+ "weighted_total": 4.0,
173
+ "verdict": "pass",
174
+ "specific_issues": ["如果有具体问题,逐条列出。无问题则为空数组"],
175
+ "improvement_suggestions": ["如果 verdict 不是 pass,给出具体的修改建议。pass 则为空数组"],
176
+ "source_excerpt_available": true
177
+ }
178
+
179
+ 加权总分 = accuracy*0.30 + completeness*0.25 + pedagogy*0.30 + example_relevance*0.15
180
+
181
+ verdict 判定规则:
182
+ - weighted_total >= 4.0 → "pass"
183
+ - 3.0 <= weighted_total < 4.0 → "borderline"
184
+ - weighted_total < 3.0 → "fail"
185
+ - **pedagogy 单项分 < 2 → 强制 verdict = "fail"**([核心]/[重要] 等级适用;[了解] 等级仅当定义完全错误或缺失时触发)
186
+ ```
187
+
188
+ ---
189
+
190
+ ## 步骤3:汇总判定
191
+
192
+ 收集所有验证 agent 结果后,计算:
193
+
194
+ ```
195
+ 总体合格率 = pass数量 / 抽样总数 * 100%
196
+ 教学质量均分 = 所有抽样的 pedagogy 平均分
197
+ ```
198
+
199
+ | 判定结果 | 条件 | 处理方式 |
200
+ |---------|------|---------|
201
+ | [通过] 通过 | 合格率 ≥ 80% 且 教学质量均分 ≥ 3.5 | 进入步骤5,向用户展示草稿 |
202
+ | [条件] 条件通过 | 合格率 ≥ 60% 且 教学质量均分 ≥ 3.0 | 对 fail 和 borderline 的知识点所在章节重新生成,然后重新验证 |
203
+ | [失败] 不通过 | 合格率 < 60% 或 教学质量均分 < 3.0 | 系统性质量问题。向用户报告并建议返回阶段2补充搜索 |
204
+
205
+ ### 判定为不通过时的用户沟通模板
206
+
207
+ ```
208
+ > [警告] 内容质量验证未通过
209
+ >
210
+ > **抽样结果**:
211
+ > - 抽样数:M / 总知识点 N
212
+ > - 合格率:X%(阈值 60%)
213
+ > - 教学质量均分:X.X / 5.0(阈值 3.0)
214
+ >
215
+ > **主要问题**:
216
+ > [列出最常见的 specific_issues]
217
+ >
218
+ > **可能原因**:
219
+ > - 源材料不足或质量偏低,导致章节 agent 没有足够信息写出有深度的内容
220
+ > - 建议返回阶段2,针对以下子主题补充搜索:[列出薄弱的知识领域]
221
+ >
222
+ > 是否同意返回阶段2补充资料?
223
+ ```
224
+
225
+ ---
226
+
227
+ ## 步骤4:重新生成(如触发条件通过)
228
+
229
+ 对于需要重新生成的章节:
230
+
231
+ 1. 将验证 agent 的 `specific_issues` 和 `improvement_suggestions` 合并为"改进要求"段落
232
+ 2. 重新派发该章节的撰写 agent,使用同一份知识卡片 + 改进要求
233
+ 3. 新生成的章节替换原文件
234
+ 4. 对新版本**只验证**之前 fail/borderline 的知识点
235
+ 5. 如果重新生成后验证仍未通过,不再重试——标注为「[注意] 经过重新生成仍未达标,需人工审核决定」
236
+
237
+ ---
238
+
239
+ ## 步骤5:生成验证报告
240
+
241
+ 验证通过后,在工作区 `_internal/04-verify/` 目录下生成 `quality-report.md`(先创建目录):
242
+
243
+ ```markdown
244
+ # 内容质量验证报告
245
+
246
+ **生成时间**: YYYY-MM-DD HH:mm
247
+ **教程主题**: [主题]
248
+ **验证模式**: 阶段4.5 自动化抽样
249
+
250
+ ## 抽样概况
251
+
252
+ | 指标 | 数值 |
253
+ |------|------|
254
+ | 总知识点数 | N |
255
+ | 抽样数 | M |
256
+ | 合格率 | X% |
257
+ | 教学质量均分 | X.X / 5.0 |
258
+
259
+ ## 各维度均分
260
+
261
+ | 维度 | 均分 | 权重 |
262
+ |------|------|------|
263
+ | 事实准确性 | X.X / 5.0 | 30% |
264
+ | 完整性 | X.X / 5.0 | 25% |
265
+ | 教学价值 | X.X / 5.0 | 30% |
266
+ | 示例相关性 | X.X / 5.0 | 15% |
267
+
268
+ ## 发现的问题
269
+
270
+ [列出所有验证 agent 返回的 specific_issues,按章节分组]
271
+
272
+ ## 已执行的修复
273
+
274
+ [列出重新生成的章节、具体修改内容]
275
+
276
+ ## 未解决的风险
277
+
278
+ [列出 source_excerpt 缺失导致无法验证的知识点]
279
+ [列出重新生成后仍未达标的章节]
280
+ ```
281
+
282
+ ---
283
+
284
+ ## 步骤6:更新会话状态
285
+
286
+ 更新 `session-state.md`,将阶段4.5标记为已完成:
287
+
288
+ ```markdown
289
+ # 会话状态
290
+ 主题: [主题名]
291
+ 更新时间: [当前时间]
292
+ 学习模式: [快速参考 / 完整教程]
293
+ 工作区: [工作区绝对路径]
294
+
295
+ ---
296
+
297
+ ## 进度
298
+ 当前阶段: 5
299
+ 已完成阶段: 1, 2, 3, 4, 4.5
300
+
301
+ ## 阶段输出
302
+ - **阶段1**: 资料清单.md — [N]份资料
303
+ - **阶段2**: _internal/02-extract/ — [X]个知识点
304
+ - **阶段3**: outline.md, outline-stats.json
305
+ - **阶段4**: [所有已生成的章节文件] — 共[N]章全部完成
306
+ - **阶段4.5**: quality-report.md — 合格率 [X]%,教学质量均分 [X.X],结果:[通过/条件通过/不通过]
307
+ ```
308
+
309
+ 记录 `_internal/04-verify/quality-report.md` 的路径和关键结论。
310
+
311
+ ---
312
+
313
+ ## 与主流程的关系
314
+
315
+ 本文件由 `stage4-write.md` §4.5 引用。主流程在完成所有章节撰写后,读取本文件执行验证。
316
+
317
+ **验证文件命名规范**:验证报告文件名格式为 `verify-{batch:02d}-ch{start:02d}-ch{end:02d}.md`,其中 batch 为批次号(从 01 递增),start/end 为连续章节范围。单章验证时使用 `verify-{batch:02d}-ch{num:02d}.md`。
318
+
319
+ **前置条件**:所有章节文件已写入工作区,`_internal/02-extract/` 目录中有完整的阶段2知识报告。
320
+
321
+ **后置条件**:验证通过后进入阶段5(人工审核),不通过时返回阶段2或向用户报告。
322
+
323
+ ---
324
+
325
+ ## 版本历史
326
+
327
+ - **v1 (2026-06-09)**: 初始版本。参照 LLM 微调数据质量评估流程设计。四维度打分(准确性/完整性/教学价值/示例相关性),教学质量为最底线。
@@ -0,0 +1,196 @@
1
+ # 阶段5:人工审核 + 迭代优化
2
+
3
+ 草稿完成后,等待用户审核并根据反馈进行精准修改。
4
+
5
+ ---
6
+
7
+ ## 5.1 向用户提交草稿
8
+
9
+ 主动询问用户:
10
+
11
+ > "教程草稿已生成,保存在 [路径]。
12
+ >
13
+ > **目录概览**:
14
+ > [列出所有文件名和章节标题]
15
+ >
16
+ > 请查阅后告诉我:
17
+ > - 哪些章节需要补充或调整?
18
+ > - 示例是否足够清晰?
19
+ > - 知识等级划分是否合理?
20
+ > - 是否有遗漏的重要概念?"
21
+
22
+ ---
23
+
24
+ ## 5.2 等待用户反馈
25
+
26
+ 用户审核草稿后,会提供以下几种类型的反馈:
27
+
28
+ ### 反馈类型
29
+
30
+ | 类型 | 示例 | 处理方式 |
31
+ |------|------|---------|
32
+ | **章节内容问题** | "第3章太简略"、"第5章有错误" | 精准修改对应章节 |
33
+ | **示例问题** | "示例代码不清楚"、"缺少实战例子" | 补充或改进示例 |
34
+ | **等级划分问题** | "这个概念应该是初学,不是熟练" | 调整知识点等级 |
35
+ | **缺失概念** | "没有提到 X 功能" | 判断是否需要返回阶段3.5补充搜索 |
36
+ | **表达不清** | "看不懂这段"、"专业术语太多" | 进入阶段5.5交互式完善 |
37
+
38
+ ---
39
+
40
+ ## 5.3 根据反馈精准修改
41
+
42
+ **关键原则**:根据反馈**精准修改对应章节**,不重写整份教程。
43
+
44
+ ### 修改流程
45
+
46
+ 1. **定位问题位置**:章节编号 + 具体段落
47
+ 2. **判断修改范围**:
48
+ - 局部问题(某段话、某个示例)→ 修改该部分
49
+ - 结构性问题(整个章节逻辑混乱)→ 重写该章节
50
+ - 系统性问题(知识点缺失)→ 判断是否需要返回阶段3.5
51
+ 3. **执行修改**
52
+ 4. **向用户汇报**:"已修改 [章节X],请查阅"
53
+
54
+ ### 分流处理
55
+
56
+ **表达类问题** → 进入阶段5.5(交互式完善):
57
+ - "看不懂"、"太抽象"、"术语太多"
58
+ - 这些问题通常不需要新资料,只需优化表达
59
+
60
+ **内容缺失问题** → 返回阶段3.5(缺口识别):
61
+ - "没有提到 X"、"缺少 Y 功能"
62
+ - 需要补充搜索新资料
63
+
64
+ ---
65
+
66
+ ## 5.4 迭代修改
67
+
68
+ 修改完成后,再次询问用户:
69
+
70
+ > "已修改以下部分:
71
+ > - [修改1]
72
+ > - [修改2]
73
+ >
74
+ > 请查阅。还有其他需要调整的地方吗?"
75
+
76
+ ### 迭代继续条件
77
+
78
+ - 用户继续提供反馈 → 重复 5.3 步骤
79
+ - 用户说"可以了" / "没问题了" → 进入阶段5.5
80
+
81
+ ---
82
+
83
+ ## 5.5 进入交互式完善
84
+
85
+ **强制进入阶段5.5**,即使用户说"没问题了",也要主动询问:
86
+
87
+ > "请阅读教程并标记不清楚的地方,可以直接引用章节标题+具体段落,比如:
88
+ > - '3.4 临时暂存当前工作:git stash — 指令描述含糊,容易误解'
89
+ >
90
+ > 每次可以提多条反馈,我会逐一完善。"
91
+
92
+ 读取 `workflows/stage5.5-iterate.md` 执行交互式完善循环。
93
+
94
+ ---
95
+
96
+ ## 5.6 退出阶段5
97
+
98
+ 满足以下任一条件时退出阶段5:
99
+ - 阶段5.5 交互式完善完成(用户明确说"可以了")
100
+ - 用户在阶段5和阶段5.5都没有反馈(连续两轮无反馈)
101
+
102
+ 退出后进入阶段6。
103
+
104
+ ---
105
+
106
+ ## 5.7 保存会话状态
107
+
108
+ 退出阶段5前,更新工作区的 `session-state.md`:
109
+
110
+ ```markdown
111
+ # 会话状态
112
+ 主题: [主题名]
113
+ 更新时间: [当前时间]
114
+ 学习模式: [快速参考 / 完整教程]
115
+ 工作区: [工作区绝对路径]
116
+
117
+ ---
118
+
119
+ ## 进度
120
+ 当前阶段: 6
121
+ 已完成阶段: 1, 2, 3, 4, 4.5, 5, 5.5
122
+
123
+ ## 阶段输出
124
+ - **阶段1**: 资料清单.md
125
+ - **阶段2**: `_internal/02-extract/`
126
+ - **阶段3**: `_internal/03-merge/outline.md, outline-stats.json
127
+ - **阶段4**: [所有章节文件]
128
+ - **阶段4.5**: quality-report.md — 合格率 [X]%,教学质量均分 [X.X]
129
+ - **阶段5**: 用户审核完成,反馈 [N] 条已全部处理
130
+ - **阶段5.5**: 交互式完善完成,用户确认满意
131
+
132
+ ---
133
+
134
+ ## 恢复指令
135
+ 所有阶段已完成,教程位于工作区根目录。继续阶段6(最终确认),向用户展示成果目录概览。
136
+ ```
137
+
138
+ ---
139
+
140
+ ## 5.8 阶段出口门控
141
+
142
+ 退出阶段5(含5.5)前,逐项检查:
143
+
144
+ - [ ] 用户审核反馈已全部收集
145
+ - [ ] 内容缺失类反馈已返回阶段3.5处理(如需要)
146
+ - [ ] 表达类反馈已进入阶段5.5处理
147
+ - [ ] 阶段5.5交互式完善已完成,用户确认满意
148
+ - [ ] session-state.md 已更新(§5.6)
149
+
150
+ 以上全部通过后,进入阶段6。
151
+
152
+ ---
153
+
154
+ ## 常见问题
155
+
156
+ **Q1:用户反馈"这部分是错的",如何处理?**
157
+
158
+ A:
159
+ 1. 立即停止,向用户确认:"您认为正确的说法是什么?或者有权威资料可以参考吗?"
160
+ 2. 根据用户提供的正确信息或资料,修正错误内容
161
+ 3. 在"05-参考资源.md"中记录勘误
162
+
163
+ **Q2:用户反馈"内容太少",如何处理?**
164
+
165
+ A:
166
+ 1. 询问用户:"您期望该章节增加哪些内容?请具体说明。"
167
+ 2. 判断是已有资料中存在但未写入,还是资料中没有
168
+ 3. 如果是前者,直接补充;如果是后者,返回阶段3.5补充搜索
169
+
170
+ **Q3:用户反馈"写得太啰嗦",如何处理?**
171
+
172
+ A:
173
+ 1. 询问用户:"您希望保留哪些核心内容?哪些部分可以删减?"
174
+ 2. 根据用户指示精简内容
175
+ 3. **不要**主动大幅删减(学习教程"宁多勿少"是核心原则)
176
+
177
+ **Q4:用户反馈多个问题,处理顺序?**
178
+
179
+ A:按章节顺序依次处理(不打乱教程结构):
180
+ 1. 先处理第1章的反馈
181
+ 2. 再处理第2章的反馈
182
+ 3. ...
183
+
184
+ ---
185
+
186
+ ## 执行检查清单
187
+
188
+ 完成阶段5后,自检:
189
+ - [ ] 已向用户提交草稿并询问反馈
190
+ - [ ] 根据反馈精准修改了对应章节
191
+ - [ ] 表达类问题已进入阶段5.5处理
192
+ - [ ] 内容缺失问题已返回阶段3.5(如需要)
193
+ - [ ] 已进入阶段5.5交互式完善
194
+ - [ ] 阶段5.5完成后用户满意
195
+
196
+ 如果任一项为"否",补充完成后再进入阶段6。