Agent Skills
返回列表
鸿蒙应用代码生成器

鸿蒙应用代码生成器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ea38fd42/harmonyos-app-dev。

技能介绍

要解决什么问题

HarmonyOS 应用开发往往卡在「文档分散 + ArkTS 约束多 + 工程结构不统一」:你描述的是业务页面,Agent 却容易输出教程片段、混用 V1/V2 状态管理,或在 build()、@Prop 初始化、Navigation 壳层上踩编译/白屏坑。本技能把目标收窄为可放进 DevEco Studio 工程直接编译运行的 .ets 与配置,而不是知识点罗列。

技能如何工作

生成前会先对齐几项设计决策并说明理由:

  • 应用模型:默认 Stage 模型(文档中的唯一推荐路径)
  • 状态管理:新项目优先 V2(@ComponentV2、@Local、@Param、@Event 等);老项目才回退 V1
  • SDK:新项目面向 API 12+(HarmonyOS NEXT);维护场景可兼容 API 9–11
  • 目录分层:pages/、components/、model/、common/(复杂业务可加 viewmodel/)

输出按固定顺序组织:设计概览 → 目录树 → 分文件代码 → 运行说明(权限、依赖、注意事项)。规范侧强调 ArkTS 常见硬规则,例如 build() 单一根节点、@Prop 等不可本地初始化、网络需 ohos.permission.INTERNET 且 http 用后 destroy()、V2 不与 @Component 混用等。文档还串联 DevEco 工具链选型:IDE(DevEco Studio)、Agent 终端(DevEco Code)、CLI(DevEco CLI)、IDE 插件(CodeGenie),并在编译、运行、日志、语法检查、知识库检索等场景给出对应工具。

专题段落覆盖实战高频能力:Share Kit(系统分享,非错误调用 pasteboard)、UserAuth(含 API 演进与成功码 12500000 等坑)、以及 DocumentViewPicker、Navigation 白屏、SymbolGlyph、网络请求等踩坑修复条目,便于对照日志改代码。

适用边界与注意点

  • 模拟器对生物识别等能力支持有限,相关功能需真机验证。
  • 敏感信息应走 preferences 等存储,生产环境用 HTTPS;涉及权限会在生成时提醒(网络、生物识别、运行时授权等)。
  • 技能侧重代码与工程约定;具体 Hvigor/DevEco Code 命令需在本地工具链中执行,文档提供场景对照而非替代你的构建环境。

使用场景

  • 产品给出页面与交互说明后,要在新 Stage 工程里生成可编译的 `pages/` 入口页与 `module.json5` 网络等权限配置
  • 在既有 HarmonyOS 工程里增量加一个列表/详情页,需 `@ComponentV2`、`LazyForEach` 与统一目录分层后交给 Hvigor 构建
  • 编译卡在 `arkts-no-untyped-obj-literals` 或 `Navigation` 路由参数匿名对象,需按规范改成显式类型再过 ArkTS 检查
  • 真机调试生物识别登录时成功却提示失败,需对照 UserAuth 结果码 `12500000` 与 `getAvailableStatus` 参数签名改认证流程

适合人员

  • 负责 HarmonyOS NEXT(API 12+)功能交付、要求输出可直接合入工程的 `.ets` 而非教程的应用开发工程师
  • 维护 API 9–11 老工程、要在 V1 状态管理与 Stage 分层之间做兼容决策的技术负责人
  • 集成指纹/人脸/PIN 登录、需区分模拟器与真机并在日志里核对 UserAuth 错误码的移动端工程师
  • 做应用内分享链接或图片、需从错误 API 迁移到 Share Kit `ShareController.show()` 的鸿蒙功能开发同学