@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/rn-library-issue-generalizer/scripts/fetch-pr-info.py

@@ -0,0 +1,239 @@
+#!/usr/bin/env python3
+# @tool fetch-pr-info
+# @description 获取 GitCode PR 元数据与 diff，生成可读摘要材料（rn-library-issue-generalizer 专用）
+# @param prUrl: string - GitCode PR 地址，https://gitcode.com/{owner}/{repo}/pull/{number}
+# @param outputDir: string - 输出目录绝对路径，材料写入 {outputDir}/pr-info/
+# @param token: string - 可选，GitCode API Token（私有仓库/限流时使用）
+
+"""fetch-pr-info.py — GitCode PR 材料获取脚本
+
+用法:
+    python3 fetch-pr-info.py '{"prUrl": "https://gitcode.com/owner/repo/pull/123", "outputDir": "/abs/path", "token": "xxx"}'
+
+产出:
+    {outputDir}/pr-info/{repo}-{number}.md    可读摘要（标题/描述/状态/变更文件/diff）
+    {outputDir}/pr-info/{repo}-{number}.json  API 原始响应
+
+依赖: 仅 Python 标准库（urllib），无第三方依赖
+"""
+
+import json
+import sys
+import time
+import urllib.error
+import urllib.request
+from pathlib import Path
+from urllib.parse import urlparse
+
+API_BASE = "https://gitcode.com/api/v5"
+REQUEST_TIMEOUT = 20          # 单次请求超时（秒）
+MAX_RETRIES = 3               # 限流/网络错误重试次数
+RETRY_BASE_DELAY = 2          # 重试基础间隔（秒），按次数递增
+PER_PAGE = 100                # files 接口分页大小
+MAX_FILES_PAGES = 5           # files 接口最多翻页数（防超大 PR）
+MAX_PATCH_CHARS = 20000       # 单文件 patch 截断阈值
+MAX_TOTAL_PATCH_CHARS = 200000  # 全部 patch 总量截断阈值
+
+
+def parse_pr_url(pr_url: str):
+    """解析 PR 地址，返回 (owner, repo, number)"""
+    parsed = urlparse(pr_url)
+    if "gitcode.com" not in (parsed.hostname or ""):
+        raise ValueError(f"仅支持 gitcode.com 地址: {pr_url}")
+    parts = [p for p in parsed.path.split("/") if p]
+    if len(parts) < 4 or parts[2] != "pull":
+        raise ValueError(f"PR 地址格式无效（应为 owner/repo/pull/number）: {pr_url}")
+    owner, repo = parts[0], parts[1]
+    if repo.endswith(".git"):
+        repo = repo[:-4]
+    try:
+        number = int(parts[3])
+    except ValueError:
+        raise ValueError(f"PR 序号无效: {parts[3]}")
+    if number <= 0:
+        raise ValueError(f"PR 序号无效: {number}")
+    return owner, repo, number
+
+
+def api_get(path: str, token: str = "") -> dict:
+    """GET {API_BASE}{path}，带重试，返回 JSON dict"""
+    url = f"{API_BASE}{path}"
+    req = urllib.request.Request(url, headers={"Accept": "application/json"})
+    if token:
+        req.add_header("Authorization", f"Bearer {token}")
+
+    last_err = None
+    for attempt in range(1, MAX_RETRIES + 1):
+        try:
+            with urllib.request.urlopen(req, timeout=REQUEST_TIMEOUT) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            # 403/429 视为限流，可重试；401/404 等直接失败
+            if e.code in (403, 429) and attempt < MAX_RETRIES:
+                last_err = e
+                time.sleep(RETRY_BASE_DELAY * attempt)
+                continue
+            raise ValueError(f"HTTP {e.code}: {url}") from e
+        except (urllib.error.URLError, TimeoutError) as e:
+            if attempt < MAX_RETRIES:
+                last_err = e
+                time.sleep(RETRY_BASE_DELAY * attempt)
+                continue
+            raise ValueError(f"网络错误: {url} ({e})") from e
+    raise ValueError(f"重试耗尽: {url} ({last_err})")
+
+
+def normalize_patch(file_entry: dict) -> None:
+    """归一化 patch 字段：GitCode 返回 dict（含 diff/old_path/new_path），GitHub 风格为字符串。
+    统一转换为字符串，并补充 filename（若缺失）。原地修改。"""
+    patch = file_entry.get("patch")
+    if isinstance(patch, dict):
+        diff = patch.get("diff") or ""
+        if not file_entry.get("filename"):
+            file_entry["filename"] = patch.get("new_path") or patch.get("old_path") or "?"
+        file_entry["patch"] = diff
+    elif patch is None:
+        file_entry["patch"] = ""
+
+
+def fetch_pr_files(owner: str, repo: str, number: int, token: str) -> list:
+    """分页获取 PR 变更文件列表（含 patch 字段）"""
+    all_files = []
+    for page in range(1, MAX_FILES_PAGES + 1):
+        data = api_get(
+            f"/repos/{owner}/{repo}/pulls/{number}/files?per_page={PER_PAGE}&page={page}",
+            token,
+        )
+        if not data:
+            break
+        all_files.extend(data)
+        if len(data) < PER_PAGE:
+            break
+    for f in all_files:
+        normalize_patch(f)
+    return all_files
+
+
+def truncate_patch(files: list) -> tuple:
+    """截断超大 patch，返回 (处理后的文件列表, 是否发生截断)"""
+    truncated = False
+    total = 0
+    for f in files:
+        patch = f.get("patch")
+        if not patch:
+            continue
+        total += len(patch)
+        if len(patch) > MAX_PATCH_CHARS or total > MAX_TOTAL_PATCH_CHARS:
+            keep = min(len(patch), max(0, MAX_PATCH_CHARS), max(0, MAX_TOTAL_PATCH_CHARS - total + len(patch)))
+            if keep < len(patch):
+                f["patch"] = patch[:keep] + "\n... [diff 已截断]"
+                truncated = True
+    return files, truncated
+
+
+def render_markdown(pr: dict, files: list, truncated: bool) -> str:
+    """渲染可读摘要 markdown"""
+    lines = []
+    lines.append(f"# PR #{pr.get('number', '?')}: {pr.get('title', '(无标题)')}")
+    lines.append("")
+    lines.append(f"- **状态**: {pr.get('state', 'unknown')}")
+    lines.append(f"- **作者**: {(pr.get('user') or {}).get('login', 'unknown')}")
+    lines.append(f"- **创建时间**: {pr.get('created_at', '')}")
+    lines.append(f"- **分支**: {pr.get('head', {}).get('ref', '')} → {pr.get('base', {}).get('ref', '')}")
+    lines.append(f"- **变更文件数**: {len(files)}")
+    if truncated:
+        lines.append("- **⚠️ 注意**: diff 过大已截断，变更文件列表完整保留")
+    lines.append("")
+
+    body = (pr.get("body") or "").strip()
+    if body:
+        lines.append("## PR 描述")
+        lines.append("")
+        lines.append(body[:5000])
+        lines.append("")
+
+    lines.append("## 变更文件")
+    lines.append("")
+    lines.append("| 文件 | 变更 | +行 | -行 |")
+    lines.append("|------|------|-----|-----|")
+    for f in files:
+        name = f.get("filename", "?")
+        status = f.get("status", "?")
+        add = f.get("additions", 0)
+        dele = f.get("deletions", 0)
+        lines.append(f"| `{name}` | {status} | +{add} | -{dele} |")
+    lines.append("")
+
+    lines.append("## Diff")
+    lines.append("")
+    for f in files:
+        patch = f.get("patch")
+        lines.append(f"### `{f.get('filename', '?')}`")
+        lines.append("")
+        if patch:
+            lines.append(f"```diff\n{patch}\n```")
+        else:
+            lines.append("（无 patch 内容：二进制文件或 diff 不可用）")
+        lines.append("")
+
+    return "\n".join(lines)
+
+
+def main() -> int:
+    try:
+        args = json.loads(sys.argv[1]) if len(sys.argv) > 1 else {}
+    except json.JSONDecodeError as e:
+        print(json.dumps({"ok": False, "error": f"参数 JSON 解析失败: {e}"}, ensure_ascii=False))
+        return 1
+
+    pr_url = args.get("prUrl", "")
+    output_dir = args.get("outputDir", "")
+    token = args.get("token", "")
+
+    if not pr_url or not output_dir:
+        print(json.dumps({"ok": False, "error": "prUrl 与 outputDir 为必填参数"}, ensure_ascii=False))
+        return 1
+
+    try:
+        owner, repo, number = parse_pr_url(pr_url)
+    except ValueError as e:
+        print(json.dumps({"ok": False, "error": str(e)}, ensure_ascii=False))
+        return 1
+
+    pr_dir = Path(output_dir) / "pr-info"
+    md_path = pr_dir / f"{repo}-{number}.md"
+    json_path = pr_dir / f"{repo}-{number}.json"
+
+    # 幂等：已有材料直接复用
+    if md_path.exists():
+        print(json.dumps({"ok": True, "cached": True, "mdPath": str(md_path)}, ensure_ascii=False))
+        return 0
+
+    try:
+        pr = api_get(f"/repos/{owner}/{repo}/pulls/{number}", token)
+        files = fetch_pr_files(owner, repo, number, token)
+    except ValueError as e:
+        print(json.dumps({"ok": False, "error": str(e), "prUrl": pr_url}, ensure_ascii=False))
+        return 1
+
+    files, truncated = truncate_patch(files)
+
+    pr_dir.mkdir(parents=True, exist_ok=True)
+    json_path.write_text(
+        json.dumps({"pr": pr, "files": files}, ensure_ascii=False, indent=2), encoding="utf-8"
+    )
+    md_path.write_text(render_markdown(pr, files, truncated), encoding="utf-8")
+
+    print(json.dumps({
+        "ok": True,
+        "cached": False,
+        "mdPath": str(md_path),
+        "jsonPath": str(json_path),
+        "filesCount": len(files),
+        "truncated": truncated,
+    }, ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -0,0 +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 并行执行；评分作为独立扣分项作用于总分 |

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

@@ -0,0 +1,96 @@
+# {repoName} 已知问题检视报告
+
+## 一、检视概览
+
+| 字段 | 内容 |
+|------|------|
+| **仓库名称** | {repoName} |
+| **鸿蒙化仓库** | {ohosRepoUrl} |
+| **上游原库** | {upstreamRepoUrl}（可选） |
+| **检视时间** | {时间} |
+| **知识库规则总数** | {N} 条 |
+| **适用规则数** | {M} 条 |
+| **命中规则数** | {K} 条 |
+| **评分** | {score} / 100（命中 {K} 条 → 100 − 30×{K}） |
+
+> ⚠️ **数据置信度说明**（如适用）：本次检视时知识库中 {X} 条规则的状态字段均为 `draft`（未经人工验证）。按 SKILL 核心定位原则 #3「只消费 active 状态规则」，draft 规则原则上不参与检视。但若全部跳过将导致 Phase 2/3（预筛与逐条检视）这一关键环节被架空，与任务「不可跳过或合并关键环节」的要求冲突。故本次仍按预筛特征对 draft 规则执行完整检视，**所有结论标注为「参考级」，待规则转为 active 后复核生效**。
+
+---
+
+## 二、规则命中清单
+
+### 适用规则判定结果
+
+| 规则编号 | 规则名 | 严重级别 | 判定 | 命中检查点 | 参考案例 |
+|----------|--------|----------|------|------------|----------|
+| R-XX | {规则名} | {high/medium/low} | 命中/通过/疑似 | {检查点描述} | [KI-XXX](#r-xx) |
+| ... | ... | ... | ... | ... | ... |
+
+### 不适用规则清单（预筛未命中，跳过）
+
+| 规则编号 | 规则名 | 不适用原因 |
+|----------|--------|------------|
+| R-XX | {规则名} | {具体原因} |
+| ... | ... | ... |
+
+---
+
+## 三、命中问题详情
+
+<a id="r-xx"></a>
+
+### R-XX {规则名}（严重级别：{high/medium/low}）
+
+- **参考案例**：[KI-XXX {库名} {现象}]({案例文件相对路径})
+- **问题本质**：{问题本质}
+
+#### 命中检查点
+
+| 检查点 | 判定 | 说明 |
+|--------|------|------|
+| 1. {检查点描述} | **命中** | {证据说明} |
+| 2. {检查点描述} | 通过 | {说明} |
+| ... | ... | ... |
+
+#### 错误特征（源码位置）
+
+**{缺陷描述}**：
+```cpp
+// {文件路径}:{行号}
+{错误代码片段，用 // ← 标注缺陷点}
+```
+
+#### 修复指引（正确特征）
+
+按 {案例编号} 案例的正确代码，{修复方案描述}：
+
+```cpp
+// {文件路径}
+{正确代码片段，用 ①②③ 标注修复步骤}
+```
+
+#### 风险评估
+
+- {风险描述：影响场景、严重程度}
+- **缓解因素**：{如有}
+- 建议优先级：{高/中/低}
+
+---
+
+## 四、通过规则简要说明
+
+| 规则 | 通过依据 |
+|------|----------|
+| R-XX | {通过理由，含源码证据} |
+| ... | ... |
+
+---
+
+## 五、检视结论
+
+1. **命中 {K} 条 {级别} 已知问题（R-XX）**：{总结命中问题及影响}
+2. **其余 {M-K} 条适用规则全部通过**：{总结通过情况}
+3. **{N-M} 条规则预筛不适用**：{总结不适用原因}
+4. **评分 {score}/100**：{评分说明}。建议 {修复建议} 后复检可恢复至 {目标分}。
+
+> ⚠️ 如适用：因知识库规则当前均为 `draft` 状态，本报告所有判定为「参考级」，待规则经人工验证转为 `active` 后正式生效。

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

@@ -0,0 +1,58 @@
+# 已知问题检视合规检查清单
+
+> 检视流程完成后，对照此清单进行自检，确保检视质量。
+
+---
+
+## 1. 输入检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 1.1 | 知识库 INDEX.md 存在 | `{knowledgeDir}/INDEX.md` 可读取 |
+| 1.2 | 鸿蒙化源码目录存在 | `{outputDir}/source/ohos/` 非空 |
+| 1.3 | 接口规格说明存在 | `{outputDir}/接口规格说明.md` 可读取 |
+| 1.4 | 上游原库代码存在 | `{outputDir}/source/RN/` 非空（可选） |
+
+---
+
+## 2. 预筛检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 2.1 | 已读取所有规则文件 | 覆盖 INDEX.md 列出的全部规则 |
+| 2.2 | 适用规则有明确判定依据 | 每条规则记录「适用/不适用」及原因 |
+| 2.3 | 预筛特征准确 | 依赖/文件/API/能力四维度至少使用两个维度 |
+| 2.4 | 不适用规则记录原因 | 不适用原因具体化，非模板化描述 |
+
+---
+
+## 3. 检视检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 3.1 | 每条适用规则已逐条检查 | 所有检查点已给出判定 |
+| 3.2 | 命中问题有证据 | 文件路径 + 行号 + 代码片段 |
+| 3.3 | 命中问题引用案例 | 至少引用一个案例作为修复指引 |
+| 3.4 | 通过规则有通过依据 | 简要说明通过的理由 |
+| 3.5 | 疑似命中已标注 | 标注"需人工复核" |
+
+---
+
+## 4. 评分检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 4.1 | 评分公式正确 | `max(0, 100 - 30 × 命中规则数)` |
+| 4.2 | 不适用规则不计入分母 | 评分基于「适用规则」计算 |
+| 4.3 | 无适用规则时评分 100 | 标注"无适用规则" |
+
+---
+
+## 5. 报告检查
+
+| # | 检查项 | 通过条件 |
+|---|--------|----------|
+| 5.1 | 报告包含五部分 | 检视概览、规则命中清单、命中问题详情、通过规则说明、检视结论 |
+| 5.2 | 不适用规则清单完整 | 列出所有不适用规则及原因 |
+| 5.3 | 命中问题详情有修复指引 | 含正确特征描述或修复方案 |
+| 5.4 | 报告路径正确 | 生成到 `{outputDir}/已知问题检视报告.md` |