ArkTS 语法助手技能安装指南与 AI 编程配置

平台二：Cursor

安装步骤

1. 在 Cursor 中打开终端（Ctrl+`` 或 Cmd+``）
2. 执行安装命令：

npx skills add https://github.com/SummerKaze/skill-arkts-syntax-assistant.git

3. 技能会自动安装到 Cursor 的技能目录

配置确认

Cursor 会在项目或用户级别的 .cursor/skills/ 目录下存储技能。你可以检查：

ls ~/.cursor/skills/arkts-syntax-assistant

使用方式

在 Cursor 的 AI 对话中（Composer 或 Chat），直接描述你的 ArkTS 开发需求，如「将这段 TS 代码迁移到 ArkTS」、「这个 ArkTS 编译错误怎么解决」或「ArkTS 高性能编程有什么建议」。Cursor 的 AI 会自动加载技能知识来回答。

Agent 模式增强

在 Cursor Agent 模式下，技能还支持自动编译验证：

# macOS/Linux
bash scripts/run.sh
# Windows
.\\\\\\scripts\\\\run.ps1

如果生成的代码编译失败，Agent 会自动重试修复，最多 3 次。

平台三：OpenCode

安装步骤

1. 打开 OpenCode 终端
2. 执行安装命令：

npx skills add https://github.com/SummerKaze/skill-arkts-syntax-assistant.git

3. 技能会安装到 OpenCode 的技能目录（通常是 ~/.config/opencode/skills/）

验证安装

ls ~/.config/opencode/skills/arkts-syntax-assistant

使用方式

OpenCode 支持技能自动触发。当检测到以下场景时，技能会自动激活：

命令行调用

你也可以在对话中显式引用技能：

@arkts-syntax-assistant 帮我检查这段代码是否符合 ArkTS 规范

平台四：Trae

安装步骤

1. 在 Trae 中打开内置终端
2. 执行安装命令：

npx skills add https://github.com/SummerKaze/skill-arkts-syntax-assistant.git

3. 技能会安装到 Trae 的技能目录

配置确认

ls ~/.trae/skills/arkts-syntax-assistant

使用方式

Trae 的 AI Agent 会在以下场景自动使用技能：

• 开发 HarmonyOS 应用时
• 处理 ArkTS/ETS 文件时
• 询问 TypeScript 到 ArkTS 迁移问题时

Builder 模式

在 Trae Builder 模式下，技能提供的编译脚本特别有用：

1. AI 生成 ArkTS 代码
2. 自动执行 scripts/run.sh 编译验证
3. 编译失败则分析错误并重试
4. 3 次失败后询问用户介入

通用：技能文档导航

安装后，技能提供以下参考文档：

常见问题

问题 1：npx 命令找不到

现象：执行 npx skills add 提示 npx: command not found

原因：Node.js 未安装或未添加到 PATH

解决：

# macOS (使用 Homebrew)
brew install node
# 或使用 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

问题 2：技能安装到错误目录

现象：安装成功但 AI 工具未加载技能

原因：不同工具的技能目录不同

解决：手动确认技能目录并移动：

问题 3：AI 生成代码仍然不符合 ArkTS 规范

现象：安装技能后，AI 仍然生成 any 类型、对象字面量等不合规代码

原因：技能未被触发，或上下文不足

解决：

1. 显式提及 ArkTS 或 HarmonyOS：「用 ArkTS 写一个…」
2. 在文件开头添加 .ets 扩展名标识
3. 在对话中引用技能：「参考 arkts-syntax-assistant 技能…」

问题 4：编译脚本执行失败

现象：执行 scripts/run.sh 提示 ohpm: command not found

原因：未安装 HarmonyOS SDK 或环境变量未配置

解决：

1. 安装 DevEco Studio，它会自动安装 SDK
2. 配置环境变量：

export OHOS_SDK_HOME=/path/to/your/sdk
export PATH=$PATH:$OHOS_SDK_HOME/toolchains

总结

• 一条命令：npx skills add https://github.com/SummerKaze/skill-arkts-syntax-assistant.git 搞定所有平台
• 自动触发：处理 .ets 文件或提及 ArkTS/HarmonyOS 时自动激活
• 核心价值：TS 迁移指南 + 编译错误修复 + 高性能编程实践

技能让 AI 编程工具从「不懂鸿蒙」变成「精通 ArkTS」，节省大量查文档、改代码、重编译的时间。