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