harmonyos-skills-pack 0.1.0

package/README.md

@@ -0,0 +1,230 @@
+# HarmonyOS Skills Pack
+
+Current Version: 0.1.0
+
+这是一个面向 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 极速实现包
+
+其中 starter-kit 已包含：
+
+- 登录模块模板
+- 单机离线 / 免登录模块
+- 游客升级登录同步模块
+- 列表页、详情页、表单页、TabBar 模板
+- 深色模式与多端适配模板
+- Day-by-Day 执行顺序与提审前清单
+
+### 2. universal-product-quality
+
+面向项目无关的通用产品质量校验，覆盖：
+
+- 功能丰富度基线
+- 深色模式可用性
+- 多端适配一致性
+- 风险分级与发布前验证
+- 一键可勾选的通用发布前检查表
+
+## 适用对象
+
+适合以下场景：
+
+- 你想让 Agent 辅助开发 HarmonyOS Ark 项目
+- 你需要一套可复用的鸿蒙开发知识路由
+- 你要做 2025 鸿蒙激励相关项目，想降低卡审风险
+- 你希望把“功能开发”和“发布前质量检查”一起标准化
+
+## 项目特点
+
+- 可安装：支持安装到 Claude 标准技能目录或 Copilot 工作区目录
+- 可同步：维护目录与标准入口目录可一键同步
+- 可发布：已提供 release 打包与校验脚本
+- 可审查：带有提审前检查表、ArkTS 工程规范、静态检查清单和风险专项
+- 可扩展：可以继续追加新的 skill、module、checklist 和模板
+
+## 快速开始
+
+### 1. 克隆仓库
+
+```bash
+git clone <your-repo-url> harmonyos-skills-pack
+cd harmonyos-skills-pack
+```
+
+### 2. 安装到 Claude
+
+```bash
+./scripts/install-skills.sh --claude
+```
+
+安装目标目录：
+
+- ~/.claude/skills/harmonyos-ark
+- ~/.claude/skills/universal-product-quality
+
+### 3. 安装到 Copilot 工作区
+
+```bash
+./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
+
+### 4. 强制覆盖安装
+
+```bash
+./scripts/install-skills.sh --claude --force
+./scripts/install-skills.sh --copilot-workspace /path/to/your/workspace --force
+```
+
+### 5. 维护者同步标准目录
+
+```bash
+./scripts/sync-skills.sh
+```
+
+## 卸载
+
+```bash
+./scripts/uninstall-skills.sh --claude
+./scripts/uninstall-skills.sh --copilot-workspace /path/to/your/workspace
+```
+
+## 项目结构说明
+
+- .claude/skills/
+  - Claude 标准技能入口目录
+- .github/skills/
+  - Copilot 标准技能入口目录
+- skills/
+  - 内容维护目录，作为 canonical source
+- scripts/
+  - 安装、卸载、同步、校验、发布脚本
+- releases/
+  - 生成的 zip 发布包与校验文件
+
+## 发布与维护
+
+常用命令：
+
+```bash
+./scripts/validate-skills.sh
+./scripts/make-release.sh --force
+./scripts/sync-skills.sh
+```
+
+机器可读索引：
+
+- llms.txt
+- SKILLS_MANIFEST.json
+
+## 使用示例 Prompt
+
+下面这些提问方式可以直接帮助 Agent 路由到合适的 skills：
+
+### HarmonyOS Ark 开发
+
+```text
+帮我梳理一个纯血鸿蒙 Ark 项目的目录结构和分层架构
+```
+
+```text
+给我一个带列表页、详情页、表单页的鸿蒙 starter-kit 落地方案
+```
+
+```text
+我这个鸿蒙应用是单机离线工具类，不需要登录，帮我设计启动页和主页结构
+```
+
+```text
+我现在先免登录，后面再加账号同步，帮我设计游客升级登录的数据迁移方案
+```
+
+### ArkTS / ArkUI 学习与路由
+
+```text
+帮我定位 ArkTS 入门、类型系统和装饰器的官方学习路径
+```
+
+```text
+ArkUI 状态管理、页面路由和生命周期要分别看哪些主题文档
+```
+
+```text
+帮我按 ArkTS 规范检查命名、类型使用、装饰器边界、异步错误处理和依赖方向
+```
+
+### 激励与提审
+
+```text
+我准备参加 2025 鸿蒙激励，帮我按工具类 App 做一份提审前检查表
+```
+
+```text
+我的应用有账号登录和媒体上传，按审核风险应该怎么准备材料
+```
+
+```text
+帮我检查这个项目是否满足华为鸿蒙激励 2025 的提审要求
+```
+
+### 通用产品质量检查
+
+```text
+帮我做一次发布前质量体检，重点看功能丰富度、深色模式和多端适配
+```
+
+```text
+给我一份通用的一键发布前检查表，适用于 App 和 Web 项目
+```
+
+### 维护与发布 Skills 包
+
+```text
+帮我同步 skills 到 .claude 和 .github 标准目录
+```
+
+```text
+帮我验证这个 skills 包是否还能正常发布
+```
+
+```text
+帮我重新打一个最新 release 包并生成校验文件
+```
+
+## 说明
+
+- 这是一个通用 Skills 包，不绑定某一个具体业务项目。
+- 安装脚本复制的是完整技能目录，不是只有介绍文件。
+- 若你只需要鸿蒙相关能力，可以单独使用 harmonyos-ark。
+- 涉及 2025 激励规则和提审策略时，最终仍以华为官方当期页面和 AGC 审核要求为准。
+
+## 交流
+
+QQ 群: 1029748283

package/bin/cli.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+
+/**
+ * harmonyos-skills-pack CLI
+ *
+ * 从 GitHub 下载最新 skills 并安装到当前项目的
+ * .claude/skills、.github/skills、.codex/skills 目录。
+ *
+ * 用法:
+ *   npx harmonyos-skills-pack            # 安装到当前目录
+ *   npx harmonyos-skills-pack --help     # 查看帮助
+ *   npx harmonyos-skills-pack --target . # 指定目标目录
+ *   npx harmonyos-skills-pack --claude-only  # 仅安装 .claude/skills
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ── 配置 ──────────────────────────────────────────────
+const REPO = 'yibaiba/harmonyos-skills-pack';
+const BRANCH = 'main';
+const SKILLS = ['harmonyos-ark', 'universal-product-quality'];
+const ARCHIVE_URL = `https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz`;
+
+// ── 颜色输出 ──────────────────────────────────────────
+const color = {
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+
+// ── 参数解析 ──────────────────────────────────────────
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+${color.bold('harmonyos-skills-pack')} — 鸿蒙 Ark AI Agent Skills 一键安装
+
+${color.cyan('用法:')}
+  npx harmonyos-skills-pack              安装到当前目录
+  npx harmonyos-skills-pack --target .   指定目标目录
+  npx harmonyos-skills-pack --force      强制覆盖已有文件
+  npx harmonyos-skills-pack --claude-only    仅 .claude/skills
+  npx harmonyos-skills-pack --copilot-only   仅 .github/skills
+  npx harmonyos-skills-pack --codex-only     仅 .codex/skills
+  npx harmonyos-skills-pack uninstall    移除已安装的 skills
+
+${color.cyan('安装目标:')}
+  .claude/skills/harmonyos-ark/
+  .claude/skills/universal-product-quality/
+  .github/skills/harmonyos-ark/
+  .github/skills/universal-product-quality/
+  .codex/skills/harmonyos-ark/
+  .codex/skills/universal-product-quality/
+
+${color.cyan('Skills 内容:')}
+  harmonyos-ark           84 个文档，覆盖 ArkTS/ArkUI/Stage/路由/状态/网络/Kit
+  universal-product-quality  12 个文档，覆盖产品质量检查/深色模式/多端适配
+`);
+  process.exit(0);
+}
+
+const targetIdx = args.indexOf('--target');
+const targetDir = targetIdx !== -1 ? path.resolve(args[targetIdx + 1] || '.') : process.cwd();
+const force = args.includes('--force');
+const claudeOnly = args.includes('--claude-only');
+const copilotOnly = args.includes('--copilot-only');
+const codexOnly = args.includes('--codex-only');
+const isUninstall = args.includes('uninstall');
+
+// 默认全部安装
+const installTargets = [];
+if (claudeOnly) {
+  installTargets.push('.claude/skills');
+} else if (copilotOnly) {
+  installTargets.push('.github/skills');
+} else if (codexOnly) {
+  installTargets.push('.codex/skills');
+} else {
+  installTargets.push('.claude/skills', '.github/skills', '.codex/skills');
+}
+
+// ── 卸载 ─────────────────────────────────────────────
+if (isUninstall) {
+  console.log(color.yellow('🗑  正在卸载 skills...'));
+  let removed = 0;
+  for (const t of installTargets) {
+    for (const skill of SKILLS) {
+      const skillPath = path.join(targetDir, t, skill);
+      if (fs.existsSync(skillPath)) {
+        fs.rmSync(skillPath, { recursive: true, force: true });
+        console.log(`  ${color.red('✗')} ${skillPath}`);
+        removed++;
+      }
+    }
+  }
+  console.log(removed > 0
+    ? color.green(`\n✅ 已移除 ${removed} 个 skill 目录`)
+    : color.yellow('\n⚠️  未找到已安装的 skills'));
+  process.exit(0);
+}
+
+// ── 安装 ─────────────────────────────────────────────
+console.log(`
+${color.bold('🚀 harmonyos-skills-pack')}
+${color.cyan('从 GitHub 下载最新 skills...')}
+`);
+
+// 创建临时目录
+const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hm-skills-'));
+
+try {
+  // 下载并解压
+  console.log(`  📥 下载 ${ARCHIVE_URL}`);
+
+  try {
+    execSync(`curl -sL "${ARCHIVE_URL}" | tar -xz -C "${tmpDir}"`, {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 60000,
+    });
+  } catch (e) {
+    console.error(color.red('\n❌ 下载失败。请检查网络连接。'));
+    console.error(color.yellow('   可尝试: git clone https://github.com/' + REPO + '.git'));
+    process.exit(1);
+  }
+
+  // 找到解压后的目录
+  const extracted = fs.readdirSync(tmpDir).find((d) =>
+    d.startsWith('harmonyos-skills-pack')
+  );
+  if (!extracted) {
+    console.error(color.red('❌ 解压失败，未找到预期目录'));
+    process.exit(1);
+  }
+  const sourceRoot = path.join(tmpDir, extracted);
+
+  // 复制 skills
+  let installed = 0;
+  for (const target of installTargets) {
+    for (const skill of SKILLS) {
+      const src = path.join(sourceRoot, 'skills', skill);
+      const dst = path.join(targetDir, target, skill);
+
+      if (!fs.existsSync(src)) {
+        console.log(`  ${color.yellow('⚠')} 源文件不存在: skills/${skill}`);
+        continue;
+      }
+
+      if (fs.existsSync(dst)) {
+        if (force) {
+          fs.rmSync(dst, { recursive: true, force: true });
+        } else {
+          console.log(`  ${color.yellow('⏭')} 已存在，跳过: ${dst} (用 --force 覆盖)`);
+          continue;
+        }
+      }
+
+      // 递归复制
+      fs.mkdirSync(path.dirname(dst), { recursive: true });
+      copyDirSync(src, dst);
+      console.log(`  ${color.green('✓')} ${dst}`);
+      installed++;
+    }
+  }
+
+  // 复制 AGENTS.md 和 CLAUDE.md 到项目根目录（如果不存在）
+  for (const f of ['AGENTS.md', 'CLAUDE.md']) {
+    const src = path.join(sourceRoot, f);
+    const dst = path.join(targetDir, f);
+    if (fs.existsSync(src) && (!fs.existsSync(dst) || force)) {
+      fs.copyFileSync(src, dst);
+      console.log(`  ${color.green('✓')} ${f}`);
+    }
+  }
+
+  // 完成
+  console.log(`
+${color.green(color.bold(`✅ 安装完成！${installed} 个 skill 目录已就位。`))}
+
+${color.cyan('下一步:')}
+  1. 打开 AI 编程工具（Claude/Copilot/Codex）
+  2. 开始提问鸿蒙开发问题，Agent 会自动读取 skills
+  3. 示例: "帮我实现一个带登录的鸿蒙应用"
+
+${color.cyan('更多信息:')}
+  GitHub: https://github.com/${REPO}
+  文档:   npx harmonyos-skills-pack --help
+`);
+
+} finally {
+  // 清理临时目录
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+}
+
+// ── 工具函数 ─────────────────────────────────────────
+function copyDirSync(src, dst) {
+  fs.mkdirSync(dst, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const dstPath = path.join(dst, entry.name);
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, dstPath);
+    } else {
+      fs.copyFileSync(srcPath, dstPath);
+    }
+  }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "harmonyos-skills-pack",
+  "version": "0.1.0",
+  "description": "一键安装鸿蒙 Ark 开发文档 + 通用产品质量 skills pack，适配 Claude/Copilot/Codex Agent",
+  "keywords": [
+    "harmonyos",
+    "arkts",
+    "arkui",
+    "skills",
+    "claude",
+    "copilot",
+    "codex",
+    "agent",
+    "ai"
+  ],
+  "author": "yibaiba",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yibaiba/harmonyos-skills-pack.git"
+  },
+  "bin": {
+    "harmonyos-skills-pack": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}