这不是一篇教你敲命令的文章。这是一篇关于如何让 AI 成为你的鸿蒙开发助手，帮你完成从编译到部署全流程的实践分享。
为什么要做这个 Skill？
不是给开发者用的，是给 AI 用的
传统的 CLI 工具设计理念是：开发者学习命令 → 开发者执行命令。
但在 AI Coding 时代，我们有了新的可能：开发者描述需求 → AI 理解并执行。
harmonyos-build-deploy 的设计初心就是：
让 Claude 能够理解鸿蒙项目，自动完成编译、签名、部署、调试的全流程。开发者只需要用自然语言描述需求。
什么是 Claude Code Skill？
Claude Code 是 Anthropic 推出的 AI 编程助手。Skill 是一种扩展机制，可以教会 Claude 特定领域的知识和能力。
当你安装了 harmonyos-build-deploy Skill 后，Claude 就具备了：
- 🧠 理解鸿蒙项目结构（HAP/HSP/HAR 模块）
- 🔧 知道如何使用 hvigorw、hdc、ohpm 等工具
- 📦 能够分析模块依赖并按正确顺序编译
- 📱 可以将应用部署到真机并启动
- 🏪 能够打包 .app 文件用于上架 AppGallery
实际使用场景
场景 1：日常开发调试
你只需要说：
帮我编译一下这个鸿蒙项目，部署到手机上运行
Claude 会自动：
- 识别这是一个鸿蒙项目
- 调用
npx harmonyos-deploy --all --launch - 等待编译完成，处理可能的错误
- 部署到设备并启动应用
- 向你报告结果
场景 2：切换环境
你只需要说：
切换到生产环境，用 release 模式重新打包部署
Claude 理解后执行：
npx harmonyos-deploy --all -p production --release --launch
场景 3：调试问题
你只需要说：
应用好像有问题，帮我看看设备日志，过滤 NetworkError 相关的
Claude 会：
npx harmonyos-deploy --log-only --filter NetworkError
然后帮你分析日志内容，定位问题。
场景 4：准备上架
你只需要说：
项目开发完了，帮我打个包准备上架华为应用市场
Claude 会：
- 使用 release 模式打包 .app 文件
- 确保 debuggable=false
- 输出文件路径和大小
- 告诉你下一步去 AppGallery Connect 上传
npx harmonyos-deploy --app -p production --release -o ./dist
AI + Skill 的协作模式
传统方式 vs AI Coding
| 传统方式 | AI Coding + Skill |
|---|---|
| 查文档学习 hvigorw 命令 | 直接说"编译项目" |
| 记忆各种参数组合 | AI 自动选择正确参数 |
| 手动分析编译错误 | AI 解读错误并给出修复建议 |
| 一个个执行命令 | AI 自动串联完整流程 |
| 切换环境要改配置 | 说一句话就切换 |
Skill 如何工作
┌─────────────────────────────────────────────────────────────┐
│ 开发者 │
│ "帮我编译部署" │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Claude Code │
│ 1. 理解用户意图：编译 + 部署 │
│ 2. 识别项目类型：检测到 build-profile.json5 → 鸿蒙项目 │
│ 3. 调用 Skill：harmonyos-build-deploy │
│ 4. 执行命令：npx harmonyos-deploy --all --launch │
│ 5. 处理结果：成功/失败 → 反馈给用户 │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ harmonyos-deploy CLI │
│ • ohpm install │
│ • hvigorw assembleHap/assembleHsp │
│ • hdc install │
│ • aa start │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 鸿蒙设备 │
│ 应用成功运行 │
└─────────────────────────────────────────────────────────────┘
如何开始使用
方式 1：在 Claude Code 中安装 Skill
# 安装 skill
/skill install harmonyos-build-deploy
安装后，Claude 就会在你提到鸿蒙编译、部署、hvigor、hdc 等关键词时自动激活这个 Skill。
方式 2：直接使用（无需 Skill）
即使不安装 Skill，你也可以在对话中引导 Claude 使用这个工具：
我的项目是鸿蒙应用，请使用 npx harmonyos-deploy 来帮我编译部署
方式 3：项目级配置
在项目根目录创建 .claude/skills/ 文件夹，将 Skill 文件放入，Claude 会自动加载。
触发关键词
当你在对话中提到以下关键词时，Claude 会自动识别并使用 harmonyos-build-deploy：
- 鸿蒙、HarmonyOS、OpenHarmony
- 编译、构建、部署、安装
- hvigor、hvigorw、hdc
- HAP、HSP、HAR
- AppGallery、上架
- ohpm、hilog
Skill 的技术实现
零依赖设计
整个工具是一个约 1900 行的 Node.js 脚本，不依赖任何第三方 npm 包。这意味着：
- ✅ 无需
npm install - ✅ 直接
npx运行 - ✅ AI 可以立即使用
智能依赖解析
对于多模块项目，工具会：
- 扫描所有
oh-package.json5 - 解析 dependencies 字段
- 构建依赖图
- 拓扑排序得到正确的编译顺序
lushu_acommon (无依赖)
↓
lushu_appcommon (依赖 acommon)
↓
lushu_home, lushu_service... (依赖 acommon + appcommon)
↓
entry (HAP，最后编译)
错误诊断
当编译或安装失败时，工具会分析错误并给出修复建议，AI 可以直接将这些信息呈现给你。
未来展望
更深度的 AI 集成
- 🔮 AI 直接修改代码后自动重新编译部署
- 🔮 AI 分析运行时日志，自动定位并修复 Bug
- 🔮 AI 根据测试结果自动优化性能
更完整的 DevOps 支持
- 🔮 自动化测试集成
- 🔮 多设备并行部署
- 🔮 版本管理和发布流程
开源地址
- GitHub: github.com/supermanaaa…
- npm: www.npmjs.com/package/har…
- Claude Skills: 已提交至 anthropics/skills
总结
harmonyos-build-deploy 不仅仅是一个 CLI 工具，更是连接 AI 能力 和 鸿蒙开发 的桥梁。
它的存在让 Claude 能够：
- 理解鸿蒙项目的结构和构建流程
- 执行复杂的多模块编译
- 处理设备部署和调试
- 完成应用上架打包
而你只需要：
- 用自然语言描述需求
- 让 AI 帮你完成剩下的工作
这就是 AI Coding 时代的开发方式。
作者：supermanaaaa
如果这个 Skill 对你有帮助，请给个 ⭐️ Star 支持一下！
