@ohos-cpf/3rdloop 0.0.2 → 0.0.3

package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md

@@ -1,263 +1,263 @@
----
-name: rn-library-known-issue-check
-description: 对 RN 三方库鸿蒙化代码进行已知问题检视，读取 RN 已知问题知识库（BadCase/rn 的 INDEX.md + rules/ + cases/），按预筛特征筛选适用规则，逐条对照源码检查是否命中历史案例中的问题模式，生成已知问题检视报告（0-100分）。作为 RN 仓库检视流程的并发维度之一，与稳定性/一致性/内存泄露/文档质量/用例覆盖度并行执行。Use when 需要对 RN 鸿蒙化库进行历史已知问题回归检视、避免重复踩坑、评估库对已知问题模式的规避程度。
-license: Apache-2.0
-compatibility: 需要访问 RN 已知问题知识库目录（BadCase/rn）、访问源码目录、分析 ArkTS/ETS 与 C++ 源码
-metadata:
-  author: CPPAgent
-  version: "2.0.0"
-  category: rn-library-check
----
-
-# rn-library-known-issue-check
-
-对 RN 三方库的**鸿蒙化实现代码**进行已知问题检视：读取**已知问题知识库**（`BadCase/rn`），按"预筛特征"筛选出适用于当前库的规则，逐条对照源码检查是否命中历史案例中的问题模式——**发现一例，避免一类**。
-
-> ⚠️ **核心定位**：
-> 1. 本 SKILL 是**知识库消费者**：只读 `BadCase/rn`（INDEX.md + rules/ + cases/），不修改知识库
-> 2. **预筛优先**：先读 INDEX.md 按"预筛特征"筛选适用规则，再按需读取规则/案例文件，避免全量检查
-> 3. **只消费 active 状态规则**：draft 状态规则未经验证，不参与检视
-> 4. **评分 = 通过率**：命中一条规则扣 30 分（总分 100，最低 0 分），命中规则在报告中引用案例作为修复指引
-
----
-
-## 任务参数
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `repoUrl` | string | ✅ | 鸿蒙化仓库地址（ohosRepoUrl） |
-| `outputDir` | string | ✅ | 输出目录绝对路径 |
-| `interfaceDocPath` | string | ✅ | 接口规格说明文档路径 |
-| `repoName` | string | ✅ | 仓库名称 |
-| `knowledgeDir` | string | ❌ | 已知问题知识库根目录绝对路径，默认 `BadCase/rn`（相对 3rdLibraryLoop 仓库根） |
-
----
-
-## 输入依赖
-
-- **前置 SKILL**: `rn-library-interface-analyzer`（阶段 1 已生成接口规格说明文档）
-- **输入文件**: `接口规格说明.md`（位于 outputDir）
-- **仓库源码**: 已克隆到 `{outputDir}/source/ohos/`（鸿蒙化）+ `{outputDir}/source/RN/`（上游原库）
-- **知识库**: `{knowledgeDir}`（默认 `BadCase/rn`），结构如下：
-
-```
-{knowledgeDir}/
-├── INDEX.md                          # 一级：分类 + 规则/案例索引（预筛入口）
-├── rules/                            # 二级：规则知识（检查点/特征 + 案例索引）
-│   └── R-{XX}-{规则名}.md
-├── cases/                            # 二级：案例知识（few-shot 参考 + 修复指引）
-│   └── KI-{XXX}-{库名现象}.md
-└── pr-info/                          # 案例原始 PR diff 证据材料（可选参考）
-```
-
-> 源码准备细节参见 [源码准备指南](references/SOURCE_PREP_GUIDE.md)
-
----
-
-## 工作流程概览
-
-```
-Phase 1: 读取知识库索引（INDEX.md）→ 获取规则清单
-    ↓
-Phase 2: 预筛适用规则（按"预筛特征"匹配当前库）
-    ↓
-Phase 3: 逐条规则检视（读规则文件 → 对照源码检查 → 判定命中/通过）
-    ↓
-Phase 4: 评分计算（命中一条扣 30 分，最低 0 分）
-    ↓
-Phase 5: 报告生成（命中清单 + 修复指引 + 案例链接）
-    ↓
-Phase 6: 合规自检（对照检查清单 + 运行校验脚本）
-```
-
----
-
-## Phase 1：读取知识库索引
-
-1. 读取 `{knowledgeDir}/INDEX.md`，获取：
-   - **规则分类索引表**：规则编号（R-XX）、规则名、严重级别、案例数、规则文件链接
-   - **案例索引表**：案例编号（KI-XXX）、库名、现象简述、所属规则、案例文件链接
-2. 记录所有规则编号与文件路径，进入 Phase 2
-
-> ⚠️ 若 `{knowledgeDir}` 不存在或 INDEX.md 缺失，视为知识库未初始化：报告评分 100 分，标注"知识库未初始化，跳过已知问题检视"。
-
----
-
-## Phase 2：预筛适用规则
-
-对每条规则，读取其规则文件（`rules/R-XX-*.md`）的**适用范围 + 预筛特征**，结合当前库的实际情况判定是否适用：
-
-| 预筛维度 | 判定依据 |
-|----------|----------|
-| **依赖特征** | 当前库的 oh-package.json5 / package.json 依赖中是否包含规则描述的依赖类型 |
-| **文件特征** | 源码中是否存在规则描述的文件类型（.ets / .cpp / module.json5 等） |
-| **API 特征** | 源码中是否调用规则描述的 API（sensor.on / .gesture() / window API 等） |
-| **能力声明** | 接口规格说明.md / README 中是否声明规则描述的能力（全屏/横屏/传感器等） |
-
-**判定规则**：
-- 命中任一预筛特征 → 规则**适用**，进入 Phase 3 深度检查
-- 未命中任何预筛特征 → 规则**不适用**，跳过（记录跳过原因）
-
-> 💡 **预筛是核心**：19 条规则不可能全部适用于每个库（如 R-01 全屏管理只适用于媒体类库）。预筛不适用规则不计入评分分母。
->
-> 📖 预筛详细操作、常见误判与规避参见 [预筛指南](references/PRESCREEN_GUIDE.md)
-
----
-
-## Phase 3：逐条规则检视
-
-对每条**适用规则**，执行以下步骤：
-
-### 3.1 读取规则文件
-
-读取 `rules/R-XX-*.md`，获取：
-- **问题本质**：机制层描述，理解这类问题为什么会发生
-- **检查点**：逐条可判定的源码检查动作
-- **错误特征**：命中此类问题的典型代码形态
-- **正确特征**：修复后的代码形态
-- **来源案例**：案例索引（编号/库/现象/案例文件）
-
-### 3.2 对照源码检查
-
-按规则文件的**检查点**逐条对照 `{outputDir}/source/ohos/` 源码检查，每条检查点给出 **是/否/疑似** 判定：
-
-| 判定 | 含义 | 处理 |
-|------|------|------|
-| **是**（命中） | 源码存在规则描述的**错误特征** | 记录为命中问题，引用案例作为修复指引 |
-| **否**（通过） | 源码符合**正确特征** | 记录为通过 |
-| **疑似** | 无法确定，需进一步确认 | 记录为疑似命中，报告中标注"需人工复核" |
-
-### 3.3 判定规则命中
-
-- 规则中**任一检查点命中错误特征** → 该规则**命中**（记 1 个问题）
-- 所有检查点均通过 → 该规则**通过**
-- 疑似命中 → 按命中处理（报告中标注"疑似"），避免漏报
-
-> 💡 **few-shot 参考**：判定困难时，读取规则文件引用的案例文件（`cases/KI-XXX-*.md`），对照"错误代码/正确代码"片段辅助判定。
->
-> 📖 检视详细操作、判定技巧与常见陷阱参见 [规则检视指南](references/INSPECTION_GUIDE.md)
-
----
-
-## Phase 4：评分计算
-
-**评分公式**：
-
-```
-评分 = max(0, 100 - 30 × 命中规则数)
-```
-
-- 命中 1 条规则 → 70 分
-- 命中 2 条规则 → 40 分
-- 命中 3 条规则 → 10 分
-- 命中 4 条及以上 → 0 分
-- 无适用规则 → 100 分（标注"无适用规则"）
-
-> ⚠️ **扣分制**：本维度不参与综合评分加权，作为**独立扣分项**作用于总分。命中一条已知问题，总分扣 30 分。
-
----
-
-## Phase 5：报告生成
-
-生成 `已知问题检视报告.md`（位于 `{outputDir}`），结构如下：
-
-```markdown
-# {repoName} 已知问题检视报告
-
-## 一、检视概览
-
-| 字段 | 内容 |
-|------|------|
-| **仓库名称** | {repoName} |
-| **检视时间** | {时间} |
-| **适用规则数** | {N} 条 |
-| **命中规则数** | {M} 条 |
-| **评分** | {score}/100 |
-
-## 二、规则命中清单
-
-| 规则编号 | 规则名 | 严重级别 | 判定 | 命中检查点 | 参考案例 |
-|----------|--------|----------|------|------------|----------|
-| R-XX | {规则名} | {high/medium/low} | 命中/通过/疑似 | {检查点描述} | [KI-XXX](案例链接) |
-
-## 三、命中问题详情
-
-### R-XX {规则名}（严重级别：{high/medium/low}）
-
-- **问题本质**：{问题本质}
-- **命中检查点**：{命中的检查点}
-- **错误特征**：{源码中命中的错误特征，引用文件位置}
-- **修复指引**：{正确特征}
-- **参考案例**：[KI-XXX {库名} {现象}]({案例文件路径})
-
-## 四、检视结论
-
-{总结：命中问题对库质量的影响，建议修复优先级}
-```
-
-> 📖 完整报告模板（含不适用规则清单、通过规则说明、数据置信度说明、风险评估）参见 [报告模板](assets/REPORT_TEMPLATE.md)
-
----
-
-## Phase 6：合规自检
-
-报告生成后，执行质量自检：
-
-### 6.1 对照检查清单
-
-对照 [合规检查清单](references/COMPLIANCE_CHECKLIST.md) 逐项检查：
-- 输入是否完整（知识库/源码/接口文档）
-- 预筛是否有明确判定依据
-- 命中问题是否有证据（文件路径 + 行号 + 代码片段）
-- 评分公式是否正确
-- 报告五部分是否齐全
-
-### 6.2 运行校验脚本
-
-```bash
-python3 {skillDir}/scripts/validate-known-issue-report.py '{"reportDir": "{outputDir}"}'
-```
-
-脚本输出 `ALL CHECKS PASSED` 表示通过，否则列出失败项并修复。
-
----
-
-## 输出产物
-
-| 产物 | 文件名 | 说明 |
-|------|--------|------|
-| 已知问题检视报告 | `已知问题检视报告.md` | 评分 + 规则命中清单 + 命中详情 + 修复指引 |
-
-所有产物写入 `{outputDir}` 目录。
-
-> ⚠️ **输出文件自检**：写入结果文件前，先确认 `已知问题检视报告.md` 已存在且内容完整（**独立文件，禁止只写入 result 执行结果文件**）。若报告内容仅在草稿中，必须先将其保存为上述独立文件。
-
-### 结构化指标输出（必须执行）
-
-执行环境会在任务 prompt 中下发一个**结构化指标文件输出路径**（`stepId{X}_loop{L}_meta_{N}.json`）。
-检视完成后，**必须**将最终评分以下述 JSON 对象写入该路径：
-
-```json
-{
-  "knownIssueScore": 100,
-  "scoreReason": "命中 R-08 手势重复绑定等 2 条规则（一句话判定依据，≤50字）"
-}
-```
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `knownIssueScore` | number | 已知问题评分（0-100 整数，与报告中 `**综合评分：XX/100**` 的数值一致；命中 K 条规则 = 100 − 30×K，最低 0） |
-| `scoreReason` | string | 评分判定依据摘要（可选，前端悬浮提示展示；命中规则时列出规则编号） |
-
-**说明**：该文件由执行框架自动收割入库（前端/历史列表直接读取评分，无需解析报告文本）。若 prompt 未下发该路径则跳过本节。
-
-> ⚠️ **独立扣分项口径**：本维度评分不参与 5 维加权综合评分，作为独立扣分项作用于总分（命中一条已知问题，总分扣 30 分）。`knownIssueScore` 仅表征本维度通过率。
-
----
-
-## 与其他 SKILL 的关系
-
-| SKILL | 关系 |
-|-------|------|
-| `rn-library-issue-generalizer`（问题泛化器） | **生产者**：将历史问题 PR 泛化为规则/案例写入知识库，本 SKILL 消费其产出 |
-| RN 仓库检视流水线 | 本 SKILL 作为阶段 2 并发维度之一，与其他 5 个检视 SKILL 并行执行；评分作为独立扣分项作用于总分 |
+---
+name: rn-library-known-issue-check
+description: 对 RN 三方库鸿蒙化代码进行已知问题检视，读取 RN 已知问题知识库（BadCase/rn 的 INDEX.md + rules/ + cases/），按预筛特征筛选适用规则，逐条对照源码检查是否命中历史案例中的问题模式，生成已知问题检视报告（0-100分）。作为 RN 仓库检视流程的并发维度之一，与稳定性/一致性/内存泄露/文档质量/用例覆盖度并行执行。Use when 需要对 RN 鸿蒙化库进行历史已知问题回归检视、避免重复踩坑、评估库对已知问题模式的规避程度。
+license: Apache-2.0
+compatibility: 需要访问 RN 已知问题知识库目录（BadCase/rn）、访问源码目录、分析 ArkTS/ETS 与 C++ 源码
+metadata:
+  author: CPPAgent
+  version: "2.0.0"
+  category: rn-library-check
+---
+
+# rn-library-known-issue-check
+
+对 RN 三方库的**鸿蒙化实现代码**进行已知问题检视：读取**已知问题知识库**（`BadCase/rn`），按"预筛特征"筛选出适用于当前库的规则，逐条对照源码检查是否命中历史案例中的问题模式——**发现一例，避免一类**。
+
+> ⚠️ **核心定位**：
+> 1. 本 SKILL 是**知识库消费者**：只读 `BadCase/rn`（INDEX.md + rules/ + cases/），不修改知识库
+> 2. **预筛优先**：先读 INDEX.md 按"预筛特征"筛选适用规则，再按需读取规则/案例文件，避免全量检查
+> 3. **只消费 active 状态规则**：draft 状态规则未经验证，不参与检视
+> 4. **评分 = 通过率**：命中一条规则扣 30 分（总分 100，最低 0 分），命中规则在报告中引用案例作为修复指引
+
+---
+
+## 任务参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `repoUrl` | string | ✅ | 鸿蒙化仓库地址（ohosRepoUrl） |
+| `outputDir` | string | ✅ | 输出目录绝对路径 |
+| `interfaceDocPath` | string | ✅ | 接口规格说明文档路径 |
+| `repoName` | string | ✅ | 仓库名称 |
+| `knowledgeDir` | string | ❌ | 已知问题知识库根目录绝对路径，默认 `BadCase/rn`（相对 3rdLibraryLoop 仓库根） |
+
+---
+
+## 输入依赖
+
+- **前置 SKILL**: `rn-library-interface-analyzer`（阶段 1 已生成接口规格说明文档）
+- **输入文件**: `接口规格说明.md`（位于 outputDir）
+- **仓库源码**: 已克隆到 `{outputDir}/source/ohos/`（鸿蒙化）+ `{outputDir}/source/RN/`（上游原库）
+- **知识库**: `{knowledgeDir}`（默认 `BadCase/rn`），结构如下：
+
+```
+{knowledgeDir}/
+├── INDEX.md                          # 一级：分类 + 规则/案例索引（预筛入口）
+├── rules/                            # 二级：规则知识（检查点/特征 + 案例索引）
+│   └── R-{XX}-{规则名}.md
+├── cases/                            # 二级：案例知识（few-shot 参考 + 修复指引）
+│   └── KI-{XXX}-{库名现象}.md
+└── pr-info/                          # 案例原始 PR diff 证据材料（可选参考）
+```
+
+> 源码准备细节参见 [源码准备指南](references/SOURCE_PREP_GUIDE.md)
+
+---
+
+## 工作流程概览
+
+```
+Phase 1: 读取知识库索引（INDEX.md）→ 获取规则清单
+    ↓
+Phase 2: 预筛适用规则（按"预筛特征"匹配当前库）
+    ↓
+Phase 3: 逐条规则检视（读规则文件 → 对照源码检查 → 判定命中/通过）
+    ↓
+Phase 4: 评分计算（命中一条扣 30 分，最低 0 分）
+    ↓
+Phase 5: 报告生成（命中清单 + 修复指引 + 案例链接）
+    ↓
+Phase 6: 合规自检（对照检查清单 + 运行校验脚本）
+```
+
+---
+
+## Phase 1：读取知识库索引
+
+1. 读取 `{knowledgeDir}/INDEX.md`，获取：
+   - **规则分类索引表**：规则编号（R-XX）、规则名、严重级别、案例数、规则文件链接
+   - **案例索引表**：案例编号（KI-XXX）、库名、现象简述、所属规则、案例文件链接
+2. 记录所有规则编号与文件路径，进入 Phase 2
+
+> ⚠️ 若 `{knowledgeDir}` 不存在或 INDEX.md 缺失，视为知识库未初始化：报告评分 100 分，标注"知识库未初始化，跳过已知问题检视"。
+
+---
+
+## Phase 2：预筛适用规则
+
+对每条规则，读取其规则文件（`rules/R-XX-*.md`）的**适用范围 + 预筛特征**，结合当前库的实际情况判定是否适用：
+
+| 预筛维度 | 判定依据 |
+|----------|----------|
+| **依赖特征** | 当前库的 oh-package.json5 / package.json 依赖中是否包含规则描述的依赖类型 |
+| **文件特征** | 源码中是否存在规则描述的文件类型（.ets / .cpp / module.json5 等） |
+| **API 特征** | 源码中是否调用规则描述的 API（sensor.on / .gesture() / window API 等） |
+| **能力声明** | 接口规格说明.md / README 中是否声明规则描述的能力（全屏/横屏/传感器等） |
+
+**判定规则**：
+- 命中任一预筛特征 → 规则**适用**，进入 Phase 3 深度检查
+- 未命中任何预筛特征 → 规则**不适用**，跳过（记录跳过原因）
+
+> 💡 **预筛是核心**：19 条规则不可能全部适用于每个库（如 R-01 全屏管理只适用于媒体类库）。预筛不适用规则不计入评分分母。
+>
+> 📖 预筛详细操作、常见误判与规避参见 [预筛指南](references/PRESCREEN_GUIDE.md)
+
+---
+
+## Phase 3：逐条规则检视
+
+对每条**适用规则**，执行以下步骤：
+
+### 3.1 读取规则文件
+
+读取 `rules/R-XX-*.md`，获取：
+- **问题本质**：机制层描述，理解这类问题为什么会发生
+- **检查点**：逐条可判定的源码检查动作
+- **错误特征**：命中此类问题的典型代码形态
+- **正确特征**：修复后的代码形态
+- **来源案例**：案例索引（编号/库/现象/案例文件）
+
+### 3.2 对照源码检查
+
+按规则文件的**检查点**逐条对照 `{outputDir}/source/ohos/` 源码检查，每条检查点给出 **是/否/疑似** 判定：
+
+| 判定 | 含义 | 处理 |
+|------|------|------|
+| **是**（命中） | 源码存在规则描述的**错误特征** | 记录为命中问题，引用案例作为修复指引 |
+| **否**（通过） | 源码符合**正确特征** | 记录为通过 |
+| **疑似** | 无法确定，需进一步确认 | 记录为疑似命中，报告中标注"需人工复核" |
+
+### 3.3 判定规则命中
+
+- 规则中**任一检查点命中错误特征** → 该规则**命中**（记 1 个问题）
+- 所有检查点均通过 → 该规则**通过**
+- 疑似命中 → 按命中处理（报告中标注"疑似"），避免漏报
+
+> 💡 **few-shot 参考**：判定困难时，读取规则文件引用的案例文件（`cases/KI-XXX-*.md`），对照"错误代码/正确代码"片段辅助判定。
+>
+> 📖 检视详细操作、判定技巧与常见陷阱参见 [规则检视指南](references/INSPECTION_GUIDE.md)
+
+---
+
+## Phase 4：评分计算
+
+**评分公式**：
+
+```
+评分 = max(0, 100 - 30 × 命中规则数)
+```
+
+- 命中 1 条规则 → 70 分
+- 命中 2 条规则 → 40 分
+- 命中 3 条规则 → 10 分
+- 命中 4 条及以上 → 0 分
+- 无适用规则 → 100 分（标注"无适用规则"）
+
+> ⚠️ **扣分制**：本维度不参与综合评分加权，作为**独立扣分项**作用于总分。命中一条已知问题，总分扣 30 分。
+
+---
+
+## Phase 5：报告生成
+
+生成 `已知问题检视报告.md`（位于 `{outputDir}`），结构如下：
+
+```markdown
+# {repoName} 已知问题检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **检视时间** | {时间} |
+| **适用规则数** | {N} 条 |
+| **命中规则数** | {M} 条 |
+| **评分** | {score}/100 |
+
+## 二、规则命中清单
+
+| 规则编号 | 规则名 | 严重级别 | 判定 | 命中检查点 | 参考案例 |
+|----------|--------|----------|------|------------|----------|
+| R-XX | {规则名} | {high/medium/low} | 命中/通过/疑似 | {检查点描述} | [KI-XXX](案例链接) |
+
+## 三、命中问题详情
+
+### R-XX {规则名}（严重级别：{high/medium/low}）
+
+- **问题本质**：{问题本质}
+- **命中检查点**：{命中的检查点}
+- **错误特征**：{源码中命中的错误特征，引用文件位置}
+- **修复指引**：{正确特征}
+- **参考案例**：[KI-XXX {库名} {现象}]({案例文件路径})
+
+## 四、检视结论
+
+{总结：命中问题对库质量的影响，建议修复优先级}
+```
+
+> 📖 完整报告模板（含不适用规则清单、通过规则说明、数据置信度说明、风险评估）参见 [报告模板](assets/REPORT_TEMPLATE.md)
+
+---
+
+## Phase 6：合规自检
+
+报告生成后，执行质量自检：
+
+### 6.1 对照检查清单
+
+对照 [合规检查清单](references/COMPLIANCE_CHECKLIST.md) 逐项检查：
+- 输入是否完整（知识库/源码/接口文档）
+- 预筛是否有明确判定依据
+- 命中问题是否有证据（文件路径 + 行号 + 代码片段）
+- 评分公式是否正确
+- 报告五部分是否齐全
+
+### 6.2 运行校验脚本
+
+```bash
+python3 {skillDir}/scripts/validate-known-issue-report.py '{"reportDir": "{outputDir}"}'
+```
+
+脚本输出 `ALL CHECKS PASSED` 表示通过，否则列出失败项并修复。
+
+---
+
+## 输出产物
+
+| 产物 | 文件名 | 说明 |
+|------|--------|------|
+| 已知问题检视报告 | `已知问题检视报告.md` | 评分 + 规则命中清单 + 命中详情 + 修复指引 |
+
+所有产物写入 `{outputDir}` 目录。
+
+> ⚠️ **输出文件自检**：写入结果文件前，先确认 `已知问题检视报告.md` 已存在且内容完整（**独立文件，禁止只写入 result 执行结果文件**）。若报告内容仅在草稿中，必须先将其保存为上述独立文件。
+
+### 结构化指标输出（必须执行）
+
+执行环境会在任务 prompt 中下发一个**结构化指标文件输出路径**（`stepId{X}_loop{L}_meta_{N}.json`）。
+检视完成后，**必须**将最终评分以下述 JSON 对象写入该路径：
+
+```json
+{
+  "knownIssueScore": 100,
+  "scoreReason": "命中 R-08 手势重复绑定等 2 条规则（一句话判定依据，≤50字）"
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `knownIssueScore` | number | 已知问题评分（0-100 整数，与报告中 `**综合评分：XX/100**` 的数值一致；命中 K 条规则 = 100 − 30×K，最低 0） |
+| `scoreReason` | string | 评分判定依据摘要（可选，前端悬浮提示展示；命中规则时列出规则编号） |
+
+**说明**：该文件由执行框架自动收割入库（前端/历史列表直接读取评分，无需解析报告文本）。若 prompt 未下发该路径则跳过本节。
+
+> ⚠️ **独立扣分项口径**：本维度评分不参与 5 维加权综合评分，作为独立扣分项作用于总分（命中一条已知问题，总分扣 30 分）。`knownIssueScore` 仅表征本维度通过率。
+
+---
+
+## 与其他 SKILL 的关系
+
+| SKILL | 关系 |
+|-------|------|
+| `rn-library-issue-generalizer`（问题泛化器） | **生产者**：将历史问题 PR 泛化为规则/案例写入知识库，本 SKILL 消费其产出 |
+| RN 仓库检视流水线 | 本 SKILL 作为阶段 2 并发维度之一，与其他 5 个检视 SKILL 并行执行；评分作为独立扣分项作用于总分 |