鸿蒙 AI 开发必备：Skill 和 MCP 从入门到实战（附 Trae 部署）

优质文章学习记录

— 12 min read
鸿蒙 AI 开发必备：Skill 和 MCP 从入门到实战（附 Trae 部署）

鸿蒙 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服务
主要功能
  1. 项目管理
    • 创建新项目
    • 配置项目属性
    • 管理依赖包
  2. 构建部署
    • 编译项目
    • 生成HAP包
    • 安装到设备
    • 启动应用
  3. 设备交互
    • 获取设备列表
    • 启动应用
    • 获取UI树
    • 执行UI操作（点击、滑动、输入等）
    • 截图
    • 获取日志
  4. 开发辅助
    • 搜索HarmonyOS文档
    • 检查ETS文件语法
    • 获取设备日志
    • 获取崩溃日志
MCP工具列表
  1. mcp_deveco-mcp_build_project
    • 功能：执行编译构建导出构建产物
    • 参数：
      • build_intent：构建意图（LogVerification、Release等）
      • module：指定的模块及Target
      • product：指定的Product名称
  2. mcp_deveco-mcp_start_app
    • 功能：在模拟器/真机上运行应用
    • 参数：
      • ability：Ability名称（默认EntryAbility）
      • module：模块名称（默认entry）
      • target：构建目标（默认default）
      • hvd：目标设备名称或ID
  3. mcp_deveco-mcp_get_app_ui_tree
    • 功能：获取UI信息并保存为JSON文件
    • 参数：
      • mode：dump模式（simple-窗口节点信息，full-完整UI树）
      • outputDirectory：保存JSON文件的目录绝对路径
      • hvd：目标设备名称
  4. mcp_deveco-mcp_perform_ui_action
    • 功能：统一的UI操作工具
    • 支持的操作类型：
      • click：单击
      • directionalFling：方向滑动
      • inputText：输入文本
      • keyEvent：按键事件
      • screenshot：截图
  5. mcp_deveco-mcp_get_hilog_or_faultlog_recent
    • 功能：获取模拟器/真机设备的hilog/faultlog日志
    • 参数：
      • bundle_name：应用包名
      • domain：日志领域
      • level：日志级别（D、I、W、E、F）
      • tag：过滤标签
      • keyword：关键字过滤
      • is_crash_log：是否获取崩溃日志
  6. mcp_deveco-mcp_harmonyos_knowledge_search
    • 功能：搜索HarmonyOS开发文档
    • 参数：
      • keywords：搜索关键词列表
      • maxCharSize：最大返回字符数（默认5000）
  7. 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" // 电脑中DevEco Studio的安装路径 } } } }

5. 总结

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

在这里插入图片描述

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

Skill的优势

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

MCP的优势

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

重点提醒（避坑必备）

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

最佳实践

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

声明

  • 本文档仅提供技术介绍和使用指导，不对任何第三方工具的质量、安全性和可用性做出保证
  • 使用第三方工具所产生的任何损失或问题，由使用者自行承担责任
  • 建议在使用前充分了解工具的许可证、服务条款和隐私政策

相关链接

  • harmony-next.skills：https://github.com/linhay/harmony-next.skills
  • arkts-syntax-assistant：https://github.com/SummerKaze/skill-arkts-syntax-assistant
  • DevEco Toolbox：https://github.com/open-deveco/deveco-toolbox

Read more

15. Web可访问性最佳实践：让每个用户都能平等访问

15. Web可访问性最佳实践：让每个用户都能平等访问 引言 Web 可访问性是前端开发的重要组成部分，它确保所有用户，包括残障人士，都能平等地访问和使用网站。作为一名把代码当散文写的 UI 匠人，我始终认为：好的设计不仅要美观，更要包容。就像一首好的音乐，不仅要动听，更要让所有人都能欣赏。Web 可访问性，就是为了让这种包容成为现实。 什么是 Web 可访问性？ Web 可访问性（Web Accessibility）是指网站、工具和技术能够被所有人使用的程度，无论他们是否有残疾。这包括： * 视觉障碍（如失明、低视力） * 听觉障碍（如耳聋） * 运动障碍（如无法使用鼠标） * 认知障碍（如学习困难） 可访问性的重要性 1. 法律要求：许多国家和地区都有关于 Web 可访问性的法律法规 2. 扩大受众：提高可访问性可以让更多人使用你的网站
保姆级教程｜ Obsidian +Claudian 搭建AI 时代下最好的知识管理方案

保姆级教程｜ Obsidian +Claudian 搭建AI 时代下最好的知识管理方案

保姆级教程｜ Obsidian +Claudian 搭建AI 时代下最好的知识管理方案 OBSIDIAN AI COGNITIONFLOW 让你的笔记从信息坟场变成AI知识引擎 💡把“死笔记”变成“活资产”的终极方案 1一句话变思维导图 COMMAND /obsidian帮我把这篇文章画成思维导图 可拖拽、可展开、可链接——比纯文字清晰 10 倍 2AI 帮你追踪项目进度 CHAT 帮我看看这个项目目前的进展，哪些完成了，哪些还没做 AI 自动读取项目笔记，汇总进度、列出待办、提醒遗漏 3公众号一键排版输出 正文开始 从 Notion 到Obsidian ，从 Roam Research 到 Logseq — 笔记软件永远是效率圈最热的战场。双链、大纲、白板、数据库……我们折腾插件、
A / B测试太慢？AI帮你实时优化实验策略

A / B测试太慢？AI帮你实时优化实验策略

👋 大家好，欢迎来到我的技术博客！ 📚 在这里，我会分享学习笔记、实战经验与技术思考，力求用简单的方式讲清楚复杂的问题。 🎯 本文将围绕AI这个话题展开，希望能为你带来一些启发或实用的参考。 🌱 无论你是刚入门的新手，还是正在进阶的开发者，希望你都能有所收获！ 文章目录 * A/B测试太慢？AI帮你实时优化实验策略 🚀 * 为什么传统A/B测试成了效率黑洞？ * AI驱动的实时优化：从“被动等待”到“主动决策” * 贝叶斯优化：AI决策的数学引擎 * 代理模型：预测点击率 * 采集函数：决定下一步策略 * 代码实战：用Python实现AI优化A/B测试 * 代码执行结果示例 * 实时决策流程：AI如何动态调整实验？ * 实际业务场景：电商大促的AI优化案例 * 贝叶斯优化 vs 其他AI方法 * 如何在你的系统中落地AI优化？ * 步骤1：构建基础数据层 * 步骤2：集成AI优化引擎 * 步骤3：设置停止条件 * 为什么AI优化能避免“实验陷阱”？
大语言模型LLM解决AI幻觉方法的深度分析

大语言模型LLM解决AI幻觉方法的深度分析

LLM解决AI幻觉方法的深度分析 引言：AI幻觉的定义与研究背景 AI 幻觉作为大型语言模型（LLM）部署的核心挑战，其学术价值体现于对模型"概率生成天性"的机制探索（如 OpenAI 2025 年论文《Why Language Models Hallucinate》揭示的底层逻辑），产业意义则关乎医疗、金融等关键领域的安全应用[1]。当前研究显示，即使开发团队对 LLM 内部运作的理解仍局限于 10%～20%（Anthropic 团队研究），但该现象已引发信息污染、信任危机等风险，同时在科学发现等领域展现创造力价值，成为 AI 可靠性研究的焦点[2][3][4]。 AI 幻觉的权威分类： * 事实性幻觉：生成内容与客观事实冲突，例如错误声称"蜂蜜可帮助糖尿病患者稳定血糖"[2]