JCSDK Harmony Skills

本仓库提供一组面向 HarmonyOS NEXT JCSDK 集成的 AI Coding Agent Skills，目标是让智能助手在处理 Juphoon JCSDK HarmonyOS 接入、空工程创建、ArkTS 代码生成与 Hvigor 构建验证时，优先输出一致、可执行、可校验的方案。

Skills 概览

本仓库包含以下 Skill：

Skill	说明
jcsdk-harmony-integration	JCSDK HarmonyOS 集成主技能，负责场景路由、SDK 接入规范、AppKey 配置规范与模块文档索引
harmony-build	HarmonyOS 工程构建助手，负责 ohpm 安装、Hvigor 构建与基本验证
harmony-empty-project	HarmonyOS NEXT 空工程模板生成器，负责先创建可运行宿主工程
harmony-arkts-dev-assistant	ArkTS 与 ArkUI 开发规范助手，负责代码风格、类型安全与 ArkTSCheck 约束

设计约束

• HarmonyOS 空工程创建统一使用内置 Skill：harmony-empty-project
• HarmonyOS ArkTS 代码生成与重构统一使用内置 Skill：harmony-arkts-development-assistant
• HarmonyOS 工程构建验证统一使用内置 Skill：harmony-build
• JCSDK 集成文档统一使用 cn 目录下各模块的 HarmonyOS 文档作为业务能力参考
• JCSDK Harmony 接入统一优先使用 @juphoon/jcsdk 在线导入，默认依赖版本为 ^2.16.4，仅在受限环境下补充本地 HAR 方案
• AppKey、账号、Token 等业务配置必须从独立配置模块读取，不直接散落硬编码在页面逻辑中

jcsdk-harmony-integration 的职责

主 Skill 不重复维护 HarmonyOS 空工程模板和 ArkTS 通用规范，只负责：

• 判断业务场景属于一对一音频、视频、多人音视频还是其他扩展场景
• 将请求路由到 cn 目录下对应模块的 HarmonyOS 文档
• 输出统一的 HarmonyOS 在线依赖接入方案，默认先给出在线导入步骤，本地 HAR 包接入仅作为备选说明
• 约束 AppKey、登录信息、Token 使用独立配置文件或常量模块统一管理
• 在需要时显式委托 harmony-empty-project、harmony-build 和 harmony-arkts-development-assistant

模块文档来源

技能主要复用以下中文模块文档中的 HarmonyOS 页面：

• cn/00_o2o_audio
• cn/01_o2o_video
• cn/02_mult_audio
• cn/03_mult_video

每个模块下优先使用：

• README.md 了解产品与场景
• 03_quick_start/00_dev_environment/HarmonyOS.md 处理环境准备与 SDK 集成
• 03_quick_start/01_login/HarmonyOS.md 处理初始化与登录
• 03_quick_start/02_achieve/HarmonyOS.md 处理核心场景实现

推荐配置方式

推荐在 entry 模块下单独维护配置文件，例如 src/main/ets/common/JcConfig.ets：

export class JcConfig {
  static readonly APP_KEY: string = 'please-replace-with-your-appkey';
  static readonly USER_ID: string = 'please-replace-with-user-id';
  static readonly PASSWORD: string = 'please-replace-with-password';
}

在业务管理类中读取配置，而不是直接写字面量。导包统一使用 from '@juphoon/jcsdk'：

import { JCClient } from '@juphoon/jcsdk';
import { JcConfig } from '../common/JcConfig';

this.client = JCClient.create(context, JcConfig.APP_KEY, this, createParam);
this.client?.login(JcConfig.USER_ID, JcConfig.PASSWORD, loginParam);

在 entry/oh-package.json5 中声明在线依赖：

{
  "dependencies": {
    "@juphoon/jcsdk": "^2.16.4"
  }
}

目录结构

jcsdk-harmony-skills/
├── SKILL.md
├── README.md
├── cn/
│   ├── 00_o2o_audio/
│   ├── 01_o2o_video/
│   ├── 02_mult_audio/
│   └── 03_mult_video/
├── scripts/
│   └── install-skills.sh
└── skills/
    ├── harmony-arkts-dev-assistant/
    ├── harmony-build/
    ├── harmony-empty-project/
    └── jcsdk-harmony-integration/
        ├── SKILL.md
        └── harmony/
            ├── reference.md
            └── empty-project.md

安装与注册

这个仓库是一个 skills 集合，不是把整个目录直接丢进 .copilot/ 根目录后就会自动展开注册的结构。

支持两种可用方式：

1. 单入口模式

将整个仓库目录放到 .copilot/skills/jcsdk-harmony-skills/。

由于仓库根目录现在包含 SKILL.md，代理可以把整个仓库识别为一个入口 skill，再按内部路由使用各子技能和文档。

1. 平铺注册模式

运行 ./scripts/install-skills.sh，默认会把 skills/* 下的四个独立 skill 软链接到 ~/.copilot/skills/。

这样代理会把它们分别识别为独立 skill，发现效果最好。

如果你之前是把整个仓库直接放在 .copilot/ 根目录，例如 .copilot/jcsdk-harmony-skills/，那一层通常不会自动展开扫描到内部的 skills/*，因此会出现“agent 找不到 skill”的现象。

使用方式

推荐先用上面的任一方式完成注册，再在以下场景中使用：

• 让助手从零创建 HarmonyOS NEXT 宿主工程并接入 JCSDK
• 让助手给已有 HarmonyOS 工程补充 JCSDK 在线依赖配置、导包和权限声明
• 让助手根据业务模块实现初始化、登录、通话、频道等逻辑
• 让助手执行 ohpm 安装、Hvigor 构建验证并排查 ArkTSCheck 或资源配置问题

许可证

本项目仅供授权环境内使用。