把 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 的束缚,不妨试试看。

相关推荐
程序猿追18 小时前
那个右下角的小数字怎么“卡”住我打字——我用 HarmonyOS 自己写了一个字数限制输入框
pytorch·华为·harmonyos
古德new18 小时前
鸿蒙PC使用electron迁移:Joplin Electron 桌面适配全记录
华为·electron·harmonyos
世人万千丶18 小时前
桌面便签小应用 - HarmonyOS ArkUI 开发实战-TextArea与Flex布局-PC版本
华为·harmonyos·鸿蒙·鸿蒙系统
慧海灵舟18 小时前
AGenUI 鸿蒙端实战踩坑录:从 Column 布局消失到异步组件宽度为 0
华为·harmonyos
yuegu77719 小时前
HarmonyOS应用<节气通>开发第33篇:状态管理实战
华为·harmonyos
YM52e20 小时前
买菜计算器小应用 - HarmonyOS ArkUI 开发实战-PC版本
学习·华为·harmonyos·鸿蒙·鸿蒙系统
阿捏利20 小时前
系列总览-鸿蒙科普系列完全指南
华为·harmonyos
小雨下雨的雨20 小时前
HarmonyOS ArkUI训练营入门-组件掌握系列-Animation 动画效果实现-PC版本
学习·华为·harmonyos·鸿蒙
yuegu77720 小时前
HarmonyOS应用<节气通>开发第32篇:ArkTS语法快速入门——从TypeScript到声明式UI的完整指南
harmonyos