@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/rn-library-memory-leak-check/references/HARMONY_CODE_PATTERNS.md

@@ -0,0 +1,122 @@
+# 鸿蒙化代码特征识别模式
+
+> 本文档详细列出 Phase 0 中用于识别 RN 三方库鸿蒙化实现代码的特征模式，包括 RN JS 三方库判定、ArkTS/ETS 层特征、C++ Native 层特征及常见目录结构。
+
+---
+
+## 1. RN JS 三方库判定
+
+扫描源码 ts、js 和 tsx 文件，识别是否**不包含**以下 RN 鸿蒙化特征。若不包含，则判定为 **RNJS 三方库**，不进行后续内存泄露检视，直接输出报告评分 0 分，标注"RNJS 三方库"。
+
+**ts、js 和 tsx 文件代码特征**：
+
+```typescript
+// 特征 1：TurboModule 模块导入
+import { TurboModuleRegistry } from 'react-native';
+TurboModuleRegistry.getEnforcing<Spec>('Xxx');
+
+// 特征 2：NativeModules 模块导入
+import { NativeModules } from 'react-native';
+NativeModules.xxxTurboModule;
+
+// 特征 3：Native Component 组件导入
+import codegenNativeComponent from 'xxxx'
+codegenNativeComponent<NativeProps>(
+  'Xxxx'
+) as HostComponent<NativeProps>;
+```
+
+---
+
+## 2. ArkTS/ETS 代码特征
+
+```typescript
+// 特征 1：@ohos 模块导入
+import ble from '@ohos.bluetooth';
+import geoLocationManager from '@ohos.geoLocationManager';
+
+// 特征 2：RN TurboModule 鸿蒙实现
+class XxxTurboModule extends TurboModule {
+  // ...
+}
+
+// 特征 3：RN NativeComponent 鸿蒙实现
+@Component
+export struct RNCWebView {
+    // ...
+}
+
+// 特征 4：RN Bridge 事件机制
+this.eventEmitter = new NativeEventEmitter(xxxNativeModule);
+this.deviceEventEmitter.addListener('xxx', callback);
+
+// 特征 5：.ets 文件扩展名
+*.ets  // ArkTS 文件
+```
+
+---
+
+## 3. C++ Native 代码特征
+
+```cpp
+// 特征 1：包括但不仅限于以下头文件
+#include  "RNOH/CppComponentInstance.h" // 关键 RN 组件头文件
+#include <napi/native_api.h>
+#include <ReactCommon/TurboModule.h>
+
+// 特征 2：含有 CppComponentInstance
+class XxxxxxComponentInstance
+    : public CppComponentInstance<> {
+}
+
+// 特征 3：TurboModule/JSI 特征
+class XxxTurboModule : public TurboModule {
+  // JSI HostFunction / HostObject
+};
+
+// 特征 4：NAPI 函数调用
+napi_create_reference(env, value, 1, &ref);
+napi_wrap(env, jsThis, nativePtr, finalizeCb, nullptr, &ref);
+```
+
+---
+
+## 4. 常见鸿蒙化目录结构
+
+> ⚠️ 目录名称仅供参考，**不作为唯一判定依据**。必须通过代码特征交叉验证。
+
+```
+常见目录名称：
+├── harmony/                    # 最常见
+├── ohos/                       # 部分库使用
+├── harmonyos/                  # 部分库使用
+├── example/                    # 示例代码 ❌ 不检视
+├── android/                    # Android 实现 ❌ 不检视
+├── ios/                        # iOS 实现 ❌ 不检视
+├── js/                         # RN JS 层 ❌ 不检视
+```
+
+---
+
+## 5. 判定规则
+
+| 条件 | 判定结果 |
+|------|----------|
+| 扫描到 `@ohos` 模块导入、TurboModule/JSI 实现或 NAPI 函数调用 | 确认鸿蒙化实现，进入 Phase 1 |
+| 存在 `.ets` 文件且包含鸿蒙 API 调用或 RN 组件实现 | 确认鸿蒙化实现，进入 Phase 1 |
+| 扫描整个源码均未发现鸿蒙代码特征 | 报告评分 0 分，标注"未实现鸿蒙化" |
+| 源码不包含 TurboModuleRegistry/NativeModules/codegenNativeComponent 特征 | 判定为 RNJS 三方库，评分 0 分 |
+
+---
+
+## 6. RN 鸿蒙化架构关键差异
+
+> 与 Flutter 对比，理解 RN 鸿蒙化的核心架构概念。
+
+| 概念 | Flutter | React Native |
+|------|---------|-------------|
+| 插件注册 | FlutterPlugin | TurboModule / NativeModule |
+| 通信机制 | MethodChannel | Bridge / JSI / TurboModule |
+| UI 组件 | Flutter Widget | NativeComponent（ViewManager） |
+| 事件系统 | EventChannel | NativeEventEmitter / RCTEventEmitter |
+| 生命周期 | onAttached/DetachedFromEngine | constructor/__onDestroy__（TurboModule）/ aboutToAppear/aboutToDisappear（NativeComponent） |

package/vendor/Server/Skills/rn-library-memory-leak-check/scripts/scan_harmony_code.py

@@ -0,0 +1,279 @@
+#!/usr/bin/env python3
+"""
+ * Copyright (C) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an 'AS IS' BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+"""
+# @tool scan-harmony-code
+# @description 扫描 RN 三方库源码，识别鸿蒙化实现代码特征（ArkTS/ETS + C++ NAPI），输出文件列表和特征匹配结果
+# @param sourceDir: string - 源码根目录路径（通常为 {outputDir}/source）
+
+"""
+Harmony Code Scanner Script
+扫描 RN 三方库源码，识别鸿蒙化实现代码特征。
+跨平台实现（仅依赖 Python 标准库），支持 Windows/macOS/Linux。
+"""
+
+import sys
+import os
+import re
+import json
+from pathlib import Path
+from typing import List, Set, Dict, Tuple
+
+
+# ─── 扫描配置 ───
+
+ARKTS_EXTENSIONS = {'.ets', '.ts'}
+JS_EXTENSIONS = {'.ts', '.js', '.tsx'}
+CPP_EXTENSIONS = {'.cpp', '.c', '.h', '.hpp'}
+HARMONY_DIRS = {'harmony', 'ohos', 'harmonyos'}
+
+# RN JS 三方库特征（检测这些以确认是 RN 鸿蒙化库而非纯 JS 库）
+RN_JS_PATTERNS = [
+    re.compile(r'TurboModuleRegistry', re.IGNORECASE),
+    re.compile(r'NativeModules', re.IGNORECASE),
+    re.compile(r'codegenNativeComponent', re.IGNORECASE),
+]
+
+# ArkTS/ETS 层特征
+OHOS_IMPORT_PATTERN = re.compile(r'@ohos\.')
+TURBOMODULE_ARKTS_PATTERN = re.compile(r'extends\s+TurboModule|class\s+\w+TurboModule')
+NATIVE_COMPONENT_PATTERN = re.compile(r'@Component|export\s+struct\s+RN')
+EVENT_EMITTER_PATTERN = re.compile(r'NativeEventEmitter|DeviceEventEmitter|RCTEventEmitter')
+
+# C++ Native 层特征
+NAPI_CPP_PATTERN = re.compile(r'napi_|TurboModule|JSI|HostFunction|CppComponentInstance')
+NAPI_REF_PATTERN = re.compile(r'napi_create_reference|napi_wrap|napi_delete_reference|napi_open_handle_scope')
+
+MAX_LIST_FILES = 20
+
+
+# ─── 工具函数 ───
+
+def parse_args() -> str:
+    """解析命令行参数，支持 MCP Gateway JSON 字符串和直接 CLI 两种方式。"""
+    if len(sys.argv) > 1:
+        arg = sys.argv[1]
+        if arg.startswith('{'):
+            try:
+                data = json.loads(arg)
+                return data.get('sourceDir', '')
+            except (json.JSONDecodeError, AttributeError):
+                pass
+        return arg
+    return ''
+
+
+def find_files(root: Path, extensions: Set[str], max_results: int = 0) -> List[Path]:
+    """递归查找指定扩展名的文件，跨平台实现。"""
+    results = []
+    for dirpath, dirnames, filenames in os.walk(root):
+        for filename in filenames:
+            ext = os.path.splitext(filename)[1].lower()
+            if ext in extensions:
+                results.append(Path(dirpath) / filename)
+                if max_results and len(results) >= max_results:
+                    return results
+    return results
+
+
+def find_dirs(root: Path, target_names: Set[str], max_results: int = 5) -> List[Path]:
+    """查找指定名称的目录。"""
+    results = []
+    for dirpath, dirnames, _ in os.walk(root):
+        for dirname in dirnames:
+            if dirname in target_names:
+                results.append(Path(dirpath) / dirname)
+                if len(results) >= max_results:
+                    return results
+    return results
+
+
+def grep_files(files: List[Path], patterns: List[re.Pattern]) -> List[Path]:
+    """在文件列表中搜索正则模式，返回匹配的文件路径。"""
+    matched = []
+    for filepath in files:
+        try:
+            with open(filepath, 'r', encoding='utf-8', errors='ignore') as f:
+                content = f.read()
+            for pattern in patterns:
+                if pattern.search(content):
+                    matched.append(filepath)
+                    break
+        except (OSError, PermissionError):
+            continue
+    return matched
+
+
+def grep_dir(root: Path, extensions: Set[str], patterns: List[re.Pattern], max_results: int = MAX_LIST_FILES) -> List[Path]:
+    """在目录中搜索指定扩展名文件中的正则模式，返回匹配的文件路径。"""
+    files = find_files(root, extensions)
+    matched = grep_files(files, patterns)
+    return matched[:max_results] if max_results else matched
+
+
+def format_paths(paths: List[Path], indent: str = '    ') -> str:
+    """格式化路径列表为缩进行。"""
+    return '\n'.join(f'{indent}{p}' for p in paths) if paths else ''
+
+
+# ─── 扫描阶段 ───
+
+def scan_rn_js_features(source_dir: Path) -> Tuple[List[Path], bool]:
+    """阶段 1：RN JS 三方库特征检测。"""
+    print('--- 1. RN JS 三方库特征检测 ---')
+    matched = grep_dir(source_dir, JS_EXTENSIONS, RN_JS_PATTERNS, max_results=5)
+    if not matched:
+        print('  ⚠️ 未检测到 TurboModuleRegistry/NativeModules/codegenNativeComponent')
+        print('  → 可能是 RNJS 三方库，无需鸿蒙化内存泄露检视')
+    else:
+        print('  ✅ 检测到 RN 鸿蒙化特征文件:')
+        print(format_paths(matched))
+    print()
+    return matched, bool(matched)
+
+
+def scan_arkts_layer(source_dir: Path) -> Dict[str, int]:
+    """阶段 2：ArkTS/ETS 层特征扫描。"""
+    print('--- 2. ArkTS/ETS 层特征扫描 ---')
+
+    ets_files = find_files(source_dir, {'.ets'})
+    ets_count = len(ets_files)
+    print(f'  .ets 文件数: {ets_count}')
+
+    ohos_files = grep_dir(source_dir, ARKTS_EXTENSIONS, [OHOS_IMPORT_PATTERN])
+    ohos_count = len(ohos_files)
+    print(f'  @ohos 模块导入文件数: {ohos_count}')
+
+    turbomodule_files = grep_dir(source_dir, ARKTS_EXTENSIONS, [TURBOMODULE_ARKTS_PATTERN])
+    turbomodule_count = len(turbomodule_files)
+    print(f'  TurboModule 鸿蒙实现文件数: {turbomodule_count}')
+
+    native_component_files = grep_dir(source_dir, {'.ets'}, [NATIVE_COMPONENT_PATTERN])
+    native_component_count = len(native_component_files)
+    print(f'  NativeComponent 鸿蒙实现文件数: {native_component_count}')
+
+    event_emitter_files = grep_dir(source_dir, ARKTS_EXTENSIONS, [EVENT_EMITTER_PATTERN])
+    event_emitter_count = len(event_emitter_files)
+    print(f'  Bridge 事件机制文件数: {event_emitter_count}')
+
+    print()
+    return {
+        'ets_count': ets_count,
+        'ohos_count': ohos_count,
+        'turbomodule_count': turbomodule_count,
+        'native_component_count': native_component_count,
+        'event_emitter_count': event_emitter_count,
+    }
+
+
+def scan_cpp_layer(source_dir: Path) -> Dict[str, int]:
+    """阶段 3：C/C++ NAPI 绑定层特征扫描。"""
+    print('--- 3. C/C++ NAPI 绑定层特征扫描 ---')
+
+    cpp_files = find_files(source_dir, CPP_EXTENSIONS)
+    cpp_count = len(cpp_files)
+    print(f'  C/C++ 文件数: {cpp_count}')
+
+    napi_files = grep_dir(source_dir, CPP_EXTENSIONS, [NAPI_CPP_PATTERN])
+    napi_count = len(napi_files)
+    print(f'  NAPI/TurboModule/JSI 特征文件数: {napi_count}')
+
+    napi_ref_files = grep_dir(source_dir, CPP_EXTENSIONS, [NAPI_REF_PATTERN])
+    napi_ref_count = len(napi_ref_files)
+    print(f'  NAPI 引用管理文件数: {napi_ref_count}')
+
+    print()
+    return {
+        'cpp_count': cpp_count,
+        'napi_count': napi_count,
+        'napi_ref_count': napi_ref_count,
+    }
+
+
+def scan_harmony_dirs(source_dir: Path) -> List[Path]:
+    """阶段 4：鸿蒙化目录检测。"""
+    print('--- 4. 鸿蒙化目录检测 ---')
+    found_dirs = []
+    for dir_name in sorted(HARMONY_DIRS):
+        found = find_dirs(source_dir, {dir_name}, max_results=5)
+        if found:
+            print(f'  ✅ 发现目录: {dir_name}')
+            print(format_paths(found))
+            found_dirs.extend(found)
+    print()
+    return found_dirs
+
+
+def print_summary(
+    arkts: Dict[str, int],
+    cpp: Dict[str, int],
+    rn_js_detected: bool,
+) -> None:
+    """阶段 5：汇总判定。"""
+    print('=== 扫描结果汇总 ===')
+
+    has_harmony = (
+        arkts['ets_count'] > 0
+        or arkts['ohos_count'] > 0
+        or arkts['turbomodule_count'] > 0
+        or cpp['napi_count'] > 0
+    )
+
+    if has_harmony:
+        print('  ✅ 确认鸿蒙化实现，建议进入 Phase 1 内存泄露检视')
+        print(f'  ArkTS/ETS 层文件数: {arkts["ets_count"]}')
+        print(f'  C/C++ 层文件数: {cpp["cpp_count"]}')
+        print('  特征匹配:')
+        print(f'    @ohos 导入: {arkts["ohos_count"]}')
+        print(f'    TurboModule 实现: {arkts["turbomodule_count"]}')
+        print(f'    NativeComponent: {arkts["native_component_count"]}')
+        print(f'    Bridge 事件: {arkts["event_emitter_count"]}')
+        print(f'    NAPI/JSI: {cpp["napi_count"]}')
+        print(f'    NAPI 引用管理: {cpp["napi_ref_count"]}')
+    elif not rn_js_detected:
+        print('  ⚠️ 未检测到 RN 鸿蒙化特征，可能为 RNJS 三方库')
+        print("  → 建议评分 0 分，标注 'RNJS 三方库'")
+    else:
+        print('  ⚠️ 未发现鸿蒙化代码特征')
+        print("  → 建议评分 0 分，标注 '未实现鸿蒙化'")
+
+
+# ─── 主入口 ───
+
+def main() -> None:
+    source_dir_str = parse_args()
+
+    if not source_dir_str:
+        print('Usage: scan_harmony_code.py <sourceDir>')
+        print('Error: sourceDir parameter is required')
+        sys.exit(1)
+
+    source_dir = Path(source_dir_str)
+    if not source_dir.is_dir():
+        print(f'Error: Directory does not exist: {source_dir_str}')
+        sys.exit(1)
+
+    print('=== 鸿蒙化代码特征扫描 ===')
+    print(f'源码目录: {source_dir_str}')
+    print()
+
+    rn_js_matched, rn_js_detected = scan_rn_js_features(source_dir)
+    arkts = scan_arkts_layer(source_dir)
+    cpp = scan_cpp_layer(source_dir)
+    scan_harmony_dirs(source_dir)
+    print_summary(arkts, cpp, rn_js_detected)
+
+
+if __name__ == '__main__':
+    main()

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

@@ -0,0 +1,273 @@
+---
+name: rn-library-stability-check
+description: 对 RN 三方库鸿蒙化代码进行稳定性检视，聚焦 ArkTS/ETS 和 C++ 代码，分析异常处理、资源释放、并发安全、生命周期管理、NAPI 跨语言调用、调用链完整性等维度，生成严苛评分报告（0-100分）。作为 RN 仓库检视流程的第二阶段，依赖 rn-library-interface-analyzer 的输出。使用场景：RN 三方库鸿蒙化稳定性评估、稳定性问题发现、代码质量改进。
+license: Apache-2.0
+compatibility: 需要访问源码目录、分析 ArkTS/ETS 和 C++ 源码，可选调用 MCP 脚本工具辅助代码扫描
+metadata:
+  version: "1.0.0"
+  category: rn-library-check
+---
+
+# RNLibraryStabilityCheckSkill
+
+对 RN 三方库的**鸿蒙化实现代码**进行稳定性检视，评估库在异常情况下的处理能力、资源管理安全性、并发处理可靠性、跨语言调用安全性等关键稳定性指标。
+
+> ⚠️ **核心定位**：本 SKILL **仅检视鸿蒙化实现代码**，通过智能扫描识别代码范围（`*.ets`、NAPI C++、`module.json5`、`@ohos.*` API、TurboModule 桥接），而非依赖固定目录名称。
+
+---
+
+## 任务参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `repoUrl` | string | ✅ | 鸿蒙化仓库地址（ohosRepoUrl） |
+| `outputDir` | string | ✅ | 输出目录绝对路径 |
+| `interfaceDocPath` | string | ✅ | 接口规格说明文档路径 |
+| `repoName` | string | ✅ | 仓库名称 |
+
+---
+
+## 输入依赖
+
+- **前置 SKILL**: `rn-library-interface-analyzer`
+- **输入文件**: `接口规格说明.md`（位于 outputDir）
+- **仓库源码**: 已克隆到 `{outputDir}/source/`
+
+---
+
+## 工作流程概览
+
+```
+Phase 1: 鸿蒙代码智能定位与范围识别
+    ↓
+Phase 2: ArkTS 层稳定性分析（异常处理 + 资源释放 + 并发安全 + 生命周期）
+    ↓
+Phase 3: C++ Native 层稳定性分析（NAPI 跨语言 + 内存管理）
+    ↓
+Phase 4: 调用链完整性分析（跨层级异常传播追踪）
+    ↓
+Phase 5: 严苛评分计算（维度扣分 + 归零规则）
+    ↓
+Phase 6: 报告生成
+```
+
+---
+
+## Phase 1：鸿蒙代码智能定位与范围识别
+
+**通过多维度特征扫描**，智能识别鸿蒙化代码，而非依赖固定目录名称。
+
+### 1.1 扫描策略（优先级递减）
+
+| 扫描维度 | 特征模式 | 权重 | 说明 |
+|----------|----------|------|------|
+| **文件类型** | `*.ets` 文件 | ⭐⭐⭐ 高 | ArkTS/ETS 是鸿蒙化最强特征 |
+| **配置文件** | `module.json5`、`oh-package.json5` | ⭐⭐⭐ 高 | 鸿蒙特有模块配置 |
+| **API 调用** | `@ohos.*`、`napi_*`、`import from '@ohos'` | ⭐⭐ 中 | 鸿蒙 API 特征 |
+| **RN 桥接** | TurboModule、NativeModule 注册代码 | ⭐⭐ 中 | RN 鸿蒙化关键桥接层 |
+| **C++ NAPI** | `napi_create_reference`、`napi_value` 等 | ⭐⭐ 中 | Native 层鸿蒙绑定 |
+| **目录标识** | 目录名包含 `ohos`、`harmony`、`openharmony` | ⭐ 低 | 辅助参考 |
+
+### 1.2 扫描执行
+
+可使用辅助脚本 `scripts/scan-harmony-code.py` 自动执行扫描，传入 `sourceDir` 参数：
+
+```bash
+python3 scripts/scan-harmony-code.py '{"sourceDir": "{outputDir}/source"}'
+```
+
+脚本输出各维度文件列表和分类统计，辅助判定检视范围。
+
+### 1.3 判定规则
+
+| 扫描结果 | 判定 | 评分 | 后续操作 |
+|----------|------|------|----------|
+| 发现 `.ets` 文件 | ✅ 存在鸿蒙化 | 正常评分 | 进入 Phase 2 |
+| 发现 `module.json5` + NAPI 代码 | ✅ 存在鸿蒙化 | 正常评分 | 进入 Phase 2 |
+| 仅发现目录名含 `ohos` 但无代码文件 | ⚠️ 疑似未完成 | 0-30 分 | 标注"鸿蒙化代码疑似缺失" |
+| 未发现任何鸿蒙特征 | ❌ 未鸿蒙化 | 0 分 | 标注"未发现鸿蒙化实现代码" |
+| 无法访问源码目录 | ❌ 无法检视 | 0 分 | 标注"源码目录不可访问" |
+
+> **不以固定目录名否定**：即使没有 `ohos/` 目录，只要发现 `.ets` 文件或鸿蒙 API 调用，即判定为存在鸿蒙化。
+
+---
+
+## Phase 2：ArkTS 层稳定性分析
+
+> 完整检查项判定标准与代码示例参见 [references/CHECKLIST.md](references/CHECKLIST.md)
+
+### 2.1 异常处理完整性（基础分 25）
+
+所有 `@ohos` 模块 API 调用和 TurboModule 注册方法必须覆盖异常捕获，关键路径必须包含完整异常处理链。
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| E-01 | 关键 API 调用无 try-catch | **-10** | Critical |
+| E-02 | Promise rejection 未处理 | **-8** | Critical |
+| E-03 | 异常吞没（catch 块为空或仅 console.log） | **-7** | Major |
+| E-04 | 参数验证缺失 | **-5** | Major |
+| E-05 | 异常类型窄化 | **-3** | Minor |
+| E-06 | finally 缺失（资源操作路径） | **-2** | Minor |
+
+### 2.2 资源释放安全性（基础分 20）
+
+鸿蒙系统资源必须在 TurboModule 销毁或组件/Ability 生命周期结束时释放。
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| R-01 | 系统资源未释放（sensor/location/network/bluetooth） | **-10** | Critical |
+| R-02 | 事件订阅未取消（`on()` 无对应 `off()`） | **-8** | Critical |
+| R-03 | Stream/Connection 泄露 | **-5** | Major |
+| R-04 | Timer 未清理 | **-3** | Minor |
+| R-05 | Worker 未终止 | **-3** | Minor |
+
+### 2.3 并发安全（基础分 20）
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| C-01 | 主线程阻塞操作（耗时同步 I/O/大循环） | **-10** | Critical |
+| C-02 | 共享状态无同步保护 | **-7** | Major |
+| C-03 | 回调重入无防护 | **-3** | Minor |
+
+### 2.4 ArkTS 生命周期管理（基础分 10）
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| L-01 | aboutToDisappear/onDestroy 未清理 | **-8** | Critical |
+| L-02 | @State/@Link 对象持有大引用未释放 | **-2** | Minor |
+
+---
+
+## Phase 3：C++ Native 层稳定性分析
+
+> 完整检查项判定标准与代码示例参见 [references/CHECKLIST.md](references/CHECKLIST.md)
+
+### 3.1 NAPI 跨语言调用安全（基础分 15）
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| N-01 | napi_ref 创建/释放不匹配 | **-10** | Critical |
+| N-02 | napi_handle_scope 未清理 | **-8** | Critical |
+| N-03 | napi_value 类型转换无边界检查 | **-5** | Major |
+| N-04 | napi_create_async_work 缺少异常处理 | **-5** | Major |
+| N-05 | Native 对象与 JS 对象生命周期不一致 | **-3** | Minor |
+
+### 3.2 C++ 内存管理安全（基础分 10）
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| M-01 | malloc/new 与 free/delete 不匹配 | **-8** | Critical |
+| M-02 | 异常路径资源未释放 | **-5** | Major |
+| M-03 | 未使用 RAII 管理资源 | **-3** | Minor |
+
+---
+
+## Phase 4：调用链完整性分析
+
+### 4.1 跨层级调用链追踪
+
+追踪关键功能的完整调用链（JS 层 → ArkTS 鸿蒙层 → Native C++ 层），检查异常传播路径和资源释放节点。**必须追踪至少 3 个关键功能**的完整调用链，标注每个节点的异常处理状态。
+
+### 4.2 异常传播链检查（额外扣分，不占基础分）
+
+| # | 检查项 | 扣分 | 严重度 |
+|---|--------|------|--------|
+| CH-01 | ArkTS → Native 异常传播断裂（未通过 `napi_throw` 传播） | **-10** | Critical |
+| CH-02 | 跨模块调用异常未传播 | **-5** | Major |
+| CH-03 | 关键功能调用链缺失异常处理节点 | **-3** | Minor |
+
+---
+
+## Phase 5：严苛评分计算
+
+### 5.1 评分公式
+
+```
+维度得分 = max(0, 基础分 - 该维度累计扣分)
+综合评分 = Σ(各维度得分) - 调用链完整性扣分（CH-01~CH-03）
+```
+
+| 维度 | 基础分 | 检查项范围 |
+|------|--------|------------|
+| 异常处理完整性 | 25 | E-01~E-06 |
+| 资源释放安全性 | 20 | R-01~R-05 |
+| 并发安全 | 20 | C-01~C-03 |
+| ArkTS 生命周期 | 10 | L-01~L-02 |
+| NAPI 跨语言调用 | 15 | N-01~N-05 |
+| C++ 内存管理 | 10 | M-01~M-03 |
+
+### 5.2 归零规则与严重度映射
+
+存在特殊归零规则（如 Critical ≥ 5 个直接评 0 分），以及按扣分值映射的严重度分级（Critical/Major/Minor）。
+
+> 完整归零规则、严重度映射表和评分等级说明参见 [references/SCORING_RULES.md](references/SCORING_RULES.md)
+
+---
+
+## Phase 6：报告生成
+
+在 `{outputDir}` 下生成 `稳定性检视报告.md`，包含：检视概览、综合评分、检视范围、维度明细、调用链分析、问题清单、改进建议。
+
+> 完整报告格式模板参见 [assets/REPORT_TEMPLATE.md](assets/REPORT_TEMPLATE.md)
+
+> **重要**：报告必须包含 `**综合评分：XX/100**` 格式（粗体标记、中文冒号），且评分值位于"二、综合评分"章节，确保可被 `_parseRNLibraryScore` 函数正确解析。评分正则匹配优先级为 `综合评分` > `总体评分/评分` > `得分`。
+
+---
+
+## 输出产物
+
+| 产物 | 文件名 | 说明 |
+|------|--------|------|
+| 稳定性检视报告 | `稳定性检视报告.md` | 评分 + 维度明细 + 调用链 + 问题清单 + 修复建议 |
+
+所有产物写入 `{outputDir}` 目录。
+
+> ⚠️ **输出文件自检**：写入结果文件前，先确认 `稳定性检视报告.md` 已存在且内容完整（**独立文件，禁止只写入 result 执行结果文件**）。若报告内容仅在草稿中，必须先将其保存为上述独立文件。
+
+### 结构化指标输出（必须执行）
+
+执行环境会在任务 prompt 中下发一个**结构化指标文件输出路径**（`stepId{X}_loop{L}_meta_{N}.json`）。
+检视完成后，**必须**将最终评分以下述 JSON 对象写入该路径：
+
+```json
+{
+  "stabilityScore": 85,
+  "scoreReason": "异常处理缺失2处-16等（一句话判定依据，≤50字；触发一票否决时必须注明）"
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `stabilityScore` | number | 稳定性评分（0-100 整数，与报告中 `**综合评分：XX/100**` 的数值一致） |
+| `scoreReason` | string | 评分判定依据摘要（可选，前端悬浮提示展示；0 分时强烈建议写明触发规则，如"Critical≥5 触发归零"） |
+
+**说明**：该文件由执行框架自动收割入库（前端/历史列表直接读取评分，无需解析报告文本）。若 prompt 未下发该路径则跳过本节。
+
+---
+
+## 特殊情况处理
+
+| 情况 | 处理方式 | 评分 |
+|------|----------|------|
+| 未发现 `.ets` 文件和鸿蒙 API 特征 | 报告标注"未发现鸿蒙化实现代码" | 0 分 |
+| 仅发现目录名含 `ohos` 但无代码文件 | 报告标注"鸿蒙化代码疑似缺失" | 0-30 分 |
+| 发现鸿蒙代码但解析失败 | 报告标注"鸿蒙代码解析失败"并说明原因 | 0 分 |
+| Critical 问题 ≥ 5 个 | 报告标注"存在严重稳定性风险" | 0 分 |
+| 扫描到 `.ets` 但不在 `ohos/` 目录 | 正常检视，标注实际路径 | 正常评分 |
+
+---
+
+## 评分权重
+
+本 SKILL 在 RN 仓库检视综合评分中权重为 **25%**。
+
+---
+
+## 参考文档
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 完整检查清单 | [references/CHECKLIST.md](references/CHECKLIST.md) | 所有检查项的判定标准与代码示例 |
+| 评分规则 | [references/SCORING_RULES.md](references/SCORING_RULES.md) | 归零规则、严重度映射、评分等级 |
+| 报告模板 | [assets/REPORT_TEMPLATE.md](assets/REPORT_TEMPLATE.md) | 完整报告格式模板 |
+| 代码扫描脚本 | [scripts/scan-harmony-code.py](scripts/scan-harmony-code.py) | Phase 1 鸿蒙代码智能扫描辅助工具（跨平台） |