鸿蒙HarmonyOS

HarmonyOS 开发 CLI 工具 — 文档查询、项目构建、设备部署、配置管理。 当用户需要搜索/获取华为 HarmonyOS 开发文档、构建 HAP、部署应用到真机、管理连接设备、或配置 DevEco Studio 工具路径时使用。 关键字触发：HarmonyOS、鸿蒙、构建、部署、hvigor、hdc、HAP、hmdev。

鸿蒙应用开发技能。触发：HarmonyOS/鸿蒙/ArkTS/ArkUI/DevEco/Stage 模型/创建鸿蒙工程/ArkTS 编译错误/jscrash/HAP 构建/文档搜索/知识库

LinReads 三端阅读器（Android · HarmonyOS · Web）开发专用 skill。 ✅ 适用：阅读功能、UI/UX、书库管理、Calibre 集成、格式渲染（EPUB/PDF）、跨平台一致性、构建发布。 ❌ 不适用：与阅读器无关的通用 Python/服务端开发（走 omubot 项目的规则）。 显式调用：/linreads-dev

根据技术方案、应用需求或安卓代码片段，查找并列出所需的 HarmonyOS ArkTS public API。当用户描述想要实现的功能、需要了解该用哪些 API/Kit/接口时触发，例如："我需要什么API实现…"、"做一个拍照功能需要哪些接口"、"这个需求用哪个Kit"、"技术方案中涉及哪些HarmonyOS能力"、"查一下相机相关的API"、"我要接入地图有哪些接口可以用"。当用户描述应用需求但未明确要求写代码时也应触发，例如："我要做一个IM应用需要音视频通话"——此时应识别所有相关API。当用户携带安卓（Java/Kotlin）代码片段询问 HarmonyOS 对应 API 时也应触发，例如："这段安卓代码在鸿蒙上用什么API实现"、"帮我把这个 Android 功能迁移到鸿蒙，需要哪些接口"——此时应解析安卓代码并映射到对应的 HarmonyOS API。触发关键词：需要哪些API、用什么接口实现、查API、涉及哪些能力、哪些组件、技术方案、API文档、文档路径、鸿蒙迁移、Android迁移、安卓代码，与 ArkTS/HarmonyOS/鸿蒙/ability/UIAbility/ArkUI 或任意 Kit 名称组合出现。当用户明确要求编写或生成 .ets 代码文件时，不触发本 skill。

ArkUI/ArkTS 代码生成与修改约束。以下场景自动触发： 1. 直接涉及 UI 代码：生成组件、写页面、实现功能、ArkUI、build、@Component、@Entry、 @Builder、@Styles、@Extend、@State、@Link、@Prop、鸿蒙、HarmonyOS、ets 文件 2. 修改/编辑 .ets 文件中的任何代码（改逻辑、改条件、改样式、加功能、删功能、重构） 3. 用户提供的文件路径以 .ets 结尾，或代码片段包含 build()、@Component 等 ArkUI 特征 4. 修改红点、角标、Tab、导航、列表项等 UI 相关业务逻辑

Compile a HarmonyOS project using DevEco Studio's built-in hvigor tool. Use when the user wants to build, compile, or package a HarmonyOS/ArkTS project into a HAP. Handles ohpm dependency installation, SDK patch workaround, sync, assembleHap, error classification, and auto-invokes harmony-fix for code errors.

鸿蒙(HarmonyOS)/ArkTS 代码 AI 检视技能。当用户需要检视、审查、检查鸿蒙代码时使用此技能。触发场景包括：检视单个 .ets/.ts 文件、审查目录或项目代码、发现代码问题、生成检视报告。即使用户没有明确说"检视"，只要是关于鸿蒙代码质量、问题排查、代码优化的请求，都应使用此技能。触发短语："检视代码"、"代码审查"、"review代码"、"检查代码"、"帮我看看这段代码"、"代码有什么问题"、"鸿蒙代码扫描"、"ArkTS代码检查"、"这个组件有问题吗"、"帮我审查一下"。

Vibe coding 迭代已有原型/demo 时的协作协议。适用于本地可编辑、可重复运行或预览的 demo （网页、原生 App、脚本等），不限操作系统（macOS / Windows / 鸿蒙等）。 Use when: 用户要在已有 demo 上修改——如「改一下 X」「改一下 X 和 Y」「调整某交互」「把某处改成…」； 或说「只改」「别动其他的」「存一版」「做一版新的」「回到某版」；或 demo 越改越乱、改一处坏别处。 不用于：从零新建项目、与当前 demo 无关的问答。 Triggers: 改一下、改下、调整、改成、修改、再改、迭代、存一版、做一版新的、回到某版、 只改、别动、 change, tweak, adjust, modify, iterate, save version, new version, rollback

当用户编写、调试或审查 HarmonyOS NEXT 应用（ArkTS / ArkUI / Stage 模型 / @ohos.* API / DevEco Studio / hvigor / hdc），需要查阅华为开发者官方文档（版本说明 / 指南 / API 参考 / 最佳实践 / FAQ），或询问 HarmonyOS API 签名、错误码、能力可用性时使用。先在 `references/INDEX.md` 中 grep 关键词定位目标路径，再 Read 命中的 `.md`，不要遍历目录或一次性读多个文件。

对 HarmonyOS/OpenHarmony 单个 API 进行规则驱动审计，深度分析调用链路，输出 JSONL 格式的审计发现（含调用链路径）和调用链文档。 输入为 JSONL 格式的 API 列表（每行含声明、NAPI映射、Framework接口、实现路径等 8 个字段）。 当用户提供 JSONL 格式的 API 列表并需要对每个 API 逐个进行规范性审计、错误码检查、调用链分析时使用。 触发场景包括：API 级别审计、单个 API 错误码检查、调用链分析、API 规范性扫描、API level scan。

对 HarmonyOS/OpenHarmony 单个 API 进行规则驱动审计，深度分析调用链路，输出 JSONL 格式的审计发现（含调用链路径）和调用链文档。 输入为 JSONL 格式的 API 列表（每行含声明、NAPI映射、Framework接口、实现路径等 8 个字段）。 当用户提供 JSONL 格式的 API 列表并需要对每个 API 逐个进行规范性审计、错误码检查、调用链分析时使用。 触发场景包括：API 级别审计、单个 API 错误码检查、调用链分析、API 规范性扫描、API level scan。

uni-app x / UTS 全栈开发助手。涵盖 UTS 语言规范、uvue 组件开发、HBuilderX CLI、UniCloud 云开发（云函数/云数据库/云存储）。当用户提到 HBuilderX、uni-app x、UTS、uvue、.uts 文件、.uvue 文件、UTSJSONObject、条件编译（#ifdef）、uni_modules 插件、uniCloud、云函数、云数据库、schema.json、uniCloud.callFunction、common/api.uts、聚合模式、action 模式、或需要编写/修复 UTS 代码、处理 UTS 编译错误、将 TypeScript 适配为 UTS 时触发。也适用于 uni-app x 跨平台开发（Android/iOS/鸿蒙/H5/小程序）、使用 HBuilderX CLI 操作、UTS 插件开发、以及 UniCloud 后端开发场景。

为 hispark_hi3519dv500 板卡制作电鸿认证 linux-kernel 加签镜像（uImage-fdt）。当用户提到"kernel 加签"、"制作加签镜像"、"电鸿认证 kernel"、"uImage-fdt"、"hispark_hi3519dv500 kernel 签名"等场景时，请主动使用此 skill，即使用户没有明确说出"加签"这个词。

针对 HarmonyOS 应用的 Ability 劫持和权限绕过漏洞分析,重点关注 Want 参数处理、Ability 启动和隐式调用

HarmonyOS (OpenHarmony) ABC 入口点的安全分析配置

自动化操作浏览器、手机、鸿蒙设备。支持 WEB (Chrome)、ADB (Android)、HDC (HarmonyOS)。当用户要求浏览器操作、手机操作、查询网页信息、自动化任务时使用此 skill。

纯血鸿蒙 Ark 应用开发文档路由技能。将问题映射到主题子文档，并按官方来源优先级给出检索路径。

ArkTS/HarmonyOS 编译修复助手。用于处理 .ets 文件、ArkUI 组件写法、@ohos 包、No overload matches this call、Unexpected token、Cannot find name、 does not meet UI component syntax、类型不匹配、Unknown resource name、 Resource 与 string 混用、对象字面量类型声明、Grid/GridCol 误用、 枚举成员不存在等问题。适合在 coder 编译失败后快速定位根因并给出可编译替代写法。

HarmonyOS 多页面组织助手。用于在开始编码前规划多页面 app 的入口页、页面注册、 main_pages.json、EntryAbility.loadContent、页面跳转方式和导航链路，避免跳板页设计、 避免页面已生成但未注册、避免入口页和路由配置不一致。 适合在 coder 开始写多页面应用时使用。

HarmonyOS/ArkTS 项目结构助手。用于在 ace create 创建项目后快速定位应该修改的 目录和文件，判断页面代码、资源文件、应用名称、图标、模块配置分别放在哪里。 遇到鸿蒙项目骨架理解、页面落位、资源落位、工程入口定位时激活。

地方经济史写作主题Skill。融合杨斌（全球-地方经济叙事）、梁鸿（在场非虚构写作）、 洪震宇（风土经济学写作法）、高晓松（说书式叙事）四位写作者的思维框架。 用途：用经济视角解读地方历史文化，产出适合公众号的叙事性内容。 当用户提到「经济视角写地方」「地方经济史写作」「风土经济」「地方产业故事」时使用。

HarmonyOS / ArkTS 严格语法规则。 **激活条件**（满足任一即激活）： - 用户在写 / 改 .ets 或 .ts 文件，且文件路径含 entry/ / .arkui / harmonyos / ohos - 用户在迁移 TypeScript 代码到 ArkTS - 用户问 arkts-no-* 编译错误 - 用户提到 @kit.* / @ohos.* / Stage 模型 / ArkUI 装饰器 **不激活**：纯 TypeScript / 浏览器 / Node.js 项目（即使语法相似）；React / Vue / 小程序代码。

HarmonyOS Hvigor / OHPM / hdc 工具链 + 错误码诊断。 **激活条件**（满足任一即激活）： - 用户跑 hvigorw / ohpm / hdc 命令时出错 - 用户问构建产物（.hap / .app / .har / .hsp）的差异 / 选型 - 错误码 201 / 202 / 401 / 801 / 9568297 / 9568305 / 9568322 等鸿蒙特定数字 - hilog 日志解读 / hdc fport 端口转发 / NAPI 调试 - 装包到模拟器或真机失败 **不激活**：Android adb / iOS Xcode / Web devtools 调试问题（即使概念相似）。

鸿蒙 ArkTS / ArkUI 代码审查 + 10 大类 75 条规则扫描 + 优先级报告。 **激活条件**（满足任一即激活）： - 用户说"review 这段鸿蒙代码" / "审一下 PR" / "审计 .ets 文件" - 用户问"上线前检查" / "提审前自查" / "技术债梳理" - 多文件 .ets 改动需要做整体性安全 / 性能 / 规范扫描 - 引用了 SEC-* / ARKTS-* / STATE-* / PERF-* / KIT-* / AGC-RJ-* 等规则编号 **不激活**：单纯写一个新组件（用 arkts-rules / state-management）；非鸿蒙代码 review。

在鸿蒙 ArkTS 里调多模态 LLM API（OpenAI Vision / Whisper / DALL-E、Anthropic Vision、Gemini 等）的领域专项。 **激活条件**（满足任一即激活）： - 用户写"调 GPT-4 Vision / Claude Vision / Gemini Vision" - 用户写"上传音频转文字 / Whisper / 语音识别 API" - 用户写"DALL-E / Stable Diffusion / 图像生成 API" - 代码里出现 `ChatMessage.content`、`role: 'user'`、`stream: true` 等 LLM payload 字段 - 代码涉及 SSE 流式解析（`text/event-stream` / `data: ` 前缀行） - 涉及 multipart/form-data 上传（音频 / 视频 / 大文件给 LLM 服务） **不激活**：纯文本 LLM 单轮问答（用普通 @kit.NetworkKit http POST 即可）；本地推理（不调云端 API）。

鸿蒙工程**运行时装配陷阱**——ArkTS 语法无错但项目跑不起来 / 行为不正确的工程层坑。 来源：真实 LLM 对话客户端 app M3-M13 + paseo-harmony Phase A/B 实战反馈。 **激活条件**（满足任一即激活）： - 修改 `build-profile.json5` / `module.json5` / `oh-package.json5` 任意一个 - 改 `resources/*/element/string.json` 或其他资源文件 - 实现主题切换 / 跟随系统外观（涉及 `@StorageLink('appearanceTheme')`） - 在 Web 组件上注册 `javaScriptProxy` / 实现 H5 ↔ ArkTS 桥 - 写多模态 LLM 调用（OpenAI Vision / Whisper / DALL-E 等） - 多模块工程（feature 拆分）+ 模块改名 - HUKS 加密集成（API key / 用户敏感数据落盘） - 替换品牌图标 / 修改 `AppScope/resources/base/media/{background,foreground}.png`（layered icon） - 改 `NavPathStack` 路由 / 在 `build()` 写多个根 container / 实现长列表 timeline - 多 host 共享存储（per-host store 按 serverId 分桶）/ daemon workspaceId 字段消费 **不激活**：纯 UI 组件、纯算法逻辑、单 module hello world。

HarmonyOS 应用签名 + AppGallery Connect 上架流程。 **激活条件**（满足任一即激活）： - 用户提到 .p12 / .cer / .csr / .p7b（签名三件套） - 用户问"自动签名失败" / "签名校验失败 9568322" / "调试证书" - 用户问 AGC / AppGallery Connect / 实名认证 / ICP 备案 - 用户准备提审 / 上架被拒（AGC-RJ-* 编号） - hvigorw assembleApp -p buildMode=release 相关 **不激活**：Android 签名（keytool / jarsigner）；iOS 证书；普通 Web 部署。

鸿蒙应用测试 + 质量评估：hypium 单元测试 / UiTest UI 自动化 / `aa test` 命令行 / 上架前质量工位（AGC 云测·SmartPerf·wukong·Profiler）。 **激活条件**（满足任一即激活）： - 用户说"写测试 / 单元测试 / UI 测试 / 自动化测试 / 测试覆盖率" - 代码或依赖出现 `@ohos/hypium`、`@ohos/hamock`、`@kit.TestKit`、`Driver`、`ON.`、`ohosTest` - 用户跑 `hdc shell aa test` / DevEco "Run Tests" 出错 - 用户问"上架前怎么自测 / 怎么评估 app 质量 / 性能摸底 / 稳定性测试 / 云测" **不激活**：本仓库自身的 tools/test-suite.sh（那是工具包回归，不是鸿蒙 app 测试）；Web/Node 项目的 jest/vitest。

ArkUI Web 组件 + H5 ↔ ArkTS 双向桥（javaScriptProxy / runJavaScript / postMessage）的领域专项。 **激活条件**（满足任一即激活）： - 用户写"ArkUI Web 组件 / 嵌入 H5 / WebView" - 代码出现 `Web({ src: ... })`、`webview.WebviewController`、`javaScriptProxy`、`runJavaScript` - 涉及把 markdown / HTML / 富文本渲染到鸿蒙 app（用 H5 离线渲染器代替原生） - H5 调用 ArkTS（如 `window.reporter.log(...)`）或反向调用 **不激活**：纯 ArkUI 原生组件渲染；Web 浏览器 app（用 Web Browser Kit 而非 ArkUI Web）。

HarmonyOS Hvigor / OHPM / hdc 工具链 + 错误码诊断。 **激活条件**（满足任一即激活）： - 用户跑 hvigorw / ohpm / hdc 命令时出错 - 用户问构建产物（.hap / .app / .har / .hsp）的差异 / 选型 - 错误码 201 / 202 / 401 / 801 / 9568297 / 9568305 / 9568322 等鸿蒙特定数字 - hilog 日志解读 / hdc fport 端口转发 / NAPI 调试 - 装包到模拟器或真机失败 **不激活**：Android adb / iOS Xcode / Web devtools 调试问题（即使概念相似）。