菜单
使用 ETS Language Server 对 .ets 文件进行 IDE 级别的实时诊断。通过 LSP 协议获取编译器真实诊断结果（等同于 DevEco Studio 的错误提示）。与静态分析互补，专注于语法和类型错误检测。触发词：LSP 检查、language server 诊断、IDE 诊断、编译器级别检查、ets 实时诊断。支持多文件和目录输入，自动递归查找 .ets 文件，输出错误/警告/信息及汇总统计。PostToolUse Hook 模式下会自动输出错误详情（行号、错误消息）并指示 Claude 自动修复。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
ArkTS 代码审查技能。当用户需要审查 ArkTS/TS 代码、排查编译错误、检查代码规范、诊断编译问题时使用此技能。专注于 Critical 级别语言合规性检查（禁用特性、类型系统、导入导出、ArkUI 装饰器约束、Sendable 并发限制）。生成带修复建议的 Markdown 报告。适用场景：ArkTS 代码审查、编译错误排查、类型系统验证。
根据技术方案、应用需求或安卓代码片段，查找并列出所需的 HarmonyOS ArkTS public API。当用户描述想要实现的功能、需要了解该用哪些 API/Kit/接口时触发，例如："我需要什么API实现…"、"做一个拍照功能需要哪些接口"、"这个需求用哪个Kit"、"技术方案中涉及哪些HarmonyOS能力"、"查一下相机相关的API"、"我要接入地图有哪些接口可以用"。当用户描述应用需求但未明确要求写代码时也应触发，例如："我要做一个IM应用需要音视频通话"——此时应识别所有相关API。当用户携带安卓（Java/Kotlin）代码片段询问 HarmonyOS 对应 API 时也应触发，例如："这段安卓代码在鸿蒙上用什么API实现"、"帮我把这个 Android 功能迁移到鸿蒙，需要哪些接口"——此时应解析安卓代码并映射到对应的 HarmonyOS API。触发关键词：需要哪些API、用什么接口实现、查API、涉及哪些能力、哪些组件、技术方案、API文档、文档路径、鸿蒙迁移、Android迁移、安卓代码，与 ArkTS/HarmonyOS/鸿蒙/ability/UIAbility/ArkUI 或任意 Kit 名称组合出现。当用户明确要求编写或生成 .ets 代码文件时，不触发本 skill。
ArkUI/ArkTS 代码生成与修改约束。以下场景自动触发： 1. 直接涉及 UI 代码：生成组件、写页面、实现功能、ArkUI、build、@Component、@Entry、 @Builder、@Styles、@Extend、@State、@Link、@Prop、鸿蒙、HarmonyOS、ets 文件 2. 修改/编辑 .ets 文件中的任何代码（改逻辑、改条件、改样式、加功能、删功能、重构） 3. 用户提供的文件路径以 .ets 结尾，或代码片段包含 build()、@Component 等 ArkUI 特征 4. 修改红点、角标、Tab、导航、列表项等 UI 相关业务逻辑
Compile a HarmonyOS project using DevEco Studio's built-in hvigor tool. Use when the user wants to build, compile, or package a HarmonyOS/ArkTS project into a HAP. Handles ohpm dependency installation, SDK patch workaround, sync, assembleHap, error classification, and auto-invokes harmony-fix for code errors.
Fix ArkTS compilation errors in a HarmonyOS project. Reads errors from the latest build log, groups them by file, fixes each file in one pass, and re-compiles to verify. Repeats until no progress is made or all errors are resolved. Designed for fully automated use with large error volumes.
Scrape HarmonyOS developer documentation from developer.huawei.com as structured Markdown. Use when the user wants to download, scrape, or archive Huawei HarmonyOS API references, guides, or any documentation from the Huawei developer portal. Also use when the user says 抓取鸿蒙资料, arkts代码生成所需资料, arkts代码审查所需资料, arkts代码静态检查规则, arkts单元测试所需资料, or similar phrases about collecting HarmonyOS/ArkTS documentation. Handles JavaScript-rendered sidebar via Playwright, intercepts internal JSON APIs, converts HTML to Markdown, automatically fixes Markdown syntax errors, and supports selective category scraping, C API exclusion, and resume.
| name | ets-lsp-check |
| description | 使用 ETS Language Server 对 .ets 文件进行 IDE 级别的实时诊断。通过 LSP 协议获取编译器真实诊断结果（等同于 DevEco Studio 的错误提示）。与静态分析互补，专注于语法和类型错误检测。触发词：LSP 检查、language server 诊断、IDE 诊断、编译器级别检查、ets 实时诊断。支持多文件和目录输入，自动递归查找 .ets 文件，输出错误/警告/信息及汇总统计。PostToolUse Hook 模式下会自动输出错误详情（行号、错误消息）并指示 Claude 自动修复。 |
使用 ETS Language Server 对 .ets 文件进行 IDE 级别的实时语法和类型检查。
| 文件大小 | 批处理大小 | 超时/文件 | 说明 |
|---|---|---|---|
| < 10KB | 100 个 | 300ms | 极小文件，大批量 |
| 10-50KB | 50 个 | 500ms | 小文件 |
| 50-200KB | 20 个 | 1000ms | 中等文件 |
| 200-500KB | 1 个 | 5000ms | 大文件，单独处理 |
| > 1MB | 1 个 | 15000ms | 超大文件，警告提示 |
工具会在首次运行时自动检测并安装 ETS Language Server，无需手动安装。
如需手动安装：
npm install -g @arkts/language-server
npm install -g @arkts/language-service
验证安装：
which ets-language-server
export HARMONYOS_SDK_PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony"
本 skill 支持多种输入方式：
.ets 文件路径.ets 文件）.ets 文件scripts/ets-lsp-diagnose.js 进行诊断# 检查单个文件
node scripts/ets-lsp-diagnose.js /path/to/file.ets
# 检查多个文件
node scripts/ets-lsp-diagnose.js file1.ets file2.ets file3.ets
# 检查目录（递归查找 .ets 文件）
node scripts/ets-lsp-diagnose.js /path/to/project/entry/src
# 混合输入
node scripts/ets-lsp-diagnose.js file1.ets /path/to/dir file2.ets
| 变量名 | 说明 | 默认值 |
|---|---|---|
HARMONYOS_SDK_PATH | HarmonyOS SDK 路径 | /Applications/DevEco-Studio.app/Contents/sdk/default/openharmony |
ETS_LSP_COMMAND | LSP 服务器命令 | ets-language-server |
ETS_LSP_BATCH_TIMEOUT | 批量超时时间(ms) | 60000 |
ETS_LSP_INCREMENTAL | 增量检查 true/false | true |
ETS_LSP_SKIP_HUGE | 跳过超大文件 (>1MB) | false |
════════════════════════════════════════════════════════════
ETS Language Server 诊断工具 (智能分组优化版)
════════════════════════════════════════════════════════════
项目根目录: /path/to/project
待检查文件: 82 个
SDK 路径: /Applications/DevEco-Studio.app/Contents/sdk/default/openharmony
增量检查: 启用
智能分组: 启用 (按文件大小动态调整批次)
🚀 初始化 ETS Language Server...
✓ LSP 初始化成功
支持能力: 22 个
📦 [极小文件] 81 个，分 1 批
批次 1/1 (81 文件)...
📦 [小文件] 1 个，分 1 批
批次 1/1 (1 文件)...
✓ 已处理 82 个文件
────────────────────────────────────────────────────────────
📄 JsonUtil.ets
────────────────────────────────────────────────────────────
❌ 错误 (1):
16:27 - No overload matches this call.
⚠️ 警告 (1):
23:5 - Unused variable 'temp'
✓ 81 个文件无错误
════════════════════════════════════════════════════════════
📊 检查结果汇总
════════════════════════════════════════════════════════════
文件总数: 82
有错误: 1
无错误: 81
❌ 错误: 1
⚠️ 警告: 1
ℹ️ 信息: 0
⏱️ 耗时: 10.4s
════════════════════════════════════════════════════════════
⚠️ 以下路径不存在，已跳过:
/path/to/nonexistent.ets
📋 共发现 2 个 .ets 文件待检查
...
本 skill 配置了 PostToolUse Hook，在 Claude 每次通过 Edit/Write 修改 .ets 文件后自动触发 LSP 检查。
.ets 文件ETS LSP 检查发现 2 个错误:
文件: /path/to/file.ets
16:27 - No overload matches this call.
23:5 - Type 'string' is not assignable to type 'number'.
请只修复你本次改动引入的错误，原有代码的问题保持现状并告诉用户。
# 安装 language server
npm install -g @arkts/language-server
npm install -g @arkts/language-service
# 或指定路径
ETS_LSP_COMMAND=/path/to/ets-language-server node scripts/ets-lsp-diagnose.js file.ets
# 设置正确的 SDK 路径
export HARMONYOS_SDK_PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony"
# 增加批量超时时间（默认 60000ms）
ETS_LSP_BATCH_TIMEOUT=120000 node scripts/ets-lsp-diagnose.js /path/to/project