HarmonyOS Skills Pack

Current Version: 0.1.10

这是一个面向 Claude、GitHub Copilot、Codex 等 Coding Agent 的可安装 Skills 项目。

它的目标不是提供某个具体业务应用，而是沉淀一套可复用的鸿蒙 Ark 开发知识、提审避坑经验和通用产品质量检查能力，让 Agent 在做 HarmonyOS 项目时能直接调用这些结构化资产。

项目定位

这个仓库解决的是两个问题：

1. HarmonyOS Ark 项目从 0 到 1 落地时，如何快速得到可执行的目录结构、模块模板、执行顺序和提审清单。
2. 在正式发布前，如何统一检查功能丰富度、深色模式、多端适配、风险等级和审核材料完整性。

换句话说，这个仓库是一个“可发布的 Skills 发行包”，不是单一 Demo，也不是某个 App 的源码仓库。

包含内容

当前版本包含两个核心技能和一个子技能：

1. harmonyos-ark

面向纯血鸿蒙 Ark 应用开发，覆盖：

• ArkTS、ArkUI、Stage/Ability、路由生命周期
• 网络请求、本地存储、媒体与设备能力
• 测试、签名、打包、上架发布
• 2025 创作激励与审核避坑
• Starter Kit 极速实现包（16 模块）

其中 starter-kit 已包含 16 个模块模板：

• 登录模块、单机离线/免登录、游客升级登录同步
• 列表页、详情页、表单页、TabBar 导航、抽屉导航
• 深色模式与多端适配模板
• 状态管理最佳实践
• 本地数据持久化、后台任务、通知处理
• WebSocket 实时通信、相机与媒体、支付与计费
• Day-by-Day 执行顺序与提审前清单

1.1 arkts-modernization-guard（子技能）

ArkTS 编译现代化守卫，自动扫描代码中的已知坑：

• 12 条扫描规则（P0/P1/P2 分级）
• 自动检测 @Prop 函数回调、FontWeight.Black、deprecated API 等
• 20+ 错误码→修复方案映射表
• 12 个 diff 格式代码替换模板
• bash 扫描脚本，可集成 CI/CD

2. universal-product-quality

面向项目无关的通用产品质量校验，覆盖：

• 功能丰富度基线
• 深色模式可用性
• 多端适配一致性
• 风险分级与发布前验证
• 一键可勾选的通用发布前检查表

适用对象

适合以下场景：

• 你想让 Agent 辅助开发 HarmonyOS Ark 项目
• 你需要一套可复用的鸿蒙开发知识路由
• 你要做 2025 鸿蒙激励相关项目，想降低卡审风险
• 你希望把“功能开发”和“发布前质量检查”一起标准化

项目特点

• 可安装：支持安装到 Claude 标准技能目录或 Copilot 工作区目录
• 可同步：维护目录与标准入口目录可一键同步
• 可发布：已提供 release 打包与校验脚本
• 可审查：带有提审前检查表、ArkTS 工程规范、静态检查清单和风险专项
• 可扩展：可以继续追加新的 skill、module、checklist 和模板

快速开始

方式 1：npx 一键安装（推荐）

# 安装到当前项目（自动安装到 .claude/.github/.codex/skills）
npx harmonyos-skills-pack

# 国内用户加速
npx harmonyos-skills-pack --mirror

# 仅安装到 Claude
npx harmonyos-skills-pack --claude-only

# 仅安装到 Copilot
npx harmonyos-skills-pack --copilot-only

# 仅安装到 Codex
npx harmonyos-skills-pack --codex-only

# 强制覆盖已有文件
npx harmonyos-skills-pack --force

# 卸载
npx harmonyos-skills-pack uninstall

方式 2：克隆仓库 + 脚本安装

git clone https://github.com/yibaiba/harmonyos-skills-pack.git
cd harmonyos-skills-pack

安装到 Claude

./scripts/install-skills.sh --claude

安装目标目录：

• ~/.claude/skills/harmonyos-ark
• ~/.claude/skills/universal-product-quality

安装到 Copilot 工作区

./scripts/install-skills.sh --copilot-workspace /path/to/your/workspace

安装目标目录：

• /path/to/your/workspace/.github/skills/harmonyos-ark
• /path/to/your/workspace/.github/skills/universal-product-quality

强制覆盖安装

./scripts/install-skills.sh --claude --force
./scripts/install-skills.sh --copilot-workspace /path/to/your/workspace --force

维护者同步标准目录

./scripts/sync-skills.sh

卸载

./scripts/uninstall-skills.sh --claude
./scripts/uninstall-skills.sh --copilot-workspace /path/to/your/workspace

项目结构说明

• skills/
  • 内容维护目录，作为 canonical source
  • harmonyos-ark/ — 鸿蒙 Ark 开发技能（52 主题 + starter-kit + 清单）
    • arkts-modernization-guard/ — ArkTS 编译现代化守卫（子技能）
  • universal-product-quality/ — 通用产品质量检查技能
• .claude/skills/
  • Claude 标准技能入口目录（由 sync-skills.sh 生成）
• .github/skills/
  • Copilot 标准技能入口目录（由 sync-skills.sh 生成）
• bin/
  • npx CLI 安装器
• scripts/
  • 安装、卸载、同步、校验、发布脚本
• releases/
  • 生成的 zip 发布包与校验文件

发布与维护

常用命令：

./scripts/validate-skills.sh
./scripts/make-release.sh --force
./scripts/sync-skills.sh

机器可读索引：

• llms.txt
• SKILLS_MANIFEST.json

使用示例 Prompt

下面这些提问方式可以直接帮助 Agent 路由到合适的 skills：

HarmonyOS Ark 开发

帮我梳理一个纯血鸿蒙 Ark 项目的目录结构和分层架构

给我一个带列表页、详情页、表单页的鸿蒙 starter-kit 落地方案

我这个鸿蒙应用是单机离线工具类，不需要登录，帮我设计启动页和主页结构

我现在先免登录，后面再加账号同步，帮我设计游客升级登录的数据迁移方案

ArkTS / ArkUI 学习与路由

帮我定位 ArkTS 入门、类型系统和装饰器的官方学习路径

ArkUI 状态管理、页面路由和生命周期要分别看哪些主题文档

帮我按 ArkTS 规范检查命名、类型使用、装饰器边界、异步错误处理和依赖方向

ArkTS 编译错误排查

编译报错 10505001，帮我定位根因和修复方案

帮我扫描项目中的 deprecated API 和已知编译坑，给出替换建议

运行 arkts-modernization-guard 扫描，检查是否有 @Prop 回调、FontWeight.Black 等问题

激励与提审

我准备参加 2025 鸿蒙激励，帮我按工具类 App 做一份提审前检查表

我的应用有账号登录和媒体上传，按审核风险应该怎么准备材料

帮我检查这个项目是否满足华为鸿蒙激励 2025 的提审要求

通用产品质量检查

帮我做一次发布前质量体检，重点看功能丰富度、深色模式和多端适配

给我一份通用的一键发布前检查表，适用于 App 和 Web 项目

维护与发布 Skills 包

帮我同步 skills 到 .claude 和 .github 标准目录

帮我验证这个 skills 包是否还能正常发布

帮我重新打一个最新 release 包并生成校验文件

说明

• 这是一个通用 Skills 包，不绑定某一个具体业务项目。
• 安装脚本复制的是完整技能目录，不是只有介绍文件。
• 若你只需要鸿蒙相关能力，可以单独使用 harmonyos-ark。
• 涉及 2025 激励规则和提审策略时，最终仍以华为官方当期页面和 AGC 审核要求为准。

交流

QQ 群: 1029748283