harveyz-skill 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-06-09
+
+### Added
+- `hskill list`：新增 Bundle 列并按 bundle 名称排序（替换旧的分组标题格式）；`hskill status` skills 列表同步增加 Bundle 列
+
+### Changed
+- `hskill` 内部重构：平台列表从 `SKILL_TARGETS` 单一来源派生，消除 `bundles.js` / `preview.mjs` 中的硬编码数组
+
+### Fixed
+- `url-extract`：移除 `SKILL_DIR` 用户配置变量
+- `preview`：安装状态侧边栏补全 openclaw、hermes 平台（USER LEVEL）
+- `npm-release`：中间步骤跳过 push 操作，最终统一给出推送 + 发布指令清单
+
 ## [0.10.0] - 2026-06-08
 
 ### Added

package/bin/cli.js

@@ -158,29 +158,31 @@ if (subcommand === 'update') {
 
 // ── List ─────────────────────────────────────────────────────────────────────
 if (subcommand === 'list') {
-  const { bundleMeta, skills, tools = [] } = require('../skills-index.json')
-  const byBundle = {}
-  for (const s of skills) {
-    if (!byBundle[s.bundle]) byBundle[s.bundle] = []
-    byBundle[s.bundle].push(s.path)
-  }
+  const { skills, tools = [] } = require('../skills-index.json')
+  const sorted = [...skills].sort((a, b) => a.bundle.localeCompare(b.bundle) || a.path.split('/').pop().localeCompare(b.path.split('/').pop()))
   if (jsonFlag) {
-    const bundles = {}
-    for (const [name, paths] of Object.entries(byBundle)) {
-      bundles[name] = { description: bundleMeta[name] ?? name, skills: paths }
-    }
-    console.log(JSON.stringify({ bundles, tools: tools.map(t => t.name) }, null, 2))
+    console.log(JSON.stringify({
+      skills: sorted.map(s => ({ name: s.path.split('/').pop(), path: s.path, bundle: s.bundle })),
+      tools: tools.map(t => t.name),
+    }, null, 2))
     process.exit(0)
   }
-  for (const [name, paths] of Object.entries(byBundle)) {
-    console.log(chalk.bold(name) + ' — ' + (bundleMeta[name] ?? name))
-    for (const p of paths) console.log('  ' + p)
+  const nw = Math.max(...sorted.map(s => s.path.split('/').pop().length), 4)
+  const bw = Math.max(...sorted.map(s => s.bundle.length), 6)
+  const sep = chalk.dim('  ' + '─'.repeat(nw + bw + 4))
+  console.log('')
+  console.log('  ' + chalk.bold('NAME'.padEnd(nw)) + '  ' + chalk.bold('BUNDLE'))
+  console.log(sep)
+  for (const s of sorted) {
+    console.log('  ' + s.path.split('/').pop().padEnd(nw) + '  ' + chalk.dim(s.bundle))
   }
   if (tools.length > 0) {
     console.log('')
-    console.log(chalk.bold('shell tools:'))
+    console.log('  ' + chalk.bold('SHELL TOOLS'))
+    console.log(sep)
     for (const t of tools) console.log('  ' + t.name)
   }
+  console.log('')
   process.exit(0)
 }
 
@@ -208,11 +210,11 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   const skillRows = skillItems.map(s => {
     const inst = checkInstalled(s.skillName, s.version ?? '—')
     return {
-      name: s.skillName, version: s.version ?? '—',
+      name: s.skillName, bundle: s.bundle ?? '—', version: s.version ?? '—',
       userStatus: scopeSummary(inst.user), projectStatus: scopeSummary(inst.project),
       userDetail: inst.user, projectDetail: inst.project,
     }
-  })
+  }).sort((a, b) => a.bundle.localeCompare(b.bundle) || a.name.localeCompare(b.name))
   const toolRows = toolItems.map(t => {
     const inst = checkToolInstalled(t.toolName, t.srcPath)
     return { name: t.toolName, version: t.version ?? '—', ...inst }
@@ -285,15 +287,16 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   const allVers  = [...skillRows, ...toolRows].map(r => r.version)
   const nw = Math.max(...allNames.map(n => n.length), 4)
   const vw = Math.max(...allVers.map(v => v.length), 7)
-  const sep = chalk.dim('  ' + '─'.repeat(nw + vw + 20))
+  const bw = Math.max(...skillRows.map(r => r.bundle.length), 6)
+  const sep = chalk.dim('  ' + '─'.repeat(nw + vw + bw + 22))
 
   console.log('')
   console.log('  ' + chalk.bold('SKILLS') + chalk.dim(`  — ${skillRows.length} available`))
   console.log(sep)
-  console.log('  ' + ''.padEnd(nw + vw + 3) + chalk.dim('user    project'))
+  console.log('  ' + ''.padEnd(nw + vw + bw + 5) + chalk.dim('user    project'))
   for (const r of skillRows) {
     const u = icon(r.userStatus), p = icon(r.projectStatus)
-    console.log('  ' + r.name.padEnd(nw) + '  ' + chalk.dim(r.version.padEnd(vw)) + '  ' + u + '       ' + p)
+    console.log('  ' + r.name.padEnd(nw) + '  ' + chalk.dim(r.version.padEnd(vw)) + '  ' + chalk.dim(r.bundle.padEnd(bw)) + '  ' + u + '       ' + p)
   }
 
   console.log('')

package/bin/preview.mjs

@@ -3,6 +3,7 @@ import fs from 'fs'
 import os from 'os'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { SKILL_TARGETS, USER_ONLY_TARGETS } from '../lib/targets.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
@@ -72,10 +73,11 @@ function statusLine(version, status) {
   return ver + '  ' + D + '— not installed' + R
 }
 
-const targets = ['claude', 'cursor', 'codex']
+const userTargets    = SKILL_TARGETS
+const projectTargets = SKILL_TARGETS.filter(t => !USER_ONLY_TARGETS.has(t))
 const home    = os.homedir()
 
-function checkScope(dirFn) {
+function checkScope(targets, dirFn) {
   return targets.map(t => {
     const ver    = readVersion(path.join(dirFn(t), skillName))
     const status = ver === '—' ? 'none'
@@ -86,10 +88,10 @@ function checkScope(dirFn) {
 }
 
 const cwd = process.cwd()
-const userDetails    = checkScope(t => path.join(home, `.${t}`, 'skills'))
+const userDetails    = checkScope(userTargets,    t => path.join(home, `.${t}`, 'skills'))
 const projectDetails = cwd === home
-  ? targets.map(t => ({ tool: t, version: '—', status: 'none' }))
-  : checkScope(t => path.join(cwd, `.${t}`, 'skills'))
+  ? projectTargets.map(t => ({ tool: t, version: '—', status: 'none' }))
+  : checkScope(projectTargets, t => path.join(cwd, `.${t}`, 'skills'))
 
 console.log(B + skillName + R)
 console.log(D + 'available: ' + R + availableVersion)

package/lib/bundles.js

@@ -3,7 +3,7 @@ import os from 'os'
 import { createRequire } from 'module'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { USER_ONLY_TARGETS } from './targets.js'
+import { SKILL_TARGETS, USER_ONLY_TARGETS } from './targets.js'
 
 const require = createRequire(import.meta.url)
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -101,13 +101,14 @@ export function buildAllChoices() {
   return choices
 }
 
-// 所有 skill 展开为 { kind:'skill', skillName, srcPath } 列表（对应 all 选项）
+// 所有 skill 展开为 { kind:'skill', skillName, bundle, srcPath } 列表（对应 all 选项）
 export function getAllSkillItems() {
   return skillDefs.map(skill => {
     const srcPath = path.join(skillsRoot, skill.path)
     return {
       kind: 'skill',
       skillName: skill.path.split('/').pop(),
+      bundle: skill.bundle,
       srcPath,
       version: readVersion(srcPath),
     }
@@ -132,7 +133,7 @@ export function getAllToolItems() {
 // 每个工具: { version: string, status: 'up-to-date'|'update'|'none' }
 export function checkInstalled(skillName, availableVersion) {
   const home = os.homedir()
-  const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+  const targets = SKILL_TARGETS
 
   function checkScope(dirFn) {
     const result = {}

package/lib/targets.js

@@ -1,7 +1,7 @@
 import os from 'os'
 import path from 'path'
 
-const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
 
 export const USER_ONLY_TARGETS = new Set(['openclaw', 'hermes'])
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {

package/skills/meta/npm-release/SKILL.md

@@ -2,12 +2,14 @@
 name: npm-release
 description: "Complete npm publish workflow for harveyz-skill: bump version, update CHANGELOG, create release branch, merge to staging then main, tag, and publish to npm. Use this skill whenever the user wants to release, publish, cut a version, bump version, ship to npm, or deploy a new package version."
 user_invocable: true
-version: "1.0.0"
+version: "1.1.0"
 ---
 
 # npm-release
 
-harveyz-skill 发布到 npm 的完整流程：版本号升级 → CHANGELOG 更新 → 分支提交 → 合并到 staging → 合并到 main → 打 tag → npm publish。
+harveyz-skill 发布到 npm 的完整流程：版本号升级 → CHANGELOG 更新 → 分支提交 → 本地合并到 staging 和 main → 打 tag → 给出推送 + 发布指令供用户执行。
+
+**说明**：所有 `git push` 和 `npm publish` 操作由用户自行执行，Claude 只做本地操作，最后统一给出指令清单。
 
 ---
 
@@ -111,44 +113,66 @@ git commit -m "chore(release): bump version to <new-version>"
 
 ---
 
-## Step 5 — 合并到 staging
+## Step 5 — 本地合并到 staging（不推送）
 
 ```bash
 git checkout staging
 git merge release/<new-version>
-git push origin staging
 ```
 
+只做本地合并，不执行 push。
+
 ---
 
-## Step 6 — 合并到 main 并打 tag
+## Step 6 — 本地合并到 main 并打 tag（不推送）
 
 ```bash
 git checkout main
-git pull origin main
+git pull origin main          # 只拉取，确保本地 main 是最新的
 git merge staging
 git tag -a v<new-version> -m "v<new-version>"
-git push origin main
-git push origin v<new-version>
 ```
 
 tag 使用 annotated tag（`-a`），符合项目 workflow-config.yml 的 `require_annotated: true` 规则。
 
+**不执行任何 push**，推送操作统一在最后由用户执行。
+
 ---
 
-## Step 7 — npm publish
+## Step 7 — 给出最终执行清单
 
-```bash
+本地准备工作已完成。向用户展示以下指令，请用户依次确认并手动执行：
+
+---
+
+```
+== 待执行：推送 + 发布 ==
+
+# 1. 推送 staging
+git push origin staging
+
+# 2. 推送 main 和 tag
+git push origin main
+git push origin v<new-version>
+
+# 3. 发布到 npm（需要已登录：npm login）
 npm publish
 ```
 
-如果报错（比如登录态过期），提示用户先运行 `npm login`，然后重试。
+---
+
+说明：
+- 如果 `npm login` 状态已过期，先运行 `npm login` 再执行 `npm publish`
+- 如果 `git push origin main` 被 pre-push hook 拒绝，检查 tag 格式是否为 `v<X>.<Y>.<Z>`，以及是否是 annotated tag
+- 以上命令需在项目根目录执行
+
+用户执行完毕后，告知 Claude，Claude 会输出最终摘要。
 
 ---
 
-## Step 8 — 收尾
+## Step 8 — 收尾（用户执行完毕后）
 
-发布成功后输出摘要：
+用户确认推送和发布成功后输出摘要：
 
 ```
 ✓ 版本 v<new-version> 已发布

package/skills/web-fetch/url-extract/platforms/SKILL.claude.md

@@ -25,7 +25,6 @@ sessions_spawn \
 | 抽象变量 | 实际语法 |
 |----------|----------|
 | `VAULT_PATH` | `{{VAULT_PATH}}` |
-| `SKILL_DIR` | `{{SKILL_DIR}}` |
 | `CHROME_PROFILE` | `{{CHROME_PROFILE}}` |
 
-执行 SKILL.md 中的代码时，将所有 `VAULT_PATH`、`SKILL_DIR`、`CHROME_PROFILE` 占位替换为对应的 `{{变量名}}`，由 vars.json 注入实际值。
+`SKILL_DIR` 由平台自动提供，无需用户配置：值固定为 `$HOME/.claude/skills/url-extract`（Claude Code skill 的标准安装路径）。执行代码时直接将 `SKILL_DIR` 替换为该路径。

package/skills/web-fetch/url-extract/platforms/SKILL.codex.md

@@ -14,4 +14,6 @@
 
 ## ③ 变量注入
 
-通过环境变量或 Codex 平台的变量系统注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`SKILL_DIR`、`CHROME_PROFILE` 占位。
+通过环境变量或 Codex 平台的变量系统注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`CHROME_PROFILE` 占位。
+
+`SKILL_DIR` 由平台自动提供，无需用户配置：值为 Codex 安装本 skill 的目录（即包含 `scripts/` 的那一级目录）。

package/skills/web-fetch/url-extract/platforms/SKILL.hermes.md

@@ -14,4 +14,6 @@
 
 ## ③ 变量注入
 
-通过 Hermes vars.json 或环境变量注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`SKILL_DIR`、`CHROME_PROFILE` 占位。
+通过 Hermes vars.json 或环境变量注入，执行 SKILL.md 中的代码时直接使用实际值替换 `VAULT_PATH`、`CHROME_PROFILE` 占位。
+
+`SKILL_DIR` 由平台自动提供，无需用户配置：值为 Hermes 安装本 skill 的目录（即包含 `scripts/` 的那一级目录）。

package/skills/web-fetch/url-extract/vars.json

@@ -4,11 +4,6 @@
     "description": "Obsidian Reading 目录完整路径（例如 /Users/you/Vault/Product/Reading）",
     "default": "{{HOME}}/Vault/Product/Reading"
   },
-  {
-    "name": "SKILL_DIR",
-    "description": "url-extract skill 安装后的完整路径（用于定位辅助脚本和数据库文件）",
-    "default": "{{HOME}}/.claude/skills/url-extract"
-  },
   {
     "name": "CHROME_PROFILE",
     "description": "Chrome 用户配置目录（X.com 登录态所需）。macOS 默认：~/Library/Application Support/Google/Chrome/Profile 2",