harveyz-skill 0.3.0 → 0.5.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,29 +1,75 @@
 #!/usr/bin/env node
-import { checkbox } from '@inquirer/prompts'
+import { checkbox, select } from '@inquirer/prompts'
 import chalk from 'chalk'
+import { execSync } from 'child_process'
+import { createRequire } from 'module'
 import {
   buildAllChoices, getAllSkillItems, getAllToolItems,
   resolveSkills, resolveSkillsByName, resolveTools, resolveToolsByName,
   TOOL_BUNDLE_CHOICES,
 } from '../lib/bundles.js'
-import { TARGET_CHOICES, resolveTargets, TARGETS } from '../lib/targets.js'
+import { buildTargetChoices, 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 --scope <s>     set scope: user (default) or project
+    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 --target claude --scope project
+    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 +87,22 @@ 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 scopeIdx  = installArgs.indexOf('--scope')
+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 scopeArg  = scopeIdx  !== -1 ? installArgs[scopeIdx  + 1] : undefined
+
 const TOOL_BUNDLE_VALUES = new Set(TOOL_BUNDLE_CHOICES.map(c => c.value))
 
 function buildInteractiveChoices() {
@@ -103,23 +165,36 @@ try {
     process.exit(0)
   }
 
-  // ── Install skills ───────────────────────────────────────────────────────────
+  // ── Install skills ──────────────────────────────────────────────────────────
   if (skillItems.length > 0) {
+    // Resolve scope
+    let scope = scopeArg ?? 'user'
+    if (!scopeArg && !targetArg) {
+      scope = await select({
+        message: 'Scope:',
+        choices: [
+          { name: `user     — ~/.claude/skills/  (shared across all projects)`, value: 'user' },
+          { name: `project  — .claude/skills/    (current project only)`, value: 'project' },
+        ],
+      })
+    }
+
+    // Resolve target
     let selectedTargets
     if (targetArg) {
-      selectedTargets = targetArg === 'all' ? Object.keys(TARGETS) : [targetArg]
+      selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex'] : [targetArg]
     } else {
       selectedTargets = await checkbox({
         message: 'Install to which tools (space to select, enter to confirm):',
         choices: [
-          ...TARGET_CHOICES,
+          ...buildTargetChoices(scope),
           { name: 'all      — all tools', value: 'all' },
         ],
       })
     }
 
     if (selectedTargets.length > 0) {
-      const targets = resolveTargets(selectedTargets)
+      const targets = resolveTargets(selectedTargets, scope)
       console.log('')
       const summary = await installSkills(skillItems, targets, forceFlag)
       console.log('')
@@ -134,7 +209,7 @@ try {
     }
   }
 
-  // ── Install shell tools ──────────────────────────────────────────────────────
+  // ── Install shell tools ─────────────────────────────────────────────────────
   if (toolItems.length > 0) {
     console.log('')
     const installed = await installTools(

package/lib/targets.js

@@ -1,6 +1,13 @@
 import os from 'os'
 import path from 'path'
 
+const SKILL_TARGETS = ['claude', 'cursor', 'codex']
+
+function skillDir(name, scope) {
+  if (scope === 'project') return path.join(process.cwd(), `.${name}`, 'skills')
+  return path.join(os.homedir(), `.${name}`, 'skills')
+}
+
 export const TARGETS = {
   claude: path.join(os.homedir(), '.claude', 'skills'),
   cursor: path.join(os.homedir(), '.cursor', 'skills'),
@@ -8,17 +15,21 @@ export const TARGETS = {
   shell: path.join(os.homedir(), '.local', 'bin'),
 }
 
-export const TARGET_CHOICES = Object.entries(TARGETS).map(([name, dir]) => ({
-  name: `${name.padEnd(8)} (${dir})`,
-  value: name,
-}))
+export function buildTargetChoices(scope = 'user') {
+  return SKILL_TARGETS.map(name => {
+    const dir = skillDir(name, scope)
+    return { name: `${name.padEnd(8)} (${dir})`, value: name }
+  })
+}
+
+export const TARGET_CHOICES = buildTargetChoices('user')
 
 // 返回选中 targets 的 { name, dir } 列表，all 展开为全部
-export function resolveTargets(selected) {
-  if (selected.includes('all')) return Object.entries(TARGETS).map(([name, dir]) => ({ name, dir }))
+export function resolveTargets(selected, scope = 'user') {
+  const allTargets = SKILL_TARGETS.map(name => ({ name, dir: skillDir(name, scope) }))
+  if (selected.includes('all')) return allTargets
   return selected.map(name => {
-    const dir = TARGETS[name]
-    if (!dir) throw new Error(`Unknown target: "${name}"`)
-    return { name, dir }
+    if (!SKILL_TARGETS.includes(name)) throw new Error(`Unknown target: "${name}"`)
+    return { name, dir: skillDir(name, scope) }
   })
 }

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.5.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"