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.
- package/client/client.js +452 -0
- package/cordis.patch.yml +111 -0
- package/index.js +19 -0
- package/package.json +42 -6
- package/skills/dsh-learn-mode/SKILL.md +190 -0
- 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
- package/README.md +0 -3
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
# 质量检查门(Quality Gates)
|
|
2
|
+
|
|
3
|
+
在流程执行过程中,遇到以下信号时必须停止并采取指定措施。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. 卡顿信号(Stall Signal)
|
|
8
|
+
|
|
9
|
+
### 触发条件
|
|
10
|
+
|
|
11
|
+
写作过程中出现以下任一情况:
|
|
12
|
+
- 某段话反复改写三次以上,仍不满意
|
|
13
|
+
- 该章节只有一份来源,无法交叉验证
|
|
14
|
+
- 需要用到阶段1没有收集的新资料
|
|
15
|
+
- 写出了一个自己无法用口语向别人解释的概念
|
|
16
|
+
|
|
17
|
+
### 处理措施
|
|
18
|
+
|
|
19
|
+
**不要强行写完**,而是:
|
|
20
|
+
1. 立即停止当前章节撰写
|
|
21
|
+
2. 识别卡顿原因(来源不足?概念理解不透?需要新资料?)
|
|
22
|
+
3. 返回阶段2,针对该子主题重新派发 Sub-agent
|
|
23
|
+
4. 等待新知识报告后再继续撰写
|
|
24
|
+
5. **回退上限**:同一子主题最多回退阶段2 **2 次**。第 2 次回退后仍然卡顿时,停止重试,向用户报告并请求决策(缩小该章范围 / 由用户补充资料 / 标注「暂缺」后继续),严禁无限回退
|
|
25
|
+
|
|
26
|
+
**错误做法**:
|
|
27
|
+
- [错误] "不太确定,先写一个模糊的版本,用户看不懂再说"
|
|
28
|
+
- [错误] "用 AI 生成一段看起来合理的内容填充"
|
|
29
|
+
|
|
30
|
+
**正确做法**:
|
|
31
|
+
- [正确] 向用户报告:"我在撰写'第3章 分支管理'时遇到卡顿 — 该章节只有一份来源且对 `git worktree` 的描述不完整。建议补充搜索官方文档后再继续,是否同意?"
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 2. 迭代退出条件(阶段5.5专用)
|
|
36
|
+
|
|
37
|
+
### 正常退出(满足任一即停止)
|
|
38
|
+
|
|
39
|
+
1. **用户明确确认**:用户说"可以了"、"没问题了"、"很好"
|
|
40
|
+
2. **连续无反馈**:连续两轮用户回复"没有了"或反馈为空
|
|
41
|
+
3. **单章节补充超限**:单个章节补充超过3轮
|
|
42
|
+
|
|
43
|
+
### 超限时的处理
|
|
44
|
+
|
|
45
|
+
当单章节补充达到3轮时:
|
|
46
|
+
1. 停止继续补充该章节
|
|
47
|
+
2. 向用户报告:"第X章已补充3轮,但您仍有疑问。这可能说明该章节内容过于复杂,建议拆分成多个子章节。是否现在重构?"
|
|
48
|
+
3. 等待用户决策:
|
|
49
|
+
- 用户同意重构 → 返回阶段3,拆分该章节
|
|
50
|
+
- 用户拒绝 → 继续下一个有反馈的章节
|
|
51
|
+
|
|
52
|
+
### 强制退出(异常情况)
|
|
53
|
+
|
|
54
|
+
- 总迭代轮次超过10轮 → 提示:"已进行10轮迭代,可能方向有问题。建议暂停,重新评估需求。"
|
|
55
|
+
- 用户连续3次反馈同一问题未解决 → 提示:"该问题3次尝试未解决,可能需要改变策略或寻求外部资源。"
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## 3. 上下文膨胀预警
|
|
60
|
+
|
|
61
|
+
### 监控指标
|
|
62
|
+
|
|
63
|
+
在以下阶段需要主动监控主进程上下文:
|
|
64
|
+
- **阶段2结束时**:知识报告总数 × 平均报告长度
|
|
65
|
+
- **阶段3结束时**:大纲知识点总数
|
|
66
|
+
- **阶段4撰写时(仅主进程直写模式)**:已加载章节数
|
|
67
|
+
|
|
68
|
+
### 预警阈值
|
|
69
|
+
|
|
70
|
+
| 阶段 | 指标 | 黄色预警 | 红色预警 | 措施 |
|
|
71
|
+
|------|------|---------|---------|------|
|
|
72
|
+
| 阶段2 | 知识报告数 | >30份(含补搜) | >50份(含补搜) | 建议用户缩小主题范围或分成多个独立教程 |
|
|
73
|
+
| 阶段3 | 知识点总数 | >50个 | >150个 | 见下方处理方式 |
|
|
74
|
+
| 阶段4(主进程直写模式) | 同时加载章节数 | >3章 | >5章 | 停止直写,改为 Sub-agent 章节并行模式 |
|
|
75
|
+
|
|
76
|
+
**注意**:阶段2 的"知识报告数"指 Sub-agent 返回的压缩 JSON 报告(约400字/份),而非原始资料全文。阈值与各环节推荐量自洽:阶段1 推荐 8-20 份、阶段3.5 补搜上限 30 份,理论极值 50 份正好触红——此时"缩小主题或拆分"就是正确动作,不构成流程自踩预警。阶段4的章节数预警仅适用于"小型教程主进程直写"场景。中型教程(>50个知识点)应在进入阶段4时直接使用 Sub-agent 章节并行模式(参见 `workflows/stage4-write.md` §4.0),此时主进程不加载任何章节内容,预警不触发。
|
|
77
|
+
|
|
78
|
+
### 超限处理
|
|
79
|
+
|
|
80
|
+
**阶段3 黄色预警(>50个知识点)**:
|
|
81
|
+
- 向用户说明:"当前规模为中型教程(X个知识点),阶段4将使用章节并行模式撰写,每章独立进行以保证内容深度。"
|
|
82
|
+
- 读取 `workflows/stage4-chapter-agent.md`,进入并行章节模式。
|
|
83
|
+
|
|
84
|
+
**阶段3 红色预警(>150个知识点)**:
|
|
85
|
+
- 向用户说明:"当前规模超大(X个知识点),建议拆分成多个独立教程,例如:'React 基础教程'+'React Hooks 进阶'+'React 性能优化'。是否同意拆分?"
|
|
86
|
+
|
|
87
|
+
**阶段4 直写模式超限(同时加载章节数 >3章)**:
|
|
88
|
+
- 立即停止主进程直写,切换到 Sub-agent 章节并行模式(参见 `workflows/stage4-chapter-agent.md`)。
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 4. 来源质量检查(阶段1专用)
|
|
93
|
+
|
|
94
|
+
### 触发时机
|
|
95
|
+
|
|
96
|
+
阶段1收集资料完成后,统计来源类型分布。
|
|
97
|
+
|
|
98
|
+
### 质量门槛
|
|
99
|
+
|
|
100
|
+
| 来源类型 | 最低要求 | 推荐占比 |
|
|
101
|
+
|---------|---------|---------|
|
|
102
|
+
| 一手资料(官方文档、RFC、源码) | ≥1份 | ≥40% |
|
|
103
|
+
| 二手资料(知名博客、验证教程) | ≥2份 | ≥50% |
|
|
104
|
+
| 三手资料(转载、未注明来源) | <50% | <10% |
|
|
105
|
+
|
|
106
|
+
### 不达标处理
|
|
107
|
+
|
|
108
|
+
如果收集的资料中:
|
|
109
|
+
- **没有一手资料** → 必须补充搜索官方文档,不能直接进入阶段2
|
|
110
|
+
- **三手资料占比 >50%** → 警告用户:"当前资料质量偏低,建议补充权威来源。"
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 5. Mission 门控(阶段0.5 → 阶段1 专用)
|
|
115
|
+
|
|
116
|
+
### 触发时机
|
|
117
|
+
|
|
118
|
+
阶段0.5 完成后,进入阶段1 收集资料之前。
|
|
119
|
+
|
|
120
|
+
### 门控条件
|
|
121
|
+
|
|
122
|
+
- Mission 必须已固化为 `MISSION.md`,**或**用户已明确选择跳过(Mission 为 [UNDEFINED])
|
|
123
|
+
- 若 Mission 已固化:Why / Success / Out of Scope 三项均不得为空
|
|
124
|
+
- 若 Mission 为 [UNDEFINED]:走通用完整模式,教程导言需提示"后续可补写 Mission 来定制内容"
|
|
125
|
+
|
|
126
|
+
### 不达标处理
|
|
127
|
+
|
|
128
|
+
- Mission 三项中任一为空 → 返回阶段0.5 补充追问
|
|
129
|
+
- 用户跳过但未明确说"跳过" → 重新询问确认
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 6. 示例代码可运行性检查(阶段4专用)
|
|
134
|
+
|
|
135
|
+
### 检查时机
|
|
136
|
+
|
|
137
|
+
每次决定"示例代码放内联还是独立文件"时。
|
|
138
|
+
|
|
139
|
+
### 决策规则
|
|
140
|
+
|
|
141
|
+
参见 `references/example-structures.md`,但核心原则:
|
|
142
|
+
- **宁可多建一个文件夹,也不要让用户拿到一段无法直接运行的代码**
|
|
143
|
+
|
|
144
|
+
### 强制要求
|
|
145
|
+
|
|
146
|
+
如果示例代码满足以下任一条件,**必须**建独立文件夹:
|
|
147
|
+
- 需要多个文件配合(如 HTML+CSS+JS)
|
|
148
|
+
- 需要依赖声明文件(如 `package.json`)
|
|
149
|
+
- 需要构建配置文件(如 `vite.config.js`)
|
|
150
|
+
- 单文件但超过 50 行
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## 7. 内容质量验证门控(阶段4.5专用)
|
|
155
|
+
|
|
156
|
+
### 触发时机
|
|
157
|
+
|
|
158
|
+
阶段4所有章节撰写完成后,进入阶段4.5时。
|
|
159
|
+
|
|
160
|
+
### 验证维度与权重
|
|
161
|
+
|
|
162
|
+
| 维度 | 权重 | 含义 | 关键检查点 |
|
|
163
|
+
|------|------|------|-----------|
|
|
164
|
+
| 事实准确性 | 30% | 生成内容与源材料是否一致,定义是否精确 | 有无编造、歪曲、过度概括;术语是否规范;概念边界是否清晰 |
|
|
165
|
+
| 完整性 | 25% | 是否覆盖了源材料中的关键信息 | WHAT+WHY+HOW+使用场景是否齐全;导言四要素是否有原文支撑 |
|
|
166
|
+
| 教学价值 | 30% | 是否在"教"而非"列概念" | 定义是否准确先行;WHY解释是否充分;如有类比是否回归精确表述;渐进构建;自查问题 |
|
|
167
|
+
| 示例相关性 | 15% | 示例是否有效支撑概念 | 是否可运行、是否有说明、是否来源于源材料 |
|
|
168
|
+
|
|
169
|
+
### 判定阈值
|
|
170
|
+
|
|
171
|
+
| 结果 | 合格率阈值 | 教学质量均分 | 处理 |
|
|
172
|
+
|------|-----------|-------------|------|
|
|
173
|
+
| [通过] 通过 | ≥ 80% | ≥ 3.5 | 进入阶段5 |
|
|
174
|
+
| [条件] 条件通过 | ≥ 60% | ≥ 3.0 | 重新生成 fail/borderline 章节 |
|
|
175
|
+
| [失败] 不通过 | < 60% | < 3.0 | 向用户报告,建议返回阶段2 |
|
|
176
|
+
|
|
177
|
+
### 不可降低的底线
|
|
178
|
+
|
|
179
|
+
- **pedagogy(教学价值)单项分 < 2**:无论加权总分多少,verdict 强制为 "fail"。概念堆叠或只有类比无定义,均属于教学质量的根本性失败。
|
|
180
|
+
- **source_excerpt 缺失率 > 30%**:如果超过30%的抽样知识点缺少源材料摘录,事实准确性评估不可靠,验证 agent 必须注记此项风险。
|
|
181
|
+
|
|
182
|
+
### 重新生成上限
|
|
183
|
+
|
|
184
|
+
- 同一章节最多重新生成 **2次**
|
|
185
|
+
- 第2次重新生成后仍未通过验证 → 不再重试,标注为「[注意] 经过2次重新生成仍未达标,需人工审核决定」
|
|
186
|
+
- 如果超过 **1/3** 的章节需要重新生成 → 可能是系统性问题(知识卡片贫瘠或源材料不足),暂停验证并向用户报告
|
|
187
|
+
|
|
188
|
+
### 验证结果记录
|
|
189
|
+
|
|
190
|
+
验证完成后必须在工作区 `_internal/04-verify/` 目录下生成 `quality-report.md`,包含:
|
|
191
|
+
- 抽样概况(抽样数/合格率)
|
|
192
|
+
- 各维度均分
|
|
193
|
+
- 发现的具体问题
|
|
194
|
+
- 已执行的修复
|
|
195
|
+
- 未解决的风险
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## 检查清单
|
|
200
|
+
|
|
201
|
+
每完成一个阶段,自检:
|
|
202
|
+
- [ ] 是否触发了卡顿信号?
|
|
203
|
+
- [ ] 是否满足退出条件?
|
|
204
|
+
- [ ] 上下文是否接近预警阈值?
|
|
205
|
+
- [ ] 来源质量是否达标?
|
|
206
|
+
- [ ] 示例代码是否可运行?
|
|
207
|
+
- [ ] **阶段4.5 内容质量验证是否通过?**(阶段4完成后必检)
|
|
208
|
+
|
|
209
|
+
如果任一项答案是"否"或"不确定",查阅本文件对应章节。
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
"""
|
|
2
|
+
PDF 转 Markdown 工具
|
|
3
|
+
用法:python pdf_to_md.py <pdf路径> [输出路径]
|
|
4
|
+
若不指定输出路径,则在同目录下生成同名 .md 文件
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import sys
|
|
8
|
+
import os
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def convert_with_pymupdf(pdf_path: str) -> str:
|
|
12
|
+
"""使用 PyMuPDF (fitz) 转换,保留文本结构"""
|
|
13
|
+
import fitz # pip install pymupdf
|
|
14
|
+
|
|
15
|
+
doc = fitz.open(pdf_path)
|
|
16
|
+
lines = []
|
|
17
|
+
|
|
18
|
+
for page_num, page in enumerate(doc, start=1):
|
|
19
|
+
lines.append(f"\n\n---\n<!-- 第 {page_num} 页 -->\n")
|
|
20
|
+
blocks = page.get_text("dict")["blocks"]
|
|
21
|
+
|
|
22
|
+
for block in blocks:
|
|
23
|
+
if block.get("type") != 0: # 只处理文本块
|
|
24
|
+
continue
|
|
25
|
+
for line in block.get("lines", []):
|
|
26
|
+
spans = line.get("spans", [])
|
|
27
|
+
if not spans:
|
|
28
|
+
continue
|
|
29
|
+
|
|
30
|
+
# 根据字号判断标题等级
|
|
31
|
+
text = "".join(s["text"] for s in spans).strip()
|
|
32
|
+
if not text:
|
|
33
|
+
continue
|
|
34
|
+
|
|
35
|
+
size = spans[0].get("size", 12)
|
|
36
|
+
flags = spans[0].get("flags", 0)
|
|
37
|
+
is_bold = flags & 2 ** 4 # 粗体标志位
|
|
38
|
+
|
|
39
|
+
if size >= 20:
|
|
40
|
+
lines.append(f"\n# {text}\n")
|
|
41
|
+
elif size >= 16:
|
|
42
|
+
lines.append(f"\n## {text}\n")
|
|
43
|
+
elif size >= 14 or is_bold:
|
|
44
|
+
lines.append(f"\n### {text}\n")
|
|
45
|
+
else:
|
|
46
|
+
lines.append(text)
|
|
47
|
+
|
|
48
|
+
doc.close()
|
|
49
|
+
return "\n".join(lines)
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def convert_with_pdfminer(pdf_path: str) -> str:
|
|
53
|
+
"""使用 pdfminer.six 转换,纯文本提取"""
|
|
54
|
+
from pdfminer.high_level import extract_text
|
|
55
|
+
|
|
56
|
+
return extract_text(pdf_path)
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def convert_with_pypdf(pdf_path: str) -> str:
|
|
60
|
+
"""使用 pypdf 转换,作为最后备选"""
|
|
61
|
+
from pypdf import PdfReader
|
|
62
|
+
|
|
63
|
+
reader = PdfReader(pdf_path)
|
|
64
|
+
pages = []
|
|
65
|
+
for i, page in enumerate(reader.pages, start=1):
|
|
66
|
+
text = page.extract_text() or ""
|
|
67
|
+
pages.append(f"\n\n---\n<!-- 第 {i} 页 -->\n\n{text}")
|
|
68
|
+
return "\n".join(pages)
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def convert(pdf_path: str) -> str:
|
|
72
|
+
"""尝试多种方式转换,按优先级依次尝试"""
|
|
73
|
+
methods = [
|
|
74
|
+
("PyMuPDF", convert_with_pymupdf),
|
|
75
|
+
("pdfminer.six", convert_with_pdfminer),
|
|
76
|
+
("pypdf", convert_with_pypdf),
|
|
77
|
+
]
|
|
78
|
+
|
|
79
|
+
for name, fn in methods:
|
|
80
|
+
try:
|
|
81
|
+
result = fn(pdf_path)
|
|
82
|
+
print(f"[pdf_to_md] 使用 {name} 转换成功", file=sys.stderr)
|
|
83
|
+
return result
|
|
84
|
+
except ImportError:
|
|
85
|
+
print(f"[pdf_to_md] {name} 未安装,尝试下一个...", file=sys.stderr)
|
|
86
|
+
except Exception as e:
|
|
87
|
+
print(f"[pdf_to_md] {name} 转换失败:{e},尝试下一个...", file=sys.stderr)
|
|
88
|
+
|
|
89
|
+
raise RuntimeError(
|
|
90
|
+
"所有 PDF 转换方式均失败。\n"
|
|
91
|
+
"请安装至少一个依赖:\n"
|
|
92
|
+
" pip install pymupdf ← 推荐,效果最好\n"
|
|
93
|
+
" pip install pdfminer.six ← 备选\n"
|
|
94
|
+
" pip install pypdf ← 最简备选"
|
|
95
|
+
)
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
def main():
|
|
99
|
+
if len(sys.argv) < 2:
|
|
100
|
+
print("用法:python pdf_to_md.py <pdf路径> [输出路径]")
|
|
101
|
+
sys.exit(1)
|
|
102
|
+
|
|
103
|
+
pdf_path = sys.argv[1]
|
|
104
|
+
if not os.path.exists(pdf_path):
|
|
105
|
+
print(f"错误:文件不存在 - {pdf_path}")
|
|
106
|
+
sys.exit(1)
|
|
107
|
+
|
|
108
|
+
if len(sys.argv) >= 3:
|
|
109
|
+
output_path = sys.argv[2]
|
|
110
|
+
else:
|
|
111
|
+
base = os.path.splitext(pdf_path)[0]
|
|
112
|
+
output_path = base + ".md"
|
|
113
|
+
|
|
114
|
+
markdown = convert(pdf_path)
|
|
115
|
+
|
|
116
|
+
with open(output_path, "w", encoding="utf-8") as f:
|
|
117
|
+
f.write(f"<!-- 由 pdf_to_md.py 从 {os.path.basename(pdf_path)} 转换 -->\n\n")
|
|
118
|
+
f.write(markdown)
|
|
119
|
+
|
|
120
|
+
print(f"[pdf_to_md] 输出:{output_path}")
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
if __name__ == "__main__":
|
|
124
|
+
main()
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Mission: {主题}
|
|
2
|
+
|
|
3
|
+
> 本文件由阶段0.5 生成。所有后续阶段的教学决策回归到此文件。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Why(为什么学)
|
|
8
|
+
|
|
9
|
+
{1-3 句话,描述具体的使用场景。不接受"学习"、"了解"等抽象回答}
|
|
10
|
+
|
|
11
|
+
## Success Looks Like(成功的标准)
|
|
12
|
+
|
|
13
|
+
- {可观测的具体成果,如"在服务器上跑起 docker-compose up"}
|
|
14
|
+
- {尽量量化:跑通项目?看懂团队代码?发一个 PR?}
|
|
15
|
+
|
|
16
|
+
## Constraints(约束条件)
|
|
17
|
+
|
|
18
|
+
- 平台: {Windows / macOS / Linux}
|
|
19
|
+
- 时间: {如"两周内上手"}
|
|
20
|
+
- 语言偏好: {中文 / 英文资料}
|
|
21
|
+
|
|
22
|
+
## Out of Scope(明确不学)
|
|
23
|
+
|
|
24
|
+
- {相邻但无关的领域,如"K8s 编排"在 Docker 部署场景下跳过}
|
|
25
|
+
- {这些内容不会从教程中删除,只降级为 [了解] 并附外链}
|
|
26
|
+
|
|
27
|
+
## 主轴(Organizing Axis)
|
|
28
|
+
|
|
29
|
+
- 主轴: {概念依赖 / 任务路径 / 时间×因果链 / 横截面格局 / 混合 / 跳过}
|
|
30
|
+
- 判定依据: {一句理由}
|
|
31
|
+
- 复核状态: {阶段0.5 初判 / 阶段3.0 已复核}
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 版本
|
|
36
|
+
|
|
37
|
+
- 创建日期: {YYYY-MM-DD}
|
|
38
|
+
- 最后更新: {YYYY-MM-DD}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# 深潜文档模板
|
|
2
|
+
|
|
3
|
+
> 用于阶段6.6.7 深潜动作。九节结构固定;第 2、3 节的具体形态由 MISSION.md 的主轴决定(见 `references/axis-types.md`)。
|
|
4
|
+
> 文件存放:`00-地图/deep-dives/{主题}.md`(有地图层时)或 `deep-dives/{主题}.md`(无地图层时)。
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# {主题} 深潜
|
|
9
|
+
|
|
10
|
+
> 深度档:【深潜】 | 主轴:{主轴名} | 前置知识:{必需/选读标注}
|
|
11
|
+
> 创建:YYYY-MM-DD | 更新:YYYY-MM-DD | 状态:{演化中 / 稳定}
|
|
12
|
+
|
|
13
|
+
## 1. 一句话定位
|
|
14
|
+
|
|
15
|
+
{一句话说清它是什么、在地图的哪个位置}
|
|
16
|
+
|
|
17
|
+
## 2. 纵轴叙事
|
|
18
|
+
|
|
19
|
+
{形态随主轴:
|
|
20
|
+
- 时间×因果链 → 来龙去脉:它出现前大家卡在哪(瓶颈)→ 它如何突破 → 它带来什么新瓶颈
|
|
21
|
+
- 概念依赖 → 逻辑推导链:从哪些前置概念推出它,它又支撑哪些下游
|
|
22
|
+
- 任务路径 → 工作流进阶链:它在"安装→核心工作流→高级场景"的哪一环,前后是什么
|
|
23
|
+
- 横截面格局 → 简史:只保留塑造当下格局的关键节点}
|
|
24
|
+
|
|
25
|
+
## 3. 评估卡
|
|
26
|
+
|
|
27
|
+
{维度随主轴配套,见 `references/axis-types.md` 的"评估维度配套"列。表格呈现,每项给一句判断+依据}
|
|
28
|
+
|
|
29
|
+
| 维度 | 判断 | 依据 |
|
|
30
|
+
|------|------|------|
|
|
31
|
+
| ... | ... | ... |
|
|
32
|
+
|
|
33
|
+
## 4. 横轴对比
|
|
34
|
+
|
|
35
|
+
{同类/同期方案对比表 + 一句"为什么是它活下来/被选中"}
|
|
36
|
+
|
|
37
|
+
## 5. 交汇判断
|
|
38
|
+
|
|
39
|
+
{纵轴+横轴交叉后的综合判断。敢下判断,但推测性内容明确标注"我的判断是"/"推测"}
|
|
40
|
+
|
|
41
|
+
## 6. 概念讲解
|
|
42
|
+
|
|
43
|
+
{讲解员模式主体,按此顺序:
|
|
44
|
+
1. 直觉类比(生活场景优先,说明"哪里像、哪里不像")
|
|
45
|
+
2. 反例 / 边界情况
|
|
46
|
+
3. 精确定义 + 英文术语
|
|
47
|
+
4. 公式与细节——标注「可二刷再看」,第一遍跳过不破坏理解链条}
|
|
48
|
+
|
|
49
|
+
## 7. 地图挂接
|
|
50
|
+
|
|
51
|
+
- 前驱节点:{链接}
|
|
52
|
+
- 后继节点:{链接}
|
|
53
|
+
- 相关节点:{链接}
|
|
54
|
+
|
|
55
|
+
## 8. 自测题
|
|
56
|
+
|
|
57
|
+
{题目集中于此,答案统一放在本节末尾,不得跟在题目后面}
|
|
58
|
+
|
|
59
|
+
### 题目
|
|
60
|
+
|
|
61
|
+
...
|
|
62
|
+
|
|
63
|
+
### 答案
|
|
64
|
+
|
|
65
|
+
...
|
|
66
|
+
|
|
67
|
+
## 9. 来源
|
|
68
|
+
|
|
69
|
+
<!-- 来源: {资料/链接清单} -->
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
完成后必须执行阶段6.9 地图影响检查(`workflows/stage6-progressive.md`)。
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# 演变全景图模板(时间×因果链主轴专用)
|
|
2
|
+
|
|
3
|
+
> 地图层文件:工作区根目录 `00-地图.md`。
|
|
4
|
+
> 与大纲分工:大纲回答"按什么顺序学",本图回答"为什么出现、谁取代了谁、值不值得深学"。
|
|
5
|
+
> 节点三要素:深度档(【深潜】/【通读】/【知晓】)、生态状态(上升/主流/衰退/淘汰)、范式层级(范式转换 / 工程优化)。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# {领域} 演变全景
|
|
10
|
+
|
|
11
|
+
> 本页定位:因果链地图(瓶颈 → 突破 → 新瓶颈)。大事记年表(如有)只答"什么时间发生什么",与本页是同一事实的两种索引。
|
|
12
|
+
> 更新:YYYY-MM-DD | 节点数:N
|
|
13
|
+
|
|
14
|
+
## 时代段划分
|
|
15
|
+
|
|
16
|
+
{按"瓶颈转换"划分为若干时代段,每段一句核心矛盾}
|
|
17
|
+
|
|
18
|
+
## 节点链
|
|
19
|
+
|
|
20
|
+
| 年份 | 节点 | 一句话定位 | 深度档 | 生态状态 | 范式层级 | 深潜文档 |
|
|
21
|
+
|------|------|-----------|--------|---------|---------|---------|
|
|
22
|
+
| ... | ... | {只答"是什么"} | 【通读】 | 主流 | 工程优化 | {链接或 —} |
|
|
23
|
+
|
|
24
|
+
## 待深潜队列
|
|
25
|
+
|
|
26
|
+
{按优先级排序的【深潜】候选节点}
|
|
27
|
+
|
|
28
|
+
## 深潜完成登记
|
|
29
|
+
|
|
30
|
+
| 节点 | 深潜文档 | 完成日期 | 地图影响 |
|
|
31
|
+
|------|---------|---------|---------|
|
|
32
|
+
| ... | ... | ... | {本次深潜改动了哪些节点状态} |
|
|
33
|
+
|
|
34
|
+
## 维护规则
|
|
35
|
+
|
|
36
|
+
- 每次深潜收尾执行地图影响检查(`workflows/stage6-progressive.md` §6.9)
|
|
37
|
+
- 生态状态变化必须留痕:commit 信息写清"改了什么、为什么"
|
|
38
|
+
- 深度档是动态属性,随学习进程可上调下调
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Understanding Map: {主题}
|
|
2
|
+
|
|
3
|
+
> 本文件由阶段6 交付时初始化,记录用户的学习进度和知识掌握状态。
|
|
4
|
+
> 每次渐进深化操作后更新。
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 元信息
|
|
9
|
+
|
|
10
|
+
- 教程版本: V1
|
|
11
|
+
- 交付日期: {YYYY-MM-DD}
|
|
12
|
+
- 最后更新: {YYYY-MM-DD}
|
|
13
|
+
- Mission: {引用 MISSION.md 路径,或标注 [UNDEFINED]}
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 掌握状态
|
|
18
|
+
|
|
19
|
+
按章节记录学习进度:
|
|
20
|
+
|
|
21
|
+
| 章节 | 状态 | 最后学习日期 |
|
|
22
|
+
|------|------|------------|
|
|
23
|
+
| 00-学习路线图 | [未开始] / [进行中] / [已掌握] | - |
|
|
24
|
+
| 01-{标题} | [未开始] / [进行中] / [已掌握] | - |
|
|
25
|
+
| 02-{标题} | [未开始] / [进行中] / [已掌握] | - |
|
|
26
|
+
| ... | ... | ... |
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 薄弱点(需回访)
|
|
31
|
+
|
|
32
|
+
用户学完某章后标记为"需要加强"的内容:
|
|
33
|
+
|
|
34
|
+
- (初始为空,用户学习过程中填充)
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 渐进深化历史
|
|
39
|
+
|
|
40
|
+
| 日期 | 操作 | 结果 |
|
|
41
|
+
|------|------|------|
|
|
42
|
+
| {YYYY-MM-DD} | 首次交付 V1 | - |
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
# 阶段0.5:Mission 采集
|
|
2
|
+
|
|
3
|
+
在模式选择之后、资料收集之前执行。目的是挖掘用户真实动机,让后续所有阶段的教学决策围绕 Mission 展开。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 0.5.1 入口判断
|
|
8
|
+
|
|
9
|
+
用户确认学习模式后,展示以下引导并等待回应:
|
|
10
|
+
|
|
11
|
+
> "在开始收集资料之前,我想先确认——学完 [主题] 之后,你第一个想用它做的具体事情是什么?"
|
|
12
|
+
>
|
|
13
|
+
> 如果暂时不确定,可以跳过这一步(回复"跳过"),后续生成通用完整教程。你也可以后续补写 Mission 来定制内容。
|
|
14
|
+
|
|
15
|
+
**用户回复处理**:
|
|
16
|
+
|
|
17
|
+
| 回复类型 | 处理方式 |
|
|
18
|
+
|---------|---------|
|
|
19
|
+
| 描述了具体场景 | 进入 §0.5.2 追问 |
|
|
20
|
+
| "跳过" / "不确定" / "先看看" | 标记 Mission 为 [UNDEFINED],直接进入阶段1(通用完整模式) |
|
|
21
|
+
| 抽象回答("想学习一下""了解一下") | 追问一轮具体场景,仍抽象则标记 [UNDEFINED] |
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 0.5.2 三轮追问
|
|
26
|
+
|
|
27
|
+
当用户给出具体场景后,依次推进以下三个问题:
|
|
28
|
+
|
|
29
|
+
### 第一轮:具体化
|
|
30
|
+
|
|
31
|
+
> "明白了。那么具体来说——做到什么程度你觉得算'学会了'?比如:能跑通一个项目?看懂团队代码?独立部署一个服务?"
|
|
32
|
+
|
|
33
|
+
不接受"理解""掌握"等抽象回答,引导到可观测的成果。
|
|
34
|
+
|
|
35
|
+
### 第二轮:边界划定
|
|
36
|
+
|
|
37
|
+
> "在这个目标下,有哪些是暂时不需要的?比如,如果学 Docker 是为了部署应用,那容器网络拓扑、K8s 编排这些是不是可以先跳过?"
|
|
38
|
+
|
|
39
|
+
举例引导用户想清楚边界。用户说的每一项 Out of Scope 都应记录,后续阶段自动降级。
|
|
40
|
+
|
|
41
|
+
### 第三轮:约束确认
|
|
42
|
+
|
|
43
|
+
> "最后确认一下:你的开发环境是?有没有时间限制?"
|
|
44
|
+
|
|
45
|
+
收集平台、时间、语言偏好等约束。
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## 0.5.3 生成 MISSION.md
|
|
50
|
+
|
|
51
|
+
基于追问结果,使用 `templates/MISSION.md` 模板生成 Mission 文档,写入工作区。
|
|
52
|
+
|
|
53
|
+
**填充规则**:
|
|
54
|
+
- Why:用户第一轮回答的具体场景,1-3 句话
|
|
55
|
+
- Success Looks Like:第二轮引导出的可观测成果
|
|
56
|
+
- Constraints:第三轮收集的环境/时间/语言约束
|
|
57
|
+
- Out of Scope:边界划定时用户确认不需要的内容
|
|
58
|
+
|
|
59
|
+
**完成后向用户展示**:
|
|
60
|
+
|
|
61
|
+
> "Mission 已明确:
|
|
62
|
+
>
|
|
63
|
+
> **Why**:{具体场景}
|
|
64
|
+
> **成功标准**:{可观测成果}
|
|
65
|
+
> **不学**:{Out of Scope 列表}
|
|
66
|
+
>
|
|
67
|
+
> 后续教程将围绕这个目标展开——只讲与目标相关的内容,与目标无关的知识降级为简述或跳过。
|
|
68
|
+
>
|
|
69
|
+
> 确认后进入资料收集阶段。如需调整,请说明。"
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## 0.5.4 主轴判定(Organizing Axis)
|
|
74
|
+
|
|
75
|
+
**目的**:确定该领域知识的组织轴——它决定地图形态、深潜方式和深度档判定标准。分类法与配套规则见 `references/axis-types.md`。
|
|
76
|
+
|
|
77
|
+
**执行方式**:
|
|
78
|
+
1. AI 根据 Mission(或主题描述)初判主轴,从四类中选择:概念依赖 / 任务路径 / 时间×因果链 / 横截面格局,或标记"混合/其他"
|
|
79
|
+
2. 向用户展示初判结果和一句理由,**必须等用户确认**:
|
|
80
|
+
|
|
81
|
+
> "这个领域我判断主轴是 [主轴名]——[一句理由]。主轴决定教程之外的地图长什么样、以后深潜按什么方式做。确认或纠正?"
|
|
82
|
+
|
|
83
|
+
3. 用户确认后写入 MISSION.md 的"主轴"字段;混合/其他时需写明自定义的组织逻辑
|
|
84
|
+
4. 判错是可纠正的:阶段3.0 会用收集到的资料复核主轴,翻案属正常流程
|
|
85
|
+
|
|
86
|
+
**快速参考模式**:跳过主轴判定(不产出地图层),MISSION.md 主轴字段标记 [跳过]。
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 0.5.5 保存会话状态
|
|
91
|
+
|
|
92
|
+
完成 Mission 后,在工作区创建或更新 `session-state.md`:
|
|
93
|
+
|
|
94
|
+
```markdown
|
|
95
|
+
# 会话状态
|
|
96
|
+
主题: [主题名]
|
|
97
|
+
更新时间: [当前时间]
|
|
98
|
+
学习模式: [快速参考 / 完整教程]
|
|
99
|
+
工作区: [工作区绝对路径]
|
|
100
|
+
Mission: [已固化 / 未定义]
|
|
101
|
+
主轴: [概念依赖 / 任务路径 / 时间×因果链 / 横截面格局 / 混合 / 跳过]
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 进度
|
|
106
|
+
当前阶段: 1
|
|
107
|
+
已完成阶段: 0, 0.5
|
|
108
|
+
|
|
109
|
+
## 阶段输出
|
|
110
|
+
- **阶段0**: 学习模式: [快速参考 / 完整教程]
|
|
111
|
+
- **阶段0.5**: MISSION.md — Mission 状态: [已固化 / 未定义]
|
|
112
|
+
- Why: [具体场景]
|
|
113
|
+
- Success: [可观测成果]
|
|
114
|
+
- Out of Scope: [N] 项
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## 0.5.6 阶段出口门控
|
|
120
|
+
|
|
121
|
+
进入阶段1 前,逐项检查:
|
|
122
|
+
|
|
123
|
+
- [ ] 用户已确认学习模式(阶段0)
|
|
124
|
+
- [ ] Mission 已固化为 MISSION.md(或用户已明确选择跳过)
|
|
125
|
+
- [ ] 若 Mission 已固化:Why / Success / Out of Scope 三项均已填充
|
|
126
|
+
- [ ] 主轴已判定并写入 MISSION.md(快速参考模式标记 [跳过])
|
|
127
|
+
- [ ] session-state.md 已创建或更新
|
|
128
|
+
|
|
129
|
+
以上全部通过后,读取 `workflows/stage1-collect.md` 执行阶段1。
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 执行检查清单
|
|
134
|
+
|
|
135
|
+
每完成一步,自检:
|
|
136
|
+
- [ ] 已向用户询问 Mission(不跳过提问环节)
|
|
137
|
+
- [ ] 若用户描述具体场景,已完成三轮追问
|
|
138
|
+
- [ ] 若用户选择跳过,已记录为 [UNDEFINED] 并说明后续可补写
|
|
139
|
+
- [ ] MISSION.md 已生成并写入工作区(或已标记跳过)
|
|
140
|
+
- [ ] 主轴判定已向用户展示并获得确认
|
|
141
|
+
- [ ] session-state.md 已更新
|