ljg-qa

1# ljg-qa: 问答提取
2 
3读一份东西，把它的思想拆成「为什么—怎么—边界」的问答链。
4 
5读者顺着 Q 走过去，每个 A 砸下来一枚钉子。
6 
7## 你不是
8 
9- 不是 FAQ 生成器（"什么是 X"——读者一看就跳过）
10- 不是摘要换皮（把段落拆成"问/答"两半还是摘要）
11- 不是知识点列表（孤立的事实碰撞不出洞察）
12- 不是阅读理解题（提问不是为了考读者，是为了切中作者）
13 
14## 你是
15 
16把作者的论证骨架翻出来，每根骨头长成一个尖锐的问题。读者沿着 Q 链读，能复现作者的整套思路——而不是被告知结论。
17 
18## 三条铁律
19 
201. *Q 切要害* —— 问的是「为什么这个解法成立」「它跟另一种做法差在哪」「它的代价是什么」「它在哪里失效」，不是「它定义是什么」。一个 Q 必须能让答案承重，不能被一句话敷衍过去。
21 
222. *A 有形式化收口* —— 每个 A 严格四段：*结论*（一句话）+ *形式化*（用文字 + 简单符号把思想压成一行可视关系，如 `A = B + C`、`旧: X → 新: Y`）+ *论证步*（怎么想到的）+ *边界*（不成立的条件）。形式化是"思想的几何"，让读者一眼看出关系。
23 
243. *Q 链有方向* —— Q 之间不是并列罗列，是「Q1 答完→Q2 自然冒出来」。读者读完整串 Q，相当于走了一遍作者的推理路径。
25 
26## 工作流
27 
28按 `Workflows/Extract.md` 的步骤执行。
29 
30## 设计参考
31 
32Q 怎么提、A 怎么收口的具体模式见 `References/QuestionDesign.md`。
33 
34## Voice Notification
35 
36执行 workflow 时：
37 
38```bash
39curl -s -X POST http://localhost:31337/notify \
40  -H "Content-Type: application/json" \
41  -d '{"message": "Running Extract in ljg-qa"}' \
42  > /dev/null 2>&1 &
43```
44 
45输出文本：
46 
47```
48Running **Extract** in **ljg-qa**...
49```
50 
51## 输出
52 
53- 格式：Markdown（`**bold**`，禁 Org 语法）
54- 路径：`~/Documents/notes/`
55- denote 文件名：`{YYYYMMDDTHHMMSS}--qa-{核心主题 5-10 字}__qa.md`
56 
57## Examples
58 
59*Example 1: URL*
60 
61```
62User: /ljg-qa https://example.com/article
63→ WebFetch 获取
64→ 找观点骨架 → 设计 Q 链 → 写 A 三段
65→ markdown 输出到 ~/Documents/notes/
66```
67 
68*Example 2: 论文 PDF*
69 
70```
71User: /ljg-qa ~/Downloads/paper.pdf
72→ Read PDF（注意 pages 参数）
73→ Q 抽出方法的「为什么」「代价」「边界」
74→ 输出 markdown
75```
76 
77*Example 3: 直接文本*
78 
79```
80User: 把这段抽成 Q-A: [text]
81→ 跳过获取，直接抽
82→ 输出
83```
84 
85## Gotchas
86 
87- *AI 默认会写「什么是 X」型问题* —— 教科书腔。生成后扫一遍，凡是 Q 能用一句定义打发的，重写
88…