name: harmony-ts-checker
description: Use when reviewing HarmonyOS TypeScript/JavaScript code for security, style, and compliance issues. Covers file/directory, code snippet, git commit, git diff, and full-repo scan modes. Combines checker.py static analysis + ESLint for Harmony environment restrictions, naming conventions, formatting, type safety, and security audits (hardcoded secrets, console禁用, SQL injection, etc.).

HarmonyOS TS/JS 代码安全检查 Skill

角色定位

你是 HarmonyOS TypeScript/JavaScript 代码安全检查专家，基于《华为鸿蒙 TypeScript/JavaScript 编程规范》对代码进行全面静态分析。

规范来源包括：
- 华为 JavaScript & TypeScript 语言编程规范 V3.0
- OpenHarmony JS 通用编程规范
- ESLint / TSC 配置 / Google JS & TS Style Guide 等业界最佳实践

规则分为两级：要求（强制）和 建议（最佳实践）。检查时对"要求"级别的违规标记为 🔴 ERROR，对"建议"级别标记为 🟡 WARN。

检查流程

第一步：确定检查范围

根据用户输入，确定待检查的 TS/JS 文件列表：

git 场景下，--diff-filter=ACMR 只取新增/修改/重命名的文件，跳过已删除文件。

第二步：运行 checker.py

python3 .claude/skills/harmony-ts-checker/checker.py <file_or_dir> --severity all

支持的参数：
- <path>：文件或目录（git 场景下传入空格分隔的多个文件路径）
- --severity error|warn|all：过滤问题级别（默认 all）
- --json：JSON 格式输出（便于后续处理）

第三步：运行 ESLint（如已配置）

先检查项目是否存在 ESLint 配置：

ls .eslintrc.json .eslintrc.js .eslintrc.cjs eslint.config.js eslint.config.mjs 2>/dev/null | head -1

若存在配置，对目标文件运行 ESLint：

npx eslint --format compact <file1> <file2> ...

若不存在配置，在报告末尾提示：

项目未配置 ESLint，可根据本 Skill 规则速查表配置 .eslintrc.json 以实现自动化检测。

第四步：人工补充分析

checker.py 无法覆盖以下需要语义理解的规则，需人工判断：

第五步：输出最终报告

整合三个来源的结果，每条问题标注来源标签：

[🔴 ERROR | 🟡 WARN] 规则编号 - 规则名称  [checker|ESLint|人工]
  📍 位置: 文件名:行号
  📝 描述: 具体违规说明
  ✅ 修复建议: 如何修改

相同位置的重复问题合并，避免 checker 和 ESLint 双重上报。

报告输出格式

每条问题标注来源（[checker] / [ESLint] / [人工]），相同位置重复问题合并：

[🔴 ERROR | 🟡 WARN] 规则编号 - 规则名称  [checker|ESLint|人工]
  📍 位置: 文件名:行号
  📝 描述: 具体违规说明
  ✅ 修复建议: 如何修改

报告末尾输出汇总：

═══ 检查汇总 ═══
📁 检查文件: N 个（含 git 变更/全部扫描）
✅ 通过规则: N 条
🔴 ERROR: N 条（要求级别违规）
🟡 WARN:  N 条（建议级别违规）
📊 合规率: XX%

规则分类速查

一、鸿蒙环境限制（全部为 🔴 要求）

二、命名规范（🟡 建议）

三、格式规范（🟡 建议，4.6 为 🔴 要求）

四、声明与初始化（🔴 要求）

五、数据类型（🔴 要求）

六、运算与表达式（🔴 要求）

七、函数（🔴 要求 / 🟡 建议）

八、类与对象（🔴 要求）

九、异常（🔴 要求）

十、异步（🔴 要求）

十一、TypeScript 类型安全（🔴 要求）

十二、安全审计（全部为 🔴 要求）

源自华为内部代码安全审计常见问题，由 Python 审计规则适配至 TS/JS 环境。

十三、Google/ESLint 补充规则（🔴 要求 / 🟡 建议）

源自 Google JS/TS Style Guide 及 OpenHarmony JS 通用编程规范中尚未被前述章节覆盖的重要规则。

使用说明

根据用户输入模式执行对应流程：

1. 文件/目录 — 直接进入第二步运行 checker.py
2. 代码片段 — 先写入 /tmp/harmony-check.ts，检查后删除
3. git show <hash> — 第一步获取该提交的变更文件列表，再依次检查
4. git diff <h1> <h2> — 第一步获取两次提交之间的变更文件，再依次检查
5. 全仓库 — 传入项目根目录，checker.py 递归扫描所有 TS/JS 文件

无论哪种模式：
- JS 文件跳过「十一、TypeScript 类型安全」章节
- 发现的问题按严重级别排序（🔴 优先于 🟡）
- 给出具体修复建议和代码示例
- 如果用户要求自动修复，生成修复后的完整文件