harmonyos-dev-suite

Routes HarmonyOS development tasks across ArkTS, ArkUI, build, debug, testing, and device workflows.

7.1k|1.1k|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/openJiuwen-ai/jiuwenswarm --skill harmonyos-dev-suite
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harmonyos-dev-suite
Source: https://github.com/openJiuwen-ai/jiuwenswarm/tree/main/jiuwenswarm/resources/agent/workspace/skills/harmonyos-dev-suite
Command: npx skills add https://github.com/openJiuwen-ai/jiuwenswarm --skill harmonyos-dev-suite

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

HarmonyOS development spans many tools and domains—ArkTS language rules, ArkUI components, DevEco CLI builds, device logs, multi-device adaptation, and stability diagnosis—making it hard to know which workflow or specialist knowledge applies to a given task. This Skill acts as a unified entrypoint that detects project context, routes the task to the right workflow, and indexes 83 optional atomic Skills for deeper specialization.

Core Features & Use Cases

  • Task Routing: Classifies requests into ArkUI, ArkTS, build/run/device, multi-device adaptation, stability/DFX diagnosis, testing, atomic services, or native C++ development, then loads only the relevant workflow reference.
  • DevEco CLI Integration: Prefers devecocli commands for build, run, device, emulator, and log operations, with the official HarmonyOS Developer Knowledge MCP for documentation lookups.
  • Atomic Skill Catalog: Ships a human-readable catalog and machine-readable JSON manifest of 83 optional HarmonyOS atomic Skills, plus a safe installer script with symlink and path-escape validation.
  • Use Case: A developer asks to fix an ArkUI page that crashes on a foldable device. The suite detects the HarmonyOS project, routes to the multi-device and stability workflows, and suggests installing hmos-multidevice-fold-state or hmos-jscrash-analysis only if deeper specialization is needed.

Quick Start

Ask the agent to help build, debug, test, or adapt your HarmonyOS app, for example by requesting that it diagnose a crash log or add an ArkUI page to your project.

Frequently Asked Questions about harmonyos-dev-suite

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and run a HarmonyOS app from the command line?

Use devecocli commands such as devecocli build, devecocli run, and devecocli device list, which this Skill prefers over direct hvigor or hdc calls. Identify the project root via build-profile.json5 or oh-package.json5 before running any build command.

How do I analyze HarmonyOS crash and freeze logs?

Classify the artifact first as a JS crash, C++ crash, app freeze, API fault, or memory leak, then route to the matching DFX atomic Skill such as hmos-jscrash-analysis or hmos-appfreeze-analysis. Preserve raw faultlog files and stack traces before proposing fixes.

What are HarmonyOS atomic Skills and when should I install them?

Atomic Skills are 83 optional specialist Skills indexed in the catalog, covering areas like ArkUI development, Push Kit, multi-device adaptation, and testing. Install one only when a task requires repeated deep specialization, using the install_atomic_skill.py script with a local source checkout.

Does this Skill support HarmonyOS multi-device and foldable adaptation?

Yes, it routes multi-device tasks through hmos-multidevice-scenario-entry and classifies issues into screen/window size, fold state, avoid areas, natural orientation, interaction methods, or hardware access. Specialist atomic Skills handle each adaptation category.

Can I query official HarmonyOS API documentation through this Skill?

Yes, it prefers the official HarmonyOS Developer Knowledge MCP using searchDocuments followed by getDocumentsById for full content, limited to 10 documents per call. When the MCP is unavailable, it falls back to devecocli docs search and devecocli docs read.

When should I not use this Skill for HarmonyOS tasks?

Avoid running builds, emulators, or log following without a confirmed project path and clear user intent, as the Skill's safety rules require project detection first. For pure conceptual questions, it answers as guidance rather than executing device commands.