harveyz-skill 0.3.0 → 0.4.0

package/README.md

@@ -4,7 +4,7 @@ Harvey 的个人 Claude Code 技能仓库。
 
 ## 技能清单
 
-按 bundle 分组，`npx harveyz-skill --bundle <bundle>` 安装对应分组。
+按 bundle 分组，`hskill install --bundle <bundle>` 安装对应分组。
 
 ### analysis — 分析工具
 
@@ -63,7 +63,7 @@ Harvey 的个人 Claude Code 技能仓库。
 
 ## 工具清单
 
-Shell 工具，通过 `npx harveyz-skill --bundle shell-tools` 安装。
+Shell 工具，通过 `hskill install --tool p-launch` 安装。
 
 | 工具 | 说明 |
 |------|------|
@@ -74,50 +74,39 @@ Shell 工具，通过 `npx harveyz-skill --bundle shell-tools` 安装。
 
 ## 安装
 
-### 推荐：npx 一键安装
-
 ```bash
-npx harveyz-skill
+npm install -g harveyz-skill
 ```
 
-交互式选择 bundle 和目标工具（Claude Code / Cursor / Codex）。
+安装后使用 `hskill` 命令管理 skills。
 
-**无交互模式：**
-```bash
-npx harveyz-skill --bundle brainstorming --target claude
-npx harveyz-skill --bundle brainstorming,dev --target all
-```
+### 常用命令
 
-**查看可用 bundle：**
 ```bash
-npx harveyz-skill list
+hskill                                          # 交互式选择安装
+hskill install --bundle dev --target claude     # 安装指定 bundle
+hskill install --skill git-workflow-init        # 安装指定 skill
+hskill install --tool p-launch                  # 安装 shell 工具
+hskill list                                     # 查看可用 skill
+hskill update                                   # 更新到最新版
+hskill --help                                   # 查看帮助
 ```
 
-### 本地源码安装
+Skills 安装到 `~/.claude/skills/`，shell 工具安装到 `~/.local/bin/`。
 
-克隆仓库后，用 CLI 安装：
+### 本地源码开发
 
 ```bash
-# 交互式选择 bundle 和目标工具
-node bin/cli.js
-
 # 安装指定 skill
-node bin/cli.js --skill mermaid-diagram --target claude
-node bin/cli.js --skill brainstorming,writing-plans --target claude
-
-# 安装整个 skill bundle
-node bin/cli.js --bundle dev --target claude
+node bin/cli.js install --skill mermaid-diagram --target claude
 
-# 安装指定 shell 工具（固定安装到 ~/.local/bin）
-node bin/cli.js --tool p-launch
+# 安装整个 bundle
+node bin/cli.js install --bundle dev --target claude
 
 # 覆盖已有安装
-node bin/cli.js --skill mermaid-diagram --target claude --force
-node bin/cli.js --tool p-launch --force
+node bin/cli.js install --skill mermaid-diagram --target claude --force
 ```
 
-Skills 安装到 `~/.claude/skills/`，shell 工具安装到 `~/.local/bin/`。
-
 ## Skill 开发指南
 
 ### 命名规范

package/bin/cli.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import { checkbox } from '@inquirer/prompts'
 import chalk from 'chalk'
+import { execSync } from 'child_process'
+import { createRequire } from 'module'
 import {
   buildAllChoices, getAllSkillItems, getAllToolItems,
   resolveSkills, resolveSkillsByName, resolveTools, resolveToolsByName,
@@ -9,21 +11,64 @@ import {
 import { TARGET_CHOICES, resolveTargets, TARGETS } from '../lib/targets.js'
 import { installSkills, installTools } from '../lib/installer.js'
 
+const require = createRequire(import.meta.url)
+const { version } = require('../package.json')
+
 const args = process.argv.slice(2)
-const forceFlag = args.includes('--force')
-const bundleIdx = args.indexOf('--bundle')
-const targetIdx = args.indexOf('--target')
-const toolIdx   = args.indexOf('--tool')
-const skillIdx  = args.indexOf('--skill')
-const bundleArg = bundleIdx !== -1 ? args[bundleIdx + 1] : undefined
-const targetArg = targetIdx !== -1 ? args[targetIdx + 1] : undefined
-const toolArg   = toolIdx   !== -1 ? args[toolIdx   + 1] : undefined
-const skillArg  = skillIdx  !== -1 ? args[skillIdx  + 1] : undefined
-
-if (args[0] === 'list') {
-  const { createRequire } = await import('module')
-  const require = createRequire(import.meta.url)
-  const { bundleMeta, skills, toolBundleMeta = {}, tools = [] } = require('../skills-index.json')
+const subcommand = args[0]
+
+// ── Help ─────────────────────────────────────────────────────────────────────
+function printHelp() {
+  console.log(`
+  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, and Codex  v${version}
+
+  ${chalk.cyan('Usage:')}
+    hskill                         interactive install
+    hskill install                 interactive install (explicit)
+    hskill install --bundle <b>    install a skill bundle
+    hskill install --skill <s>     install specific skill(s)
+    hskill install --tool <t>      install shell tool(s)
+    hskill install --target <t>    set target (claude/cursor/codex/all)
+    hskill install --force         overwrite existing installs
+    hskill list                    list available skills and bundles
+    hskill update                  update hskill to the latest version
+    hskill --version               show version
+    hskill --help                  show this help
+
+  ${chalk.cyan('Examples:')}
+    hskill install --bundle dev --target claude
+    hskill install --skill git-workflow-init,mermaid-diagram --target claude
+    hskill install --tool p-launch
+    hskill update
+`)
+}
+
+if (args[0] === '--help' || args[0] === '-h') {
+  printHelp()
+  process.exit(0)
+}
+
+if (args[0] === '--version' || args[0] === '-v') {
+  console.log(version)
+  process.exit(0)
+}
+
+// ── Update ───────────────────────────────────────────────────────────────────
+if (subcommand === 'update') {
+  console.log(chalk.dim('  · Updating hskill…'))
+  try {
+    execSync('npm update -g harveyz-skill', { stdio: 'inherit' })
+    console.log(chalk.green('  ✔ hskill updated'))
+  } catch {
+    console.error(chalk.red('  ✗ Update failed. Try: npm update -g harveyz-skill'))
+    process.exit(1)
+  }
+  process.exit(0)
+}
+
+// ── 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] = []
@@ -41,6 +86,20 @@ if (args[0] === 'list') {
   process.exit(0)
 }
 
+// ── Install ───────────────────────────────────────────────────────────────────
+// subcommand is 'install' or omitted (default behavior)
+const installArgs = subcommand === 'install' ? args.slice(1) : args
+
+const forceFlag = installArgs.includes('--force')
+const bundleIdx = installArgs.indexOf('--bundle')
+const targetIdx = installArgs.indexOf('--target')
+const toolIdx   = installArgs.indexOf('--tool')
+const skillIdx  = installArgs.indexOf('--skill')
+const bundleArg = bundleIdx !== -1 ? installArgs[bundleIdx + 1] : undefined
+const targetArg = targetIdx !== -1 ? installArgs[targetIdx + 1] : undefined
+const toolArg   = toolIdx   !== -1 ? installArgs[toolIdx   + 1] : undefined
+const skillArg  = skillIdx  !== -1 ? installArgs[skillIdx  + 1] : undefined
+
 const TOOL_BUNDLE_VALUES = new Set(TOOL_BUNDLE_CHOICES.map(c => c.value))
 
 function buildInteractiveChoices() {
@@ -103,7 +162,7 @@ try {
     process.exit(0)
   }
 
-  // ── Install skills ───────────────────────────────────────────────────────────
+  // ── Install skills ──────────────────────────────────────────────────────────
   if (skillItems.length > 0) {
     let selectedTargets
     if (targetArg) {
@@ -134,7 +193,7 @@ try {
     }
   }
 
-  // ── Install shell tools ──────────────────────────────────────────────────────
+  // ── Install shell tools ─────────────────────────────────────────────────────
   if (toolItems.length > 0) {
     console.log('')
     const installed = await installTools(

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "harveyz-skill",
-  "version": "0.3.0",
-  "description": "One-click skill installer for Claude Code, Cursor, and Codex",
+  "version": "0.4.0",
+  "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
-    "harveyz-skill": "bin/cli.js"
+    "hskill": "bin/cli.js"
   },
   "scripts": {
     "prepack": "node scripts/generate-npmignore.js"