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/
├── NDK/
└── 其他技术文档...




