把 DevEco Code 的 HarmonyOS 开发能力装进口袋——harmonyos-dev-skill

事情是这样的:华为的 DevEco Code(一个基于 OpenCode 二次开发的 AI 编程助手)里面藏了一整套鸿蒙开发工具链------ArkTS 语法检查、hdc 设备管理、崩溃日志分析、知识库搜索,甚至还有 UI 验证和项目模板。问题是,你得装一整个 IDE 插件才能用上这些能力,换个编辑器就没了,放在别的 AI Agent 里完全是睁眼瞎。

于是就有了 harmonyos-dev-skill------一个独立的 Agent Skill 项目,把 DevEco Code 里那些好用的鸿蒙开发工具全都拆出来,打包成干净独立的脚本集合,丢到任何支持 Skill 机制的 AI 编程工具里就能跑。简单说,就是把一整套鸿蒙开发工作流浓缩成一个文件夹,装上即用

它到底是什么

本质上是一堆脚本 + 参考文档 + 一个 Agent 入口文件(SKILL.md),按规范组织后,能被 AI Agent 读取并作为"技能"加载。加载之后,你的 AI 编程助手就突然懂鸿蒙了------知道怎么查 ArkTS 语法、怎么调 hdc 命令、怎么分析崩溃堆栈、怎么创建项目模板,甚至能直接帮你搜华为官方知识库。

听起来像魔法,其实做的是 "搬运 + 解耦" 的脏活。

从 DevEco Code 拆了什么出来

DevEco Code 仓库很大,核心的鸿蒙相关代码藏在 packages/opencode/src/tool/packages/opencode/resources/skills/ 下面。拆出来的东西可以分几类:

工具脚本(核心)

  • oh_knowledge.py:独立实现的鸿蒙知识库搜索,带完整的 OAuth 登录流程。不用开 DevEco Studio 就能直接搜华为文档,token 本地加密存储,登录一次管很久
  • arkts-check.cjs:调 DevEco Studio 自带的 ets_checker.js 做语法快速检查,写完代码秒出结果
  • deveco-build.cjs \ start-app.cjs:hvigor 构建和 hdc 启动的封装,一条命令搞定编译到运行
  • jscrash-report.cjs + runtime-fix/*.mjs:崩溃日志的结构化解析和故障取证流程,faultlogger 探测、faultlog 拉取、hilog 快照一条龙

参考资料(知识库)

  • ArkTS 语法规则、TypeScript 迁移差异、常见错误修复(每个错误都有对应的 .ets 示例)
  • ArkUI 组件 cookbook、API guardrail、常见坑、质量检查清单
  • DevEco Code 原始 agent prompt 备份

模板:完整的 ArkTS 项目模板,一键创建新工程。

解决了什么痛点

做过鸿蒙开发的人都懂------DevEco Studio 是必需品,但有时候你只是想快速查个 API、跑个语法检查、或者让 AI 帮你改两行 ArkTS 代码。为了这点事打开那个吃内存的 IDE,等它加载、索引、同步......真的够了。

这个 skill 让你在 VSCode、Cursor、Codex、Claude Code 或者任何支持 Skill/Agent 的环境里直接调用鸿蒙工具链,开发体验丝滑了不止一个档次。换电脑?不用重装 IDE 和插件,去 GitHub 把仓库 clone 下来,配个 DEVECO_HOME 就能干活。

怎么用

装到 Codex 就两行 PowerShell:

ruby 复制代码
$dest = Join-Path $env:USERPROFILE '.codex\skills\harmonyos-dev'
Copy-Item -Recurse -Force @('SKILL.md','agents','scripts','references','templates') -Destination $dest

重启 Codex,然后跟 AI 说:"用 harmonyos-dev skill 帮我检查这个项目的 ArkTS 语法问题",它就知道该调哪个脚本、读哪个参考文档了。

知识库搜索也是开箱即用:python scripts/oh_knowledge.py "ArkTS @State 装饰器用法",首次会自动弹出浏览器登录华为账号,之后走加密存储的 token,完全无感。

局限与边界

诚实地说,不是所有能力都搬过来了。DevEco Code 的 native bridge(napi_bridge.node)是平台相关的二进制文件,没法直接打包进仓库。所以 UI 验证会话、模拟器自动启动这类依赖原生桥的能力,需要额外配置才能用。不过日常开发 90% 的场景------语法检查、构建部署、设备管理、崩溃分析、知识搜索------都已经完整覆盖了。

写在最后

DevEco Code 是一套很强大的鸿蒙开发工具链,但它被束缚在特定的 IDE 生态里。harmonyos-dev-skill 做的事情本质上就是解耦和标准化------把好东西拆出来,让它能在任何地方发挥作用。

项目已开源在 GitHub 上:junerver/harmonyos-dev-skill,MIT 协议。如果你在做鸿蒙开发,又受够了 IDE 的束缚,不妨试试看。

相关推荐
澹然疏离9 分钟前
HarmonyOS应用《民族图鉴》开发第33篇:StorageService——本地存储服务封装
harmonyos
Nturmoils35 分钟前
Agent 不只是聊天框:用 ArkUI 做一个鸿蒙任务工作台
harmonyos
GitCode官方38 分钟前
开源鸿蒙跨平台直播| RN 三方库开源鸿蒙标准化适配实战分享
华为·开源·harmonyos·atomgit
不才难以繁此生3 小时前
ArkUI 列表性能实战|中式美食菜谱列表如何拆组件、控重绘和稳住滑动体验
harmonyos·arkts·状态管理·foreach·arkui·列表性能·组件拆分
Ww.xh3 小时前
DevEco Studio虚拟机部署指南
华为·harmonyos
yuanlaile3 小时前
前端转 Flutter 踩坑实录:一套可落地 Flutter 鸿蒙 App 完整学习路线,建议收藏!
flutter·harmonyos·flutter开发鸿蒙·跨平台开发app·flutter深入学习
FrameNotWork4 小时前
HarmonyOS 6.1 数据持久化与首选项实战:Preferences 和 RDB 的那些坑
华为·harmonyos
爸爸6194 小时前
08 ArkTS 类与静态方法设计:单例、DAO 与设计令牌
华为·harmonyos·鸿蒙系统
ZZZMMM.zip4 小时前
基于鸿蒙HarmonyOS NEXT开发AI天气助手应用:智能出行新体验与鸿蒙Flutter框架跨端实践
人工智能·flutter·华为·harmonyos·鸿蒙系统
心中有国也有家4 小时前
AtomGit Flutter 鸿蒙客户端:一键记录情绪的极致体验
学习·flutter·华为·harmonyos