oh-skillhub 0.1.23 → 0.1.24

package/README.md

@@ -7,12 +7,13 @@ This package is designed to run through `npx`:
 ```bash
 npx oh-skillhub@latest
 npx oh-skillhub list
+npx oh-skillhub install --all-common --agent codex --scope user
 npx oh-skillhub install --domain arkui --agent codex
 npx oh-skillhub install --domain arkui --agent all --scope user
 npx oh-skillhub clean --agent claude --scope user --dry-run
 ```
 
-Running without arguments starts a TUI selector. Choose an action first (`Install skills` or `Clean installed skills`). Install then asks for the target (`Codex`, `Claude`, `OpenCode`, or `All`) and skill groups. Clean asks for the target and installed skills to remove.
+Running without arguments starts a TUI selector. Choose an action first (`Install skills` or `Clean installed skills`). Install then asks for the target (`Codex`, `Claude`, `OpenCode`, or `All`) and skill groups. The first skill group is `common / all`, which installs every skill under `skills/common`. Clean asks for the target and installed skills to remove.
 
 In an interactive terminal:
 
@@ -23,20 +24,23 @@ In an interactive terminal:
 When input is piped or the terminal does not support raw key input, enter numbers separated by spaces:
 
 ```bash
-printf "1\n1\n3 9\n" | npx oh-skillhub@latest
+printf "1\n1\n1\n" | npx oh-skillhub@latest
+printf "1\n1\n4 10\n" | npx oh-skillhub@latest
 printf "2\n2\n1\n\n" | npx oh-skillhub@latest
 ```
 
 The old piped installer format is still accepted:
 
 ```bash
-printf "1\n3 9\n" | npx oh-skillhub@latest
+printf "1\n1\n" | npx oh-skillhub@latest
+printf "1\n4 10\n" | npx oh-skillhub@latest
 ```
 
 ## Current Capabilities
 
 - List bundled OpenHarmony skills by domain or stage.
 - Resolve profile/domain selections such as `arkui`, `app-dev`, `cicd`, `testing`, and `security`.
+- Install all common skills in one step with `common / all` in the TUI or `--all-common` in the CLI.
 - Download the selected skill directories from the OpenHarmony skills `release` branch and install the full skill contents.
 - Install skills into Codex, Claude Code, and OpenCode target directories.
 - Support `--agent codex|claude|opencode|all`.
@@ -47,15 +51,16 @@ printf "1\n3 9\n" | npx oh-skillhub@latest
 - Show clean as a first-class option in the default TUI.
 - Move cleaned skills to `.oh-skillhub/trash` by default, with `--purge` for permanent deletion.
 - Run a TUI matching the `skills/common/*` and `skills/domain/*` repository layout.
+- Refresh the skill catalog from the GitCode `release` branch at runtime, with cached and bundled fallback data.
 - Keep anonymous telemetry events in a local retry queue.
 
-The installer uses sparse Git checkout so it downloads only the selected skill directories instead of the whole repository.
+The installer refreshes the catalog with a shallow Git read of the `release` branch. It then uses sparse Git checkout so it downloads only the selected skill directories instead of the whole repository.
 
 ## Commands
 
 ```bash
 oh-skillhub list [--domain <name>] [--stage <name>]
-oh-skillhub install [skill...] [--domain <name>] [--preset <name>] [--agent codex|claude|opencode|all]
+oh-skillhub install [skill...] [--domain <name>] [--preset <name>] [--all-common] [--agent codex|claude|opencode|all]
 oh-skillhub clean [skill...] [--agent codex|claude|opencode|all] [--scope user|project] [--dry-run] [--purge]
 oh-skillhub doctor [--agent codex|claude|opencode|all]
 oh-skillhub telemetry status
@@ -72,6 +77,8 @@ oh-skillhub telemetry status
 Examples:
 
 ```bash
+npx oh-skillhub install --all-common --agent codex --scope user
+npx oh-skillhub install --all-common --agent all --scope user --dry-run
 npx oh-skillhub install --domain arkui --agent claude --scope user
 npx oh-skillhub install --preset app-dev --agent opencode --scope project
 npx oh-skillhub install --domain security --agent all --dry-run
@@ -125,9 +132,8 @@ node bin/oh-skillhub.js install --domain arkui --agent all --scope user --dry-ru
 
 ## First-Version Limits
 
-- Uses a bundled manifest derived from the GitCode `release` branch examples.
-- Does not yet refresh the remote GitCode manifest at runtime.
-- Downloads and installs full skill directories for manifest entries, but does not yet support arbitrary remote skill discovery outside the bundled manifest.
+- `list` and direct `install` commands use the bundled manifest for fast startup; the no-argument TUI refreshes the catalog from GitCode at runtime.
+- Runtime refresh requires `git` on the user's PATH. If refresh fails, the TUI falls back to the cached catalog and then to the bundled manifest.
 - Telemetry collector upload is designed but not yet wired; events are queued locally.
 
 

package/docs/superpowers/plans/2026-05-25-oh-skillhub-cli.md

@@ -2,7 +2,7 @@
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 
-**Goal:** Build a dependency-light npm CLI that can be run with `npx` to list, dry-run install, install, doctor, and inspect telemetry status for OpenHarmony skills.
+**Goal:** Build a dependency-light npm CLI that can be run with `npx` to list, dry-run install, install, one-click install all common skills, doctor, and inspect telemetry status for OpenHarmony skills.
 
 **Architecture:** Implement the CLI in plain Node.js CommonJS so the package works without a build step. Core behavior is split into small modules for manifest loading, profile resolution, agent target resolution, install planning, telemetry queueing, and command rendering.
 
@@ -69,7 +69,7 @@ Expected: PASS.
 
 - [ ] **Step 1: Write failing planner tests**
 
-Tests cover selecting by `--domain arkui`, `--stage development`, explicit skill name, `--all-common`, and deduping common baseline skills in a profile.
+Tests cover selecting by `--domain arkui`, `--stage development`, explicit skill name, `--all-common`, one-click `common / all` TUI selection, and deduping common baseline skills in a profile.
 
 - [ ] **Step 2: Run test to verify it fails**
 
@@ -135,7 +135,7 @@ Use a tiny hand-rolled parser. Implement list, install dry-run, install local fi
 
 - [ ] **Step 4: Update README**
 
-Document `npx` usage, agent support, telemetry controls, and current first-version limits.
+Document `npx` usage, `--all-common`, the `common / all` TUI shortcut, agent support, telemetry controls, runtime catalog refresh, and current first-version limits.
 
 - [ ] **Step 5: Run full verification**
 
@@ -144,4 +144,3 @@ Expected: PASS for all test files.
 
 Run: `npm pack --dry-run`
 Expected: package includes `bin/`, `src/`, `README.md`, `package.json`, and docs.
-

package/docs/superpowers/specs/2026-05-25-npx-skill-installer-design.md

@@ -113,7 +113,7 @@ skills/domain/arkui/development/ohos-dev-arkui-code-review
 
 - 首次运行稳定。
 - 支持远端新增 skills 的自动发现。
-- 用户可以通过 `--offline`、`--refresh` 控制行为。
+- 用户可以通过 `OH_SKILLHUB_OFFLINE=1` 或 `--offline` 使用缓存和包内 manifest。
 - 便于做版本锁定和校验。
 
 取舍：
@@ -145,7 +145,8 @@ npx oh-skillhub list --stage development
 npx oh-skillhub install --domain arkui
 npx oh-skillhub install --preset app-dev
 npx oh-skillhub install ohos-dev-cpp-coding-style
-npx oh-skillhub install --all-common
+npx oh-skillhub install --all-common --agent codex --scope user
+npx oh-skillhub install --all-common --agent all --scope user --dry-run
 npx oh-skillhub install --domain arkui --agent claude --scope user
 npx oh-skillhub install --preset app-dev --agent opencode --scope project
 npx oh-skillhub install --domain security --agent all
@@ -153,7 +154,7 @@ npx oh-skillhub telemetry status
 npx oh-skillhub doctor
 ```
 
-无参数运行时进入 TUI 领域选择，默认安装到 Codex user scope：
+无参数运行时进入 TUI。先选择操作，再选择目标 agent，最后选择 skill 分组。安装分组的第一项是 `common / all`，用于一键安装 `skills/common` 下的全部 skill：
 
 ```bash
 npx oh-skillhub@latest
@@ -162,12 +163,14 @@ npx oh-skillhub@latest
 真实交互终端中使用方向键或 `j/k` 移动，按 `Space` 勾选或取消，按 `Enter` 安装。非 TTY 或管道输入时，使用空格分隔编号选择多个分组，例如：
 
 ```bash
-printf "3 9\n" | npx oh-skillhub@latest
+printf "1\n1\n1\n" | npx oh-skillhub@latest
+printf "1\n1\n4 10\n" | npx oh-skillhub@latest
 ```
 
-推荐交互：
+推荐的一行命令：
 
 ```bash
+npx oh-skillhub install --all-common --agent codex --scope user
 npx oh-skillhub install --domain arkui
 ```
 
@@ -727,10 +730,11 @@ telemetry-queue.jsonl
 
 刷新规则：
 
-- 默认缓存 24 小时。
-- `--refresh` 强制刷新 manifest。
-- `--offline` 只使用内置 manifest 和本地缓存。
-- `--ref <sha>` 用于可复现安装。
+- 无参数 TUI 默认从 GitCode `release` 分支动态刷新 skill catalog。
+- 刷新失败时先使用本地缓存，再降级到包内 bundled manifest。
+- `OH_SKILLHUB_OFFLINE=1` 或 `--offline` 只使用缓存与内置 manifest。
+- `OH_SKILLHUB_SOURCE_DIR` 可指定本地 skill 仓用于测试或内网镜像。
+- 直接 `list` 与 `install` 命令保持快速启动，当前使用 bundled manifest；其中 `install --all-common` 会选择 bundled manifest 中全部 `scope=common` 的 skill。
 
 ## 13. 测试策略
 
@@ -761,8 +765,10 @@ telemetry-queue.jsonl
 ```bash
 npx oh-skillhub list --domain arkui
 npx oh-skillhub install --domain arkui --target ./tmp-skills --dry-run
+npx oh-skillhub install --all-common --agent codex --scope user --dry-run
 npx oh-skillhub install ohos-dev-cpp-coding-style --target ./tmp-skills
 npx oh-skillhub install --domain arkui --agent all --scope user --dry-run
+npx oh-skillhub@latest
 npx oh-skillhub doctor --agent all
 npx oh-skillhub telemetry status
 npx oh-skillhub doctor --target ./tmp-skills
@@ -814,13 +820,13 @@ npx oh-skillhub doctor --target ./tmp-skills
 - `--scope user|project`
 - `--target`
 - `--dry-run`
-- `--refresh`
 - `--offline`
-- `--force`
 - `--no-telemetry`
 
 暂缓：
 
+- `--refresh` 强制刷新。
+- `--force` 覆盖安装。
 - 图形化交互。
 - 多 registry 源。
 - skill 评分与推荐。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-skillhub",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "OpenHarmony Skills installer for Codex, Claude Code, and OpenCode.",
   "type": "commonjs",
   "bin": {

package/src/cli.js

@@ -1207,12 +1207,13 @@ function helpText() {
     "",
     "Commands:",
     "  list [--domain <name>] [--stage <name>]",
-    "  install [skill...] [--domain <name>] [--preset <name>] [--agent codex|claude|opencode|all]",
+    "  install [skill...] [--domain <name>] [--preset <name>] [--all-common] [--agent codex|claude|opencode|all]",
     "  clean [skill...] [--agent codex|claude|opencode|all] [--scope user|project] [--dry-run] [--purge]",
     "  doctor [--agent codex|claude|opencode|all]",
     "  telemetry status",
     "",
     "Examples:",
+    "  npx oh-skillhub install --all-common --agent codex --scope user",
     "  npx oh-skillhub install --domain arkui --agent all --scope user",
   ].join("\n");
 }