bear-review

bear-review · 论点攻防评估

一个工作流：把一个观点的正反两侧证据同时摆出来，让你看清这个观点在哪里站得住、在哪里最脆弱。这不是替你做判断，是让局面变得清楚。

先读 references/sci-cli.md——CLI 检测步骤、用法和铁律。 再读 references/output-system.md——HTML 外壳规范和设计 token。

步骤（固定顺序）

Step 0 — 确认 CLI 可用 运行 sci --version。未安装就给安装命令并停止；认证错误就提示 sci init 并停止。

Step 1 — 锁定主张 把观点压缩成一个精确、可证伪的句子，挖出隐含的范围（人群、条件、测量方式）。给主张编号 C1；多主张时拆成 C1、C2、C3，默认优先处理最核心的一条。

告知用户本次将执行约 10–13 次检索，然后直接开始，不等待确认。

Step 2 — 支持侧检索 对主张执行 sci search，--mode low，--limit 15，偏向直接支持的角度。按四级口径筛选（直接支撑 / 部分支撑 / 间接相关 / 排除），标出最强的那篇。

Step 3 — 反对侧检索 构建五类对立查询并逐一检索（宽泛角度用 ultra_low，有收获的方向用 low 复跑）：

1. 直接矛盾
2. 边界 / 复杂化
3. 替代解释
4. 方法批评
5. 复制失败 / 零结果

每篇反对文献评定威胁等级（高 / 中 / 低），附一行回应方向。

Step 4 — 交叉分析 检索结束后，做两项交叉：

• 有支持无反对的角度：列出（不等于安全，可能只是研究不足）
• 有反对无支持的角度：列出（这是最脆弱的地方）

Step 5 — 综合判断 基于检索结果（不加入记忆推断）写 2–4 句证据格局描述：支持侧整体信号强度、反对侧最集中的挑战类型、整体证据平衡状态。不做"你的观点对不对"的最终判断。

输出物

检索结束后，在当前目录创建 {topic-slug}/ 子文件夹，输出四个东西：

1. 终端 — 直接 print 综合摘要：支持侧首选引用 + 反对侧最高威胁 + 交叉分析要点
2. report.md — 稳定 YAML front matter + 综合判断 + 支持侧证据阶梯 + 反对侧威胁矩阵 + 交叉分析 + 检索透明度
3. report.html — 综合报告，见下方 HTML 规范
4. references.bib — 合并所有 query 的 .bib，去重后只保留报告引用的文献

HTML 报告规范

强调色 #7c3aed（紫，区别于单独运行 bear-support 的绿和 bear-counter 的红）。

首屏：综合判断面板

.verdict 区块并排三栏：

• 左：支持侧最强证据（作者年份 + 一句支撑关系，绿色 accent）
• 中：证据格局 2–4 句描述（紫色 accent，核心位置）
• 右：反对侧最高威胁（作者年份 + 威胁类型 + 一句回应方向，红色 accent）

.metric-strip：有效支持文献数 / 高威胁反证数 / 仅有支持无反对角度数 / 仅有反对无支持角度数

交叉分析面板（首屏下方，独立 section）

两列并排：

• 左列「有支持，未见反对」：列出角度名 + 说明"未见反对不等于无争议"
• 右列「有反对，缺乏支持」：列出角度名 + 标注脆弱程度（高 / 中）

详细证据区（tabs）

两个 tab：「支持侧」「反对侧」，默认显示「支持侧」。

支持侧 tab 内：证据阶梯（直接支撑 / 部分支撑 / 间接相关），文献卡片含 DOI 链接、中文学术摘要折叠。 反对侧 tab 内：按「高威胁 / 中威胁 / 低威胁」三组展示，五类挑战方向作为 pill 标签标注在各卡片上，不要再嵌一层 tabs。每张卡片含威胁等级 + 回应：... + DOI 链接 + 中文学术摘要折叠。

最重要的卡片（支持侧首选引用、反对侧最高威胁）加 .card-primary class，摘要默认展开。

检索透明度（底部）：列出所有查询词、mode、返回数、采用数，以及空结果方向。

诚实边界

所有文献来自本次检索。"有支持无反对"只说明本次检索没有找到，不等于该角度没有争议。交叉分析是检索覆盖的切片，不是完整的证据地图。

Gotchas

• 两侧检索的查询词要基于同一主张，不要在支持侧搜宽泛背景文献、在反对侧搜核心争议——两侧口径不一致会让交叉分析失去意义
• 交叉分析不能省略：这是 bear-review 比分别跑两个 skill 更有价值的核心，不要因为检索结果复杂就跳过
• 证据格局描述要克制：2–4 句，说"支持侧信号整体较强但集中在特定条件下"这类有据可查的判断，不要说"因此这个观点是正确的"