鸿蒙 AI 开发：Skill 与 MCP 概念及 Trae 部署实战

1. 引言

随着 HarmonyOS 生态的快速发展，开发者需要高效的工具和资源来提升开发效率。在 AI 辅助编程的背景下，Skill 和 MCP（Model Context Protocol）为 HarmonyOS 开发者提供了强大的支持。本文档介绍几个鸿蒙开发相关的 Skill 和 MCP 工具，帮助开发者更好地理解和使用这些工具。

2. 相关概念介绍

2.1 Skill

Skill 是 AI 编程助手的扩展技能库，可以理解为给 AI 助手添加的"专业知识包"。就像人类专家需要专业知识一样，AI 助手也需要 Skill 来获得特定领域的专业能力。

Skill 主要提供专业知识库、代码生成辅助、语法检查和开发指导等功能。其特点是离线可用、专业性强、实时响应和持续更新。适用于学习新技术、编写代码、解决问题和代码审查等场景。

2.2 MCP

MCP（Model Context Protocol，模型上下文协议）是一种标准化协议，用于 AI 助手与外部工具和服务进行交互。如果把 AI 助手比作"大脑"，MCP 就是大脑的"手和眼"。

它的核心功能就是"帮 AI 跑腿"，提供统一接口、工具集成、上下文管理和安全控制，特点是"标准化不挑工具、动态适配不卡顿、可扩展能加活、够安全不翻车"。自动化测试、设备调试、代码构建、问题诊断这些费时间的杂活，交给 MCP+AI，你只管指挥就行。

2.3 Skill 和 MCP 区别

二者常被混淆，其实一句话就能分清：Skill 是"死知识"，MCP 是"活能力"，二者分工明确，却能默契配合。具体区别如下：

定位差异：Skill 是"静态知识库"，像一本随时能翻的鸿蒙开发词典，离线也能查；MCP 是"动态工具接口"，像一套随身工具箱，得有工具（和网络）才能用。
功能差异：Skill 负责"查知识、给建议"，比如 API 怎么用、语法错在哪；MCP 负责"做操作、拿结果"，比如编译项目、启动应用、抓日志。
使用方式差异：Skill 是"被动查询"，你问它才答，侧重于"顾问角色"；MCP 是"主动执行"，你让它干啥就干啥，侧重于"工具人角色"。
依赖关系：Skill 是"单打独斗型"，离线也能发光发热；MCP 是"团队协作型"，得依赖具体工具和网络，没工具就无法执行。

虽然定位不同，但 Skill 和 MCP 可以很好地协同工作：Skill 提供专业知识和建议，MCP 执行具体的操作和任务，AI 助手整合两者，大大提升开发效率。

3. 鸿蒙开发相关 Skill 介绍

3.1 harmony-next

简介

harmony-next 是为 AI 编程助手（如 Gemini CLI、Claude Code、Codex）设计的参考技能库。它为 HarmonyOS NEXT（以 API 12+ 为主）提供本地化的离线知识源，包含 4,257 份涵盖 ArkTS、ArkUI 和 NDK 的 Markdown 格式参考文档。

主要特性

全面的 API 覆盖：包含 4,232 份 JsEtsAPIReference 文档
版本标注：文档大量包含 API 12-23 的版本标注、兼容性说明和变更说明
离线访问：所有文档本地存储，无需网络连接
快速检索：支持按 Kit、任务、索引等多种方式渐进式定位文档

适用场景

API 查询：快速查找 HarmonyOS API 的使用方法和参数说明
版本兼容：了解不同 API 版本的兼容性和变更情况
代码示例：获取官方提供的代码示例和最佳实践
学习参考：作为 HarmonyOS 开发的权威参考资料

知识库结构

harmony-next.skills/
├── JsEtsAPIReference/ # ArkTS API 参考文档（4,232 份）
├── ApplicationKit/ # 应用开发相关文档
├── ArkUI/ # UI 框架文档
├── NDK/ # 原生开发文档
└── 其他技术文档...

3.2 arkts-syntax-assistant

简介

arkts-syntax-assistant 是 ArkTS 语言学习和开发助手，专注于 ArkTS 语法、迁移和优化指导。它为开发者提供从 TypeScript 到 ArkTS 的迁移支持，以及 ArkTS 特有的语法特性和最佳实践。

主要特性

语法检查：实时检查 ArkTS 语法错误，提供详细的错误信息和修复建议
迁移指导：帮助开发者将 TypeScript 代码迁移到 ArkTS
性能优化：提供 ArkTS 性能优化建议，如状态管理、组件优化等
编译错误解决：针对 ArkTS 编译错误提供解决方案

适用场景

语法学习：学习 ArkTS 特有的语法特性和使用规范
代码迁移：将现有 TypeScript 代码迁移到 ArkTS
错误修复：快速定位和修复 ArkTS 编译错误
性能调优：优化 ArkTS 代码的性能表现

触发条件

arkts-syntax-assistant 在以下情况下自动触发：

处理 .ets 文件时
涉及 ArkTS 关键字的问题
TypeScript 迁移相关问题
状态管理、组件开发等问题

3.3 Trae 部署 Skill 步骤

首先下载指定 SKILL.md 文件或包含 SKILL.md 以及其他相关文件的 .zip 文件
前往设置 > 规则和技能。
在技能部分，点击创建按钮
在新建窗口中上传一个 SKILL.md 文件或一个包含 SKILL.md 文件的 .zip 文件，然后选择技能类型（全局 / 项目）。TRAE 会分析所上传的技能文件，然后自动填充技能名称、描述和指令字段。

在这里插入图片描述

按需修改相关内容，然后点击 确认 按钮。对于全局技能，添加后，它会直接出现在 技能 面板的 全局 页签下。对于项目技能，TRAE 将自动在 .trae/skills/ 目录下新建 {skill_name} 文件夹，其中包含你所上传的所有文件。同时，该技能也会在 技能 面板的 项目 页签下展示。

4. 鸿蒙开发相关 MCP 介绍

4.1 deveco-mcp

简介

DevEco Toolbox 是一个工具集（依赖于 DevEco Studio），可以在不打开 DevEco Studio 的情况下，在 Trae、Cursor、Visual Studio Code 等 AI IDE 中完成鸿蒙应用开发的大多数工作。DevEco Toolbox 当前包含两个可执行文件：

deveco-toolbox：用于可视化配置
deveco-mcp-server：主要的 MCP 服务

主要功能

项目管理
- 创建新项目
- 配置项目属性
- 管理依赖包
构建部署
- 编译项目
- 生成 HAP 包
- 安装到设备
- 启动应用
设备交互
- 获取设备列表
- 启动应用
- 获取 UI 树
- 执行 UI 操作（点击、滑动、输入等）
- 截图
- 获取日志
开发辅助
- 搜索 HarmonyOS 文档
- 检查 ETS 文件语法
- 获取设备日志
- 获取崩溃日志

MCP 工具列表

mcp_deveco-mcp_build_project
- 功能：执行编译构建导出构建产物
- 参数：
  - build_intent：构建意图（LogVerification、Release 等）
  - module：指定的模块及 Target
  - product：指定的 Product 名称
mcp_deveco-mcp_start_app
- 功能：在模拟器/真机上运行应用
- 参数：
  - ability：Ability 名称（默认 EntryAbility）
  - module：模块名称（默认 entry）
  - target：构建目标（默认 default）
  - hvd：目标设备名称或 ID
mcp_deveco-mcp_get_app_ui_tree
- 功能：获取 UI 信息并保存为 JSON 文件
- 参数：
  - mode：dump 模式（simple-窗口节点信息，full-完整 UI 树）
  - outputDirectory：保存 JSON 文件的目录绝对路径
  - hvd：目标设备名称
mcp_deveco-mcp_perform_ui_action
- 功能：统一的 UI 操作工具
- 支持的操作类型：
  - click：单击
  - directionalFling：方向滑动
  - inputText：输入文本
  - keyEvent：按键事件
  - screenshot：截图
mcp_deveco-mcp_get_hilog_or_faultlog_recent
- 功能：获取模拟器/真机设备的 hilog/faultlog 日志
- 参数：
  - bundle_name：应用包名
  - domain：日志领域
  - level：日志级别（D、I、W、E、F）
  - tag：过滤标签
  - keyword：关键字过滤
  - is_crash_log：是否获取崩溃日志
mcp_deveco-mcp_harmonyos_knowledge_search
- 功能：搜索 HarmonyOS 开发文档
- 参数：
  - keywords：搜索关键词列表
  - maxCharSize：最大返回字符数（默认 5000）
mcp_deveco-mcp_check_ets_files
- 功能：对传入的 ets 文件进行静态语法检查
- 参数：
  - files：待检查的 ETS 文件路径列表

4.2 Trae 部署说明

这个工具的官方 README 里有详细的部署步骤，还提供了 deveco-toolbox 可视化配置工具，小白可以直接看官方文档（链接在文末）。这里给大家简化一下 Trae 中的手动配置流程，适合不想看长篇文档的小伙伴：

点击对话面板右上角的设置图标，进入设置中心
在左侧导航栏中，选择 MCP，打开 MCP 窗口。

在 MCP 窗口的右上角，点击添加 > 手动添加。若你是首次添加 MCP Server，还可以直接点击窗口中部的手动添加按钮。

在这里插入图片描述

填入 MCP Server 的配置内容。

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "deveco-mcp-server"
      ],
      "env": {
        "PROJECT_PATH": "${workspaceFolder}",
        "DEVECO_PATH": "C://****//Huawei//DevEco Studio"
      }
    }
  }
}

5. 总结

在 Trae 中配置完成以后可以直接在对话框中获取当前配置的 Skill 和 MCP:

在这里插入图片描述

Skill 和 MCP 为 HarmonyOS 开发者提供了强大的开发支持，它们各有侧重，相互补充：

Skill 的优势

离线可用，没网也能查知识，出差、断网不耽误开发；
深度集成鸿蒙文档和 API 参考，比官网搜索更高效；
实时语法检查和代码规范指导，帮你写对代码、写好代码；
适合学习和开发阶段，帮你快速上手鸿蒙、解决编码难题。

MCP 的优势

动态交互和工具集成，不用打开多个工具，一站式搞定杂活；
支持设备调试和自动化测试，省去手动操作，省时间、少出错；
集成构建部署流程，编译、安装、启动一键搞定，不用记命令；
适合调试测试和自动化操作阶段，帮你搞定繁琐的重复性工作。

注意事项

编程助手如果只配置了鸿蒙开发相关的 Skill，还需要配置鸿蒙的编译安装环境（具体流程参考上一篇文章），才能获得更流畅的开发体验——不然 AI 能写对代码，但没法编译、安装，等于无法落地，白忙活一场。

最佳实践

给大家推荐一个最高效的搭配方案，适合初学者参考：先下载配置好 DevEco Studio，保证鸿蒙项目能正常编译、调试（这是基础，别偷懒）；然后在 Trae 中按上面的步骤，部署好相关的 Skill 和 MCP。配置完成后，只需要在 Trae 对话框中输入需求提示词，AI 就能自动完成"开发代码→编译→安装→调试→查看日志→修改代码"的循环，直到完成你指定的任务，全程不用你手动敲命令、查文档，极大提升开发效率，让你从"代码工具人"变成"需求指挥者"。

1. 引言

2. 相关概念介绍

2.1 Skill

2.2 MCP

2.3 Skill 和 MCP 区别

二者常被混淆，其实一句话就能分清：Skill 是"死知识"，MCP 是"活能力"，二者分工明确，却能默契配合。具体区别如下：

定位差异：Skill 是"静态知识库"，像一本随时能翻的鸿蒙开发词典，离线也能查；MCP 是"动态工具接口"，像一套随身工具箱，得有工具（和网络）才能用。
功能差异：Skill 负责"查知识、给建议"，比如 API 怎么用、语法错在哪；MCP 负责"做操作、拿结果"，比如编译项目、启动应用、抓日志。
使用方式差异：Skill 是"被动查询"，你问它才答，侧重于"顾问角色"；MCP 是"主动执行"，你让它干啥就干啥，侧重于"工具人角色"。
依赖关系：Skill 是"单打独斗型"，离线也能发光发热；MCP 是"团队协作型"，得依赖具体工具和网络，没工具就无法执行。

虽然定位不同，但 Skill 和 MCP 可以很好地协同工作：Skill 提供专业知识和建议，MCP 执行具体的操作和任务，AI 助手整合两者，大大提升开发效率。

3. 鸿蒙开发相关 Skill 介绍

3.1 harmony-next

简介

主要特性

全面的 API 覆盖：包含 4,232 份 JsEtsAPIReference 文档
版本标注：文档大量包含 API 12-23 的版本标注、兼容性说明和变更说明
离线访问：所有文档本地存储，无需网络连接
快速检索：支持按 Kit、任务、索引等多种方式渐进式定位文档

适用场景

API 查询：快速查找 HarmonyOS API 的使用方法和参数说明
版本兼容：了解不同 API 版本的兼容性和变更情况
代码示例：获取官方提供的代码示例和最佳实践
学习参考：作为 HarmonyOS 开发的权威参考资料

知识库结构

harmony-next.skills/
├── JsEtsAPIReference/ # ArkTS API 参考文档（4,232 份）
├── ApplicationKit/ # 应用开发相关文档
├── ArkUI/ # UI 框架文档
├── NDK/ # 原生开发文档
└── 其他技术文档...

3.2 arkts-syntax-assistant

简介

主要特性

语法检查：实时检查 ArkTS 语法错误，提供详细的错误信息和修复建议
迁移指导：帮助开发者将 TypeScript 代码迁移到 ArkTS
性能优化：提供 ArkTS 性能优化建议，如状态管理、组件优化等
编译错误解决：针对 ArkTS 编译错误提供解决方案

适用场景

语法学习：学习 ArkTS 特有的语法特性和使用规范
代码迁移：将现有 TypeScript 代码迁移到 ArkTS
错误修复：快速定位和修复 ArkTS 编译错误
性能调优：优化 ArkTS 代码的性能表现

触发条件

arkts-syntax-assistant 在以下情况下自动触发：

处理 .ets 文件时
涉及 ArkTS 关键字的问题
TypeScript 迁移相关问题
状态管理、组件开发等问题

3.3 Trae 部署 Skill 步骤

首先下载指定 SKILL.md 文件或包含 SKILL.md 以及其他相关文件的 .zip 文件
前往设置 > 规则和技能。
在技能部分，点击创建按钮
在新建窗口中上传一个 SKILL.md 文件或一个包含 SKILL.md 文件的 .zip 文件，然后选择技能类型（全局 / 项目）。TRAE 会分析所上传的技能文件，然后自动填充技能名称、描述和指令字段。

在这里插入图片描述

按需修改相关内容，然后点击 确认 按钮。对于全局技能，添加后，它会直接出现在 技能 面板的 全局 页签下。对于项目技能，TRAE 将自动在 .trae/skills/ 目录下新建 {skill_name} 文件夹，其中包含你所上传的所有文件。同时，该技能也会在 技能 面板的 项目 页签下展示。

4. 鸿蒙开发相关 MCP 介绍

4.1 deveco-mcp

简介

deveco-toolbox：用于可视化配置
deveco-mcp-server：主要的 MCP 服务

主要功能

项目管理
- 创建新项目
- 配置项目属性
- 管理依赖包
构建部署
- 编译项目
- 生成 HAP 包
- 安装到设备
- 启动应用
设备交互
- 获取设备列表
- 启动应用
- 获取 UI 树
- 执行 UI 操作（点击、滑动、输入等）
- 截图
- 获取日志
开发辅助
- 搜索 HarmonyOS 文档
- 检查 ETS 文件语法
- 获取设备日志
- 获取崩溃日志

MCP 工具列表

mcp_deveco-mcp_build_project
- 功能：执行编译构建导出构建产物
- 参数：
  - build_intent：构建意图（LogVerification、Release 等）
  - module：指定的模块及 Target
  - product：指定的 Product 名称
mcp_deveco-mcp_start_app
- 功能：在模拟器/真机上运行应用
- 参数：
  - ability：Ability 名称（默认 EntryAbility）
  - module：模块名称（默认 entry）
  - target：构建目标（默认 default）
  - hvd：目标设备名称或 ID
mcp_deveco-mcp_get_app_ui_tree
- 功能：获取 UI 信息并保存为 JSON 文件
- 参数：
  - mode：dump 模式（simple-窗口节点信息，full-完整 UI 树）
  - outputDirectory：保存 JSON 文件的目录绝对路径
  - hvd：目标设备名称
mcp_deveco-mcp_perform_ui_action
- 功能：统一的 UI 操作工具
- 支持的操作类型：
  - click：单击
  - directionalFling：方向滑动
  - inputText：输入文本
  - keyEvent：按键事件
  - screenshot：截图
mcp_deveco-mcp_get_hilog_or_faultlog_recent
- 功能：获取模拟器/真机设备的 hilog/faultlog 日志
- 参数：
  - bundle_name：应用包名
  - domain：日志领域
  - level：日志级别（D、I、W、E、F）
  - tag：过滤标签
  - keyword：关键字过滤
  - is_crash_log：是否获取崩溃日志
mcp_deveco-mcp_harmonyos_knowledge_search
- 功能：搜索 HarmonyOS 开发文档
- 参数：
  - keywords：搜索关键词列表
  - maxCharSize：最大返回字符数（默认 5000）
mcp_deveco-mcp_check_ets_files
- 功能：对传入的 ets 文件进行静态语法检查
- 参数：
  - files：待检查的 ETS 文件路径列表

4.2 Trae 部署说明

点击对话面板右上角的设置图标，进入设置中心
在左侧导航栏中，选择 MCP，打开 MCP 窗口。

在 MCP 窗口的右上角，点击添加 > 手动添加。若你是首次添加 MCP Server，还可以直接点击窗口中部的手动添加按钮。

在这里插入图片描述

填入 MCP Server 的配置内容。

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "deveco-mcp-server"
      ],
      "env": {
        "PROJECT_PATH": "${workspaceFolder}",
        "DEVECO_PATH": "C://****//Huawei//DevEco Studio"
      }
    }
  }
}

5. 总结

在 Trae 中配置完成以后可以直接在对话框中获取当前配置的 Skill 和 MCP:

在这里插入图片描述

Skill 和 MCP 为 HarmonyOS 开发者提供了强大的开发支持，它们各有侧重，相互补充：

Skill 的优势

离线可用，没网也能查知识，出差、断网不耽误开发；
深度集成鸿蒙文档和 API 参考，比官网搜索更高效；
实时语法检查和代码规范指导，帮你写对代码、写好代码；
适合学习和开发阶段，帮你快速上手鸿蒙、解决编码难题。

MCP 的优势

动态交互和工具集成，不用打开多个工具，一站式搞定杂活；
支持设备调试和自动化测试，省去手动操作，省时间、少出错；
集成构建部署流程，编译、安装、启动一键搞定，不用记命令；
适合调试测试和自动化操作阶段，帮你搞定繁琐的重复性工作。

鸿蒙 AI 开发：Skill 与 MCP 概念及 Trae 部署实战

1. 引言

2. 相关概念介绍

2.1 Skill

2.2 MCP

2.3 Skill 和 MCP 区别

3. 鸿蒙开发相关 Skill 介绍

3.1 harmony-next

简介

主要特性

适用场景

知识库结构

3.2 arkts-syntax-assistant

简介

主要特性

适用场景

触发条件

3.3 Trae 部署 Skill 步骤

4. 鸿蒙开发相关 MCP 介绍

4.1 deveco-mcp

简介

主要功能

MCP 工具列表

4.2 Trae 部署说明

5. 总结

Skill 的优势

MCP 的优势

注意事项

最佳实践

相关链接

鸿蒙 AI 开发：Skill 与 MCP 概念及 Trae 部署实战

1. 引言

2. 相关概念介绍

2.1 Skill

2.2 MCP

2.3 Skill 和 MCP 区别

3. 鸿蒙开发相关 Skill 介绍

3.1 harmony-next

简介

主要特性

适用场景

知识库结构

3.2 arkts-syntax-assistant

简介

主要特性

适用场景

触发条件

3.3 Trae 部署 Skill 步骤

4. 鸿蒙开发相关 MCP 介绍

4.1 deveco-mcp

简介

主要功能

MCP 工具列表

4.2 Trae 部署说明

5. 总结

Skill 的优势

MCP 的优势

注意事项

最佳实践

相关链接

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具