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,291 @@
1
+ # 示例代码组织规范
2
+
3
+ 阶段4判断"示例代码放内联还是独立文件"时查阅本文件。
4
+
5
+ ---
6
+
7
+ ## 核心原则
8
+
9
+ **宁可多建一个文件夹,也不要让用户拿到一段无法直接运行的代码。**
10
+
11
+ ---
12
+
13
+ ## 决策规则表
14
+
15
+ | 判断条件 | 处理方式 | 原因 |
16
+ |---------|---------|------|
17
+ | 单文件、少于 30 行、无需依赖安装即可理解 | 内联在 Markdown 代码块 | 简短演示,用户可直接复制粘贴 |
18
+ | 需要多个文件配合(如 HTML+CSS+JS、前后端分离) | 放入 `tutorial-examples/` | 多文件关系需要目录结构展示 |
19
+ | 需要依赖声明文件(如 `package.json`、`requirements.txt`) | 放入 `tutorial-examples/` | 用户需要安装依赖才能运行 |
20
+ | 需要构建配置文件(如 `vite.config.js`、`tsconfig.json`) | 放入 `tutorial-examples/` | 涉及构建流程,不能内联 |
21
+ | 单文件但超过 50 行 | 优先放入 `tutorial-examples/` | 代码过长会打断阅读流 |
22
+ | 与章节内容高度相关的简短演示 | 内联在 Markdown 代码块 | 即看即懂,无需切换文件 |
23
+
24
+ ---
25
+
26
+ ## 内联代码块规范
27
+
28
+ ### 适用场景
29
+
30
+ - 演示单个概念的最小示例
31
+ - 代码少于 30 行
32
+ - 不依赖外部库(或仅依赖标准库)
33
+ - 用户复制粘贴后可立即运行
34
+
35
+ ### 格式要求
36
+
37
+ ```markdown
38
+ ### 示例:基本用法
39
+
40
+ \```javascript
41
+ // 演示 useState 的基本用法
42
+ import { useState } from 'react';
43
+
44
+ function Counter() {
45
+ const [count, setCount] = useState(0);
46
+
47
+ return (
48
+ <button onClick={() => setCount(count + 1)}>
49
+ 点击次数: {count}
50
+ </button>
51
+ );
52
+ }
53
+ \```
54
+
55
+ **说明**:每次点击按钮,`count` 会加1,组件会重新渲染。
56
+ ```
57
+
58
+ ### 标注规范
59
+
60
+ - **来自原始资料** → 无需标注
61
+ - **AI 补充** → 在代码块后添加 `<!-- 示例由 AI 补充 -->`
62
+
63
+ ---
64
+
65
+ ## 独立示例文件规范
66
+
67
+ ### 目录结构
68
+
69
+ ```
70
+ [主题]-tutorial/
71
+ └── tutorial-examples/
72
+ ├── 01-hello-world/
73
+ │ ├── README.md ← 必选:运行方式、预期输出
74
+ │ ├── index.js ← 主代码文件
75
+ │ └── package.json ← 依赖声明(如需要)
76
+ ├── 02-state-hook/
77
+ │ ├── README.md
78
+ │ ├── App.jsx
79
+ │ ├── index.html
80
+ │ └── package.json
81
+ └── ...
82
+ ```
83
+
84
+ ### 命名规则
85
+
86
+ **文件夹命名**:`序号-知识点英文短名`
87
+
88
+ | 正确 | 错误 |
89
+ |------|------|
90
+ | `01-hello-world` | `01-第一个示例` |
91
+ | `02-async-await` | `example-2` |
92
+ | `03-custom-hook` | `03_CustomHook` |
93
+
94
+ **序号对应关系**:按示例在教程中出现的顺序编号,与章节编号无关。
95
+
96
+ ### README.md 模板
97
+
98
+ ```markdown
99
+ # [知识点名称] 示例
100
+
101
+ ## 知识点说明
102
+
103
+ 这个示例演示了:
104
+ - [核心概念1]
105
+ - [核心概念2]
106
+
107
+ ## 运行方式
108
+
109
+ \```bash
110
+ # 安装依赖(如需要)
111
+ pnpm install
112
+
113
+ # 运行
114
+ node index.js
115
+ \```
116
+
117
+ ## 预期输出
118
+
119
+ \```
120
+ Hello, World!
121
+ 计算结果: 42
122
+ \```
123
+
124
+ ## 关键代码说明
125
+
126
+ - **第X行** `函数名()` — 作用是什么
127
+ - **第Y行** `变量名` — 为什么这样设计
128
+
129
+ ## 扩展练习(可选)
130
+
131
+ 试着修改代码:
132
+ 1. 将输出改为 "你好,世界!"
133
+ 2. 计算 1+2+3+...+100 的和
134
+ ```
135
+
136
+ ### 教程中的引用方式
137
+
138
+ ```markdown
139
+ ### 核心概念
140
+
141
+ [概念描述]
142
+
143
+ > [完整示例] **完整示例**:[tutorial-examples/01-hello-world/](../tutorial-examples/01-hello-world/) — 可直接运行验证
144
+ ```
145
+
146
+ ---
147
+
148
+ ## 决策流程图
149
+
150
+ ```
151
+ 收到一个示例需求
152
+ ↓
153
+ 是否需要多个文件? ──是→ 独立文件夹
154
+ ↓ 否
155
+ 是否需要依赖或构建配置? ──是→ 独立文件夹
156
+ ↓ 否
157
+ 代码是否超过50行? ──是→ 独立文件夹
158
+ ↓ 否
159
+ 内联代码块
160
+ ```
161
+
162
+ ---
163
+
164
+ ## 特殊场景处理
165
+
166
+ ### 场景1:前后端分离示例
167
+
168
+ ```
169
+ tutorial-examples/
170
+ └── 05-fullstack-demo/
171
+ ├── README.md
172
+ ├── frontend/
173
+ │ ├── src/
174
+ │ ├── index.html
175
+ │ └── package.json
176
+ └── backend/
177
+ ├── server.js
178
+ └── package.json
179
+ ```
180
+
181
+ **README.md 说明**:
182
+ ```markdown
183
+ ## 运行方式
184
+
185
+ ### 启动后端
186
+ \```bash
187
+ cd backend
188
+ npm install
189
+ npm start
190
+ \```
191
+
192
+ ### 启动前端
193
+ \```bash
194
+ cd frontend
195
+ npm install
196
+ npm run dev
197
+ \```
198
+
199
+ 访问 http://localhost:3000
200
+ ```
201
+
202
+ ### 场景2:需要环境变量的示例
203
+
204
+ ```
205
+ tutorial-examples/
206
+ └── 06-api-call/
207
+ ├── README.md
208
+ ├── .env.example ← 环境变量模板
209
+ ├── index.js
210
+ └── package.json
211
+ ```
212
+
213
+ **README.md 说明**:
214
+ ```markdown
215
+ ## 运行前准备
216
+
217
+ 1. 复制环境变量模板
218
+ \```bash
219
+ cp .env.example .env
220
+ \```
221
+
222
+ 2. 编辑 `.env` 文件,填入你的 API 密钥
223
+ \```
224
+ API_KEY=your_api_key_here
225
+ \```
226
+
227
+ 3. 运行
228
+ \```bash
229
+ npm install
230
+ node index.js
231
+ \```
232
+ ```
233
+
234
+ ### 场景3:需要数据文件的示例
235
+
236
+ ```
237
+ tutorial-examples/
238
+ └── 07-data-processing/
239
+ ├── README.md
240
+ ├── data/
241
+ │ └── sample.json ← 示例数据
242
+ ├── process.js
243
+ └── package.json
244
+ ```
245
+
246
+ ---
247
+
248
+ ## 示例代码质量标准
249
+
250
+ ### 必须满足
251
+
252
+ - [通过] 代码可以直接运行(或按 README 说明运行)
253
+ - [通过] 有清晰的注释(中文)
254
+ - [通过] 变量命名语义化(英文,驼峰命名)
255
+ - [通过] 演示单一知识点,不混杂无关逻辑
256
+
257
+ ### 推荐满足
258
+
259
+ - [推荐] 有错误处理(至少 try-catch)
260
+ - [推荐] 有输入验证(如果接受参数)
261
+ - [推荐] 有扩展练习建议
262
+
263
+ ### 禁止出现
264
+
265
+ - [禁止] 硬编码的密钥、密码、token
266
+ - [禁止] 指向不存在的文件路径
267
+ - [禁止] 依赖未声明的全局变量
268
+ - [禁止] 需要特定操作系统才能运行(除非教程就是针对该系统)
269
+
270
+ ---
271
+
272
+ ## 拿不准时的决策建议
273
+
274
+ **优先建独立文件夹**,因为:
275
+ 1. 用户可以直接用 IDE 打开整个示例目录
276
+ 2. 后续可以轻松扩展示例(添加测试、增加文件)
277
+ 3. 避免用户复制粘贴时丢失缩进或格式
278
+
279
+ **只有在"示例极其简短且与正文高度耦合"时才内联。**
280
+
281
+ ---
282
+
283
+ ## 检查清单
284
+
285
+ 创建独立示例文件后,自检:
286
+ - [ ] 文件夹命名符合 `序号-英文短名` 格式
287
+ - [ ] 有 README.md 文件
288
+ - [ ] README.md 包含运行方式和预期输出
289
+ - [ ] 代码有中文注释
290
+ - [ ] 教程中有引用该示例(`> [完整示例] **完整示例**:...`)
291
+ - [ ] 示例可以直接运行(或按 README 说明运行)
@@ -0,0 +1,296 @@
1
+ # 反馈类型识别与处理策略
2
+
3
+ 阶段5.5 收到用户反馈后,必须先读取本文件进行反馈类型匹配,再执行对应策略。
4
+
5
+ ---
6
+
7
+ ## 反馈类型识别表
8
+
9
+ | 反馈模式 | 识别关键词 | 补充策略 | 输出位置 | 优先级 |
10
+ |---------|-----------|---------|---------|--------|
11
+ | **术语黑话** | "不懂这个词"、"什么意思"、"专业术语"、"行业黑话" | 增加"通俗来说"段落,类比日常场景 | 原段落后插入 | 中 |
12
+ | **流程复杂** | "工作方式不清楚"、"怎么执行的"、"关系是什么"、"流程"、涉及≥3步骤 | **优先**调用 drawio MCP 绘制流程图(不可用时按阶段0降级策略处理) | 章节内新增"工作流程图"小节 | 高 |
13
+ | **选项参数多** | "指令含糊"、"选项太多"、"参数记不住"、"各个参数的区别" | 制作参数对照表+常见组合示例 | 原段落后插入表格 | 高 |
14
+ | **概念抽象** | "不知道什么时候用"、"有实际例子吗"、"看不懂应用场景" | 补充真实使用场景+代码示例 | 检查 tutorial-examples/ 是否已有,没有则新建 | 中 |
15
+ | **前置知识缺** | "为什么要这样"、"前提是什么"、"不懂基础" | 回链到前置章节或新增"前置知识"callout | 章节开头插入 | 低 |
16
+
17
+ ---
18
+
19
+ ## 决策流程图
20
+
21
+ ```
22
+ 收到用户反馈
23
+ ↓
24
+ 提取关键词 → 匹配反馈类型
25
+ ↓
26
+ 优先级排序(高→中→低)
27
+ ↓
28
+ 执行对应策略
29
+ ↓
30
+ 标注已处理(在文件中追加注释)
31
+ ↓
32
+ 询问:"已针对 [章节X] 补充了 [策略Y],请查阅。还有其他需要完善的地方吗?"
33
+ ```
34
+
35
+ ---
36
+
37
+ ## 策略详细说明
38
+
39
+ ### 1. 术语黑话(优先级:中)
40
+
41
+ #### 识别示例
42
+ - [匹配] "stash 是什么意思"
43
+ - [匹配] "这个专业术语看不懂"
44
+ - [匹配] "行业黑话太多"
45
+
46
+ #### 处理策略
47
+
48
+ **增加"通俗来说"段落**,使用以下模板:
49
+
50
+ ```markdown
51
+ ### 核心概念
52
+
53
+ [原有专业描述]
54
+
55
+ <!-- 补充:通俗解释 -->
56
+ > **通俗来说**:[用日常生活类比]。
57
+ >
58
+ > **具体到这里**:[结合当前技术上下文解释]。
59
+ ```
60
+
61
+ **示例**:
62
+ ```markdown
63
+ ### Git Stash(暂存)
64
+
65
+ Git stash 用于临时保存工作区和暂存区的改动,切换到干净的工作目录。
66
+
67
+ <!-- 补充:通俗解释 -->
68
+ > **通俗来说**:就像做菜时接了个电话,你先把手上的菜放进保鲜盒(stash),等打完电话再拿出来继续做。
69
+ >
70
+ > **具体到这里**:你正在开发功能A,突然要紧急修复 bug B。用 `git stash` 把功能A的改动临时存起来,修完 bug 后用 `git stash pop` 恢复功能A的改动。
71
+ ```
72
+
73
+ ---
74
+
75
+ ### 2. 流程复杂(优先级:高)
76
+
77
+ #### 识别示例
78
+ - [匹配] "工作方式不清楚"
79
+ - [匹配] "这几个命令的关系是什么"
80
+ - [匹配] "git stash 各个指令的描述比较含糊不清"
81
+
82
+ #### 强制触发条件
83
+
84
+ 用户反馈涉及以下任一情况时,**优先**使用 drawio MCP:
85
+ - 用户明确说"工作方式"、"执行流程"、"怎么运行的"
86
+ - 描述中涉及 ≥3 个步骤或组件交互
87
+ - 命令行工具的多个选项之间有依赖关系
88
+
89
+ > 若 drawio MCP 不可用(参见 SKILL.md 阶段0 环境检测表),降级为文字步骤描述,并向用户说明"当前环境不支持绘图,使用文字描述替代"。
90
+
91
+ #### 处理策略
92
+
93
+ **步骤1:调用 drawio MCP 绘制流程图**
94
+
95
+ 图表类型选择:
96
+ - 命令选项关系 → 流程图(决策分支)
97
+ - 系统组件交互 → 架构图
98
+ - 时间顺序操作 → 时序图
99
+
100
+ **步骤2:导出 .drawio 文件**
101
+
102
+ 命名格式:`章节编号_概念名_流程图.drawio`(如 `03_git-stash_workflow.drawio`)
103
+
104
+ 保存位置:`[教程根目录]/diagrams/`
105
+
106
+ **步骤3:在教程中插入引用**
107
+
108
+ ```markdown
109
+ ### 工作流程图
110
+
111
+ > [流程图] **流程图**:[查看 git stash 工作流程](../diagrams/03_git-stash_workflow.drawio) — 辅助理解示意图
112
+ >
113
+ > **关键节点说明**:
114
+ > - `git stash save` → 保存当前改动到 stash 栈
115
+ > - `git stash list` → 查看所有 stash 记录
116
+ > - `git stash pop` → 恢复最近的 stash 并删除记录
117
+ > - `git stash apply` → 恢复 stash 但保留记录
118
+ ```
119
+
120
+ ---
121
+
122
+ ### 3. 选项参数多(优先级:高)
123
+
124
+ #### 识别示例
125
+ - [匹配] "git stash 指令描述含糊,容易误解"
126
+ - [匹配] "这些复杂的命令最好可以详细解释一下"
127
+ - [匹配] "各个参数的区别是什么"
128
+
129
+ #### 处理策略
130
+
131
+ **制作参数对照表**,包含以下列:
132
+
133
+ | 列名 | 内容 |
134
+ |------|------|
135
+ | 命令/选项 | 具体语法 |
136
+ | 作用 | 一句话描述功能 |
137
+ | 使用场景 | 什么时候用 |
138
+ | 注意事项 | 常见误区或副作用 |
139
+
140
+ **示例**:
141
+
142
+ ```markdown
143
+ ### Git Stash 命令对照表
144
+
145
+ | 命令 | 作用 | 使用场景 | 注意事项 |
146
+ |------|------|---------|---------|
147
+ | `git stash` | 快速保存改动(默认 save) | 临时切换分支 | 不包含 untracked 文件 |
148
+ | `git stash save "message"` | 保存并添加描述信息 | 多个 stash 时便于识别 | message 必须用引号 |
149
+ | `git stash -u` | 保存改动,包含 untracked 文件 | 新建了文件但未 add | - |
150
+ | `git stash list` | 查看所有 stash 记录 | 恢复前先确认有哪些 stash | 按时间倒序显示 |
151
+ | `git stash pop` | 恢复最近的 stash 并删除 | 确定不再需要该 stash | 有冲突时不会删除 stash |
152
+ | `git stash apply stash@{n}` | 恢复指定 stash 但保留记录 | 想多次使用同一 stash | 需手动 drop 清理 |
153
+ | `git stash drop stash@{n}` | 删除指定 stash | 确认不再需要 | 无法恢复 |
154
+ | `git stash clear` | 删除所有 stash | 清理旧记录 | [危险] 危险操作,无法撤销 |
155
+
156
+ ### 常见组合用法
157
+
158
+ \```bash
159
+ # 场景1:临时切换分支修 bug
160
+ git stash -u # 保存当前所有改动(包括新文件)
161
+ git checkout hotfix # 切换到修复分支
162
+ # ... 修复 bug ...
163
+ git checkout feature # 切回原分支
164
+ git stash pop # 恢复改动
165
+
166
+ # 场景2:保留 stash 多次使用
167
+ git stash save "尝试性重构"
168
+ git stash apply stash@{0} # 应用但不删除
169
+ # ... 测试效果 ...
170
+ git reset --hard # 如果效果不好,重置
171
+ git stash apply stash@{0} # 重新尝试
172
+ \```
173
+ ```
174
+
175
+ ---
176
+
177
+ ### 4. 概念抽象(优先级:中)
178
+
179
+ #### 识别示例
180
+ - [匹配] "不知道什么时候用"
181
+ - [匹配] "有实际例子吗"
182
+ - [匹配] "看不懂应用场景"
183
+
184
+ #### 处理策略
185
+
186
+ **步骤1:检查是否已有示例代码**
187
+
188
+ 检查 `tutorial-examples/` 目录,是否存在对应知识点的示例。
189
+
190
+ **步骤2A:已有示例 → 增强使用场景描述**
191
+
192
+ ```markdown
193
+ ### 使用场景
194
+
195
+ **场景1:功能开发中途需要紧急修复**
196
+ - 你正在开发新功能,代码改了一半
197
+ - 突然产品说有个紧急 bug 要修
198
+ - 用 `git stash` 暂存当前改动,修完 bug 后 `git stash pop` 恢复
199
+
200
+ **场景2:实验性修改**
201
+ - 想尝试一个不确定的重构方案
202
+ - 用 `git stash save "尝试重构"` 保存当前稳定版本
203
+ - 大胆修改,效果不好就 `git reset --hard` + `git stash apply` 重来
204
+
205
+ > [完整示例] **完整示例**:[tutorial-examples/03-stash-workflow/](../tutorial-examples/03-stash-workflow/) — 模拟真实开发场景
206
+ ```
207
+
208
+ **步骤2B:无示例 → 创建新示例**
209
+
210
+ 参照 `references/example-structures.md` 判断是否需要独立文件。
211
+
212
+ 如果需要,创建示例目录并编写 README.md。
213
+
214
+ ---
215
+
216
+ ### 5. 前置知识缺(优先级:低)
217
+
218
+ #### 识别示例
219
+ - [匹配] "为什么要这样做"
220
+ - [匹配] "不懂这个概念的前提"
221
+ - [匹配] "前置知识是什么"
222
+
223
+ #### 处理策略
224
+
225
+ **在章节开头插入前置知识 callout**:
226
+
227
+ ```markdown
228
+ ## 章节标题
229
+
230
+ > [前置] **需要先了解**:
231
+ > - [第1章 工作区与暂存区](./01-基础概念.md#工作区与暂存区) — 理解 Git 的三个存储区域
232
+ > - [第2章 分支管理](./02-分支管理.md#切换分支) — 熟悉 `git checkout` 命令
233
+ >
234
+ > 如果还不熟悉这些概念,建议先阅读上述章节。
235
+
236
+ [原有章节内容]
237
+ ```
238
+
239
+ ---
240
+
241
+ ## 多类型反馈的处理顺序
242
+
243
+ 如果用户在一条反馈中同时提到多个问题,按以下优先级依次处理:
244
+
245
+ 1. **流程复杂**(高) — 先画图建立整体认知
246
+ 2. **选项参数多**(高) — 再补充详细参数说明
247
+ 3. **术语黑话**(中) — 解释专业术语
248
+ 4. **概念抽象**(中) — 补充使用场景
249
+ 5. **前置知识缺**(低) — 最后添加前置链接
250
+
251
+ **示例**:
252
+
253
+ 用户反馈:"3.4 git stash 工作方式不清楚,各个指令描述含糊"
254
+
255
+ 处理顺序:
256
+ 1. 先绘制 git stash 工作流程图(流程复杂)
257
+ 2. 再制作命令对照表(选项参数多)
258
+
259
+ ---
260
+
261
+ ## 补充内容标注规范
262
+
263
+ 所有补充内容必须标注来源:
264
+
265
+ ```markdown
266
+ <!-- 补充:通俗解释 -->
267
+ <!-- 补充:流程图(阶段5.5用户反馈) -->
268
+ <!-- 补充:参数表(阶段5.5用户反馈) -->
269
+ ```
270
+
271
+ 在"05-参考资源.md"末尾追加:
272
+
273
+ ```markdown
274
+ ## 补充记录
275
+
276
+ ### 阶段5.5 交互式完善
277
+ - 第3章第4节:根据用户反馈补充了 git stash 工作流程图和命令对照表
278
+ - 第5章第2节:补充了通俗解释
279
+ ```
280
+
281
+ ---
282
+
283
+ ## 迭代退出条件
284
+
285
+ 参见 `rules/quality-gates.md` 的"迭代退出条件"章节。
286
+
287
+ ---
288
+
289
+ ## 常见错误
290
+
291
+ | 错误 | 后果 | 正确做法 |
292
+ |------|------|---------|
293
+ | 所有反馈都用"通俗解释"处理 | 流程复杂问题无法解决 | 先匹配反馈类型,按优先级执行不同策略 |
294
+ | 流程类反馈用纯文字描述 | 用户仍然看不懂 | 必须调用 drawio MCP 绘图 |
295
+ | 参数表只列命令,不说使用场景 | 用户不知道什么时候用 | 表格必须有"使用场景"列 |
296
+ | 补充内容没有标注 | 无法追溯来源 | 所有补充必须用 `<!-- 补充:xxx -->` 标注 |