harveyz-skill 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.0] - 2026-06-14
+
+### Added
+- `hub` tool（`tools` bundle）：个人开发者 OS，整合项目管理、git 状态追踪、任务系统，替代 p-launch + todo-tool
+  - Phase 1：core 库（SQLite DB、projects CRUD、tasks CRUD）+ CLI（`hub project`、`hub task` 子命令，支持 `--json` 输出）
+  - Phase 2：三栏 Textual TUI（ProjectsPanel | GitPanel | TasksPanel），支持键盘导航、git fetch、任务增删改、项目切换联动
+  - 首次启动自动从 todo-tool DB 迁移数据（`migrate.py`）
+  - 62 个测试覆盖 core、CLI、TUI 各层
+
+## [0.13.0] - 2026-06-12
+
+### Fixed
+- `opencode-runner`：description 移除中文字符，符合 F3 英文规范
+- `doc-forge`：测试 CSS 路径改为动态选取首个可用文件，不再依赖不存在的 `default.css`
+
+## [0.12.1] - 2026-06-10
+
 ## [0.12.0] - 2026-06-09
 
 ### Added

package/bin/cli.js

@@ -2,6 +2,7 @@
 import { select, input } from '@inquirer/prompts'
 import chalk from 'chalk'
 import { execSync, spawnSync } from 'child_process'
+import { existsSync } from 'fs'
 import { createRequire } from 'module'
 import os from 'os'
 import path from 'path'
@@ -26,7 +27,7 @@ const jsonFlag = args.includes('--json')
 // ── Help ─────────────────────────────────────────────────────────────────────
 function printHelp() {
   console.log(`
-  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, Codex, OpenClaw, and Hermes  v${version}
+  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, and OpenCode  v${version}
 
   ${chalk.cyan('Usage:')}
     hskill                         interactive install (requires TTY + fzf)
@@ -34,7 +35,7 @@ function printHelp() {
     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/openclaw/hermes/all)
+    hskill install --target <t>    set target (claude/cursor/codex/openclaw/hermes/opencode/all)
     hskill install --scope <s>     set scope: user (default) or project
     hskill install --force         overwrite existing installs
     hskill list [--json]           list available skills and bundles
@@ -86,7 +87,7 @@ if (args[0] === '--help' || args[0] === '-h') {
             { name: '--bundle', arg: '<name>',   description: 'Install a skill bundle (comma-separated)' },
             { name: '--skill',  arg: '<name>',   description: 'Install specific skill(s) (comma-separated)' },
             { name: '--tool',   arg: '<name>',   description: 'Install shell tool(s) (comma-separated)' },
-            { name: '--target', arg: '<target>', description: 'Install target', enum: ['claude','cursor','codex','openclaw','hermes','all'] },
+            { name: '--target', arg: '<target>', description: 'Install target', enum: ['claude','cursor','codex','openclaw','hermes','opencode','all'] },
             { name: '--scope',  arg: '<scope>',  description: 'Install scope', enum: ['user','project'], default: 'user' },
             { name: '--force',  description: 'Overwrite existing installs' },
           ],
@@ -153,6 +154,15 @@ if (subcommand === 'update') {
     console.error(chalk.red('  ✗ Update failed. Try: npm update -g harveyz-skill'))
     process.exit(1)
   }
+  const legacyDir = path.join(os.homedir(), '.local', 'share', 'hskill')
+  if (existsSync(legacyDir)) {
+    console.log('')
+    console.log(chalk.yellow('  ⚠ Legacy data detected at ~/.local/share/hskill/'))
+    console.log(chalk.dim('  Run the migration script to move data to the new location:'))
+    console.log('')
+    console.log('     ' + chalk.bold.cyan('bash "$(npm root -g)/harveyz-skill/scripts/migrate-data-dir.sh"'))
+    console.log('')
+  }
   process.exit(0)
 }
 
@@ -221,7 +231,7 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   })
 
   if (jsonFlag) {
-    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
     const jsonSkills = skillRows.map(r => ({
       name: r.name,
       version: r.version,
@@ -253,7 +263,7 @@ if (subcommand === 'status' || subcommand === 'outdated') {
       process.exit(0)
     }
 
-    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
 
     if (outdatedSkills.length) {
       console.log('\n  ' + chalk.bold('SKILLS WITH UPDATES'))
@@ -438,7 +448,7 @@ if (subcommand === 'uninstall') {
   const scope = scopeArg2
   const selectedTargets = targetArg2
     ? [targetArg2]
-    : ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+    : ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
   const targets = resolveTargets(selectedTargets, scope)
 
   let anyRemoved = false
@@ -598,7 +608,7 @@ const scopeArg  = scopeIdx  !== -1 ? installArgs[scopeIdx  + 1] : undefined
 const TOOL_BUNDLE_VALUES = new Set(TOOL_BUNDLE_CHOICES.map(c => c.value))
 
 // ── Two-step target→scope selector ───────────────────────────────────────────
-const ALL_SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+const ALL_SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
 
 function selectTargetThenScope() {
   // Step 1: platform (target)
@@ -608,7 +618,8 @@ function selectTargetThenScope() {
     'codex     ~/.codex/skills/',
     'openclaw  ~/.openclaw/skills/',
     'hermes    ~/.hermes/skills/',
-    'all       all 5 targets',
+    'opencode  ~/.config/opencode/skills/',
+    'all       all 6 targets',
   ].join('\n')
 
   const targetResult = spawnSync('fzf', [
@@ -1107,7 +1118,7 @@ try {
     // When only --skill is given and no --target, use the combined selector.
     if (targetArg) {
       const scope = scopeArg ?? 'user'
-      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes'] : [targetArg]
+      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode'] : [targetArg]
       const targets = resolveTargets(selectedTargets, scope)
       console.log('')
       skillSummary = await installSkills(skillItems, targets, forceFlag)

package/bin/preview.mjs

@@ -19,7 +19,7 @@ if (!skillName) process.exit(0)
 if (kind !== 'skill') {
   const home = os.homedir()
   const installedBin  = path.join(home, '.local', 'bin', skillName)
-  const installedMeta = path.join(home, '.local', 'share', 'hskill', 'tools', `${skillName}.json`)
+  const installedMeta = path.join(home, '.hskill', 'tools', `${skillName}.json`)
 
   function readToolMeta(jsonPath) {
     try {

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 { SKILL_TARGETS, USER_ONLY_TARGETS } from './targets.js'
+import { SKILL_TARGETS, USER_ONLY_TARGETS, userSkillDir } from './targets.js'
 
 const require = createRequire(import.meta.url)
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -154,7 +154,7 @@ export function checkInstalled(skillName, availableVersion) {
   const noneScope = Object.fromEntries(targets.map(t => [t, { version: '—', status: 'none' }]))
 
   return {
-    user:    checkScope(t => path.join(home, `.${t}`, 'skills')),
+    user:    checkScope(t => userSkillDir(t)),
     project: cwd === home ? noneScope : checkScope(t =>
       USER_ONLY_TARGETS.has(t) ? null : path.join(cwd, `.${t}`, 'skills')
     ),
@@ -263,7 +263,7 @@ export function checkHookInstalled(hookName) {
 
 export { formatChoice, readVersion, readHookVersion }
 
-const HSKILL_TOOLS_DATA = path.join(os.homedir(), '.local', 'share', 'hskill', 'tools')
+const HSKILL_TOOLS_DATA = path.join(os.homedir(), '.hskill', 'tools')
 
 function readToolMeta(jsonPath) {
   try {

package/lib/installer.js

@@ -55,7 +55,7 @@ export async function installTools(tools, targetDir, force = false) {
     if (destExists && !force) {
       // Version-aware upgrade logic (mirrors skill behavior)
       const home          = os.homedir()
-      const dataDir       = path.join(home, '.local', 'share', 'hskill', 'tools')
+      const dataDir       = path.join(home, '.hskill', 'tools')
       const installedMeta = path.join(dataDir, `${toolName}.json`)
       const sourceMeta    = path.join(srcPath, 'tool.json')
 
@@ -130,7 +130,7 @@ export async function installTools(tools, targetDir, force = false) {
       const content = await fs.readFile(scriptSrc, 'utf-8')
       await fs.writeFile(destPath, substituteVars(content, varsMap), { encoding: 'utf-8', mode: 0o755 })
 
-      const dataDir = path.join(os.homedir(), '.local', 'share', 'hskill', 'tools')
+      const dataDir = path.join(os.homedir(), '.hskill', 'tools')
 
       const toolJsonSrc = path.join(srcPath, 'tool.json')
       if (await fs.pathExists(toolJsonSrc)) {
@@ -146,6 +146,21 @@ export async function installTools(tools, targetDir, force = false) {
         console.error(chalk.dim(`  · Installed ${toolName}.py`))
       }
 
+      // Copy extra paths (files or dirs) declared in tool.json `extraPaths`
+      // Each entry is a relative path from the tool source; copied to ~/.hskill/tools/{toolName}/
+      try {
+        const toolMeta = await fs.readJson(path.join(srcPath, 'tool.json'))
+        for (const rel of (toolMeta.extraPaths ?? [])) {
+          const src  = path.join(srcPath, rel)
+          const dest = path.join(dataDir, toolName, rel)
+          if (await fs.pathExists(src)) {
+            await fs.ensureDir(path.dirname(dest))
+            await fs.copy(src, dest, { overwrite: true })
+            console.error(chalk.dim(`  · Installed ${toolName}/${rel}`))
+          }
+        }
+      } catch { /* tool.json missing or no extraPaths — skip silently */ }
+
       installed.push(toolName)
       await _patchZshrc(srcPath, toolName)
     } catch (err) {
@@ -537,7 +552,7 @@ export async function uninstallTool(toolName, opts = {}) {
   const { yes = false } = opts
   const home     = os.homedir()
   const binPath  = path.join(home, '.local', 'bin', toolName)
-  const dataDir  = path.join(home, '.local', 'share', 'hskill', 'tools')
+  const dataDir  = path.join(home, '.hskill', 'tools')
   const jsonPath = path.join(dataDir, `${toolName}.json`)
   const pyPath   = path.join(dataDir, `${toolName}.py`)
 

package/lib/targets.js

@@ -1,13 +1,22 @@
 import os from 'os'
 import path from 'path'
 
-export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
 
 export const USER_ONLY_TARGETS = new Set(['openclaw', 'hermes'])
 
+// Targets whose user-level skill dir doesn't follow ~/.{name}/skills
+const USER_DIR_OVERRIDES = {
+  opencode: path.join(os.homedir(), '.config', 'opencode', 'skills'),
+}
+
+export function userSkillDir(name) {
+  return USER_DIR_OVERRIDES[name] ?? path.join(os.homedir(), `.${name}`, 'skills')
+}
+
 function skillDir(name, scope) {
   if (USER_ONLY_TARGETS.has(name) || scope !== 'project')
-    return path.join(os.homedir(), `.${name}`, 'skills')
+    return userSkillDir(name)
   return path.join(process.cwd(), `.${name}`, 'skills')
 }
 
@@ -17,6 +26,7 @@ export const TARGETS = {
   codex:    path.join(os.homedir(), '.codex',    'skills'),
   openclaw: path.join(os.homedir(), '.openclaw', 'skills'),
   hermes:   path.join(os.homedir(), '.hermes',   'skills'),
+  opencode: path.join(os.homedir(), '.config', 'opencode', 'skills'),
   shell:    path.join(os.homedir(), '.local', 'bin'),
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -16,31 +16,33 @@
     "bundles.json",
     "skills-index.json",
     "CHANGELOG.md",
-    "skills/analysis/skill-analyzer/",
-    "skills/harness/diataxis-docs/",
-    "skills/harness/full-stack-debug-env/",
-    "skills/superpowers-fork/brainstorming/",
-    "skills/harness/git-workflow-init/",
-    "skills/superpowers-fork/executing-plans/",
-    "skills/superpowers-fork/systematic-debugging/",
-    "skills/superpowers-fork/using-git-worktrees/",
-    "skills/superpowers-fork/writing-plans/",
-    "skills/task/pm-task-dispatch/",
-    "skills/task/task-close/",
-    "skills/data-extraction/article-fetcher/",
-    "skills/data-extraction/url-extract/",
-    "skills/data-extraction/vision-extract/",
-    "skills/writing/mermaid-diagram/",
+    "skills/research/article-fetcher/",
+    "skills/research/url-extract/",
+    "skills/research/vision-extract/",
+    "skills/research/youtube-learner/",
+    "skills/creative/add-todo/",
+    "skills/creative/insight/",
+    "skills/coding/git-workflow-init/",
+    "skills/coding/full-stack-debug-env/",
+    "skills/coding/pm-task-dispatch/",
+    "skills/coding/task-close/",
+    "skills/writing/doc-forge/",
+    "skills/writing/diagram/",
+    "skills/writing/diataxis-docs/",
+    "skills/writing/dir-manage/",
+    "skills/writing/migrate-specs/",
+    "skills/design/brand-scout/",
+    "skills/design/style-build/",
     "skills/design/sync-design-html/",
-    "skills/analysis/git-cleanup/",
+    "skills/meta/skill-analyzer/",
+    "skills/meta/git-cleanup/",
     "skills/meta/contribute-skill/",
-    "skills/harness/migrate-specs/",
-    "skills/workflow/add-todo/",
-    "skills/harness/dir-manage/",
-    "skills/writing/capture-insight/",
     "skills/meta/skill-publish/",
     "skills/meta/npm-release/",
+    "skills/meta/opencode-runner/",
     "tools/p-launch/",
+    "tools/todo-tool/",
+    "tools/hub/",
     "hooks/check-similar-branch/"
   ],
   "engines": {

package/skills/creative/add-todo/SKILL.md

@@ -0,0 +1,172 @@
+---
+name: add-todo
+version: "4.5.0"
+user_invocable: true
+description: "Add a new requirement, task, or feature request to any project's TODO.md — from any working directory. Triggers whenever the user wants to capture a new need — even phrased casually like 'we should do X later', 'add this to the backlog', 'note this down', 'remember to build X', 'we need to do Y at some point', or 'record this for later'."
+---
+
+# 写入 TODO
+
+快速捕获需求：先用 2-3 个问题把需求说清楚，再根据完整的需求信息匹配项目、生成标题，最后写入 TODO.md。
+
+## 核心原则
+
+**先把需求说清楚，再定项目归属。** 完整的需求描述是项目匹配最好的材料。问题只聚焦需求本身，不聚焦方案。够写一条清晰的任务条目就停，不要拖长。
+
+---
+
+## 阶段一 — 需求确认（2-3 轮）
+
+**按需提问，已从上下文明确的直接跳过：**
+
+1. **需求** — 要解决什么问题、实现什么功能？（用户已清晰描述则复述确认即可）
+2. **紧急程度** — 有多急？（默认 P2，只在用户暗示紧急或不重要时调整）
+3. **背景** — 为什么现在提出来？（可选，有助于写出有上下文的描述）
+
+**提问方式：**
+- 每次只问一个问题
+- 优先给选项而非开放题："这个更像 (A) 缺失功能 还是 (B) 现有功能的问题？"
+- 2 轮够用时不要凑到 3 轮
+
+---
+
+## 阶段二 — 确认项目归属
+
+需求收集完毕后，用 Read 工具读取项目注册表：
+
+```
+~/.hskill/todo-tool/PROJECTS.md
+```
+
+同时用 Bash 运行 `pwd` 获取当前目录。
+
+### 匹配逻辑
+
+综合以下信号推断候选项目：
+
+1. **当前目录**：`pwd` 输出是否是某个项目 `local_path` 的子路径 → 强信号
+2. **需求关键词 + 项目描述**：需求描述中的词汇是否与项目名或描述匹配 → 中信号
+3. **语义推断**：需求内容在哪个项目的业务范围内 → 弱信号
+
+### 确认策略
+
+| 情况 | 行动 |
+|------|------|
+| 唯一高置信匹配 | 告知并请确认："这是 **[项目名]** 的需求，对吗？" |
+| 2-3 个候选 | 列出候选，请用户选择 |
+| 无匹配或不确定 | 展示完整项目列表，让用户选 |
+
+> **谨慎原则**：宁可多问一次，不写入错误项目。
+
+### 生成标题
+
+项目确认后，根据完整需求生成任务标题：
+
+- 祈使句，动词开头，直接说明要做什么
+- ≤20 字，超出则提炼核心、去掉修饰语
+- 足够具体，让人一眼看出任务核心，避免泛泛的"优化"、"修复"
+- 不堆砌细节，只抓最关键的区分点
+
+**示例：**
+- ✗ "优化系统" → ✓ "重构视频解析模块以支持多格式输入"
+- ✗ "修复 bug" → ✓ "修复字幕导出时 UTF-8 编码乱码"
+- ✗ "添加功能" → ✓ "为 add-todo skill 添加 SQLite 持久化层"
+
+展示摘要等用户确认：
+> "记录为：**[项目名]** — [生成的标题]，[优先级]。确认吗？"
+
+---
+
+## 阶段三 — 写入 TODO.md
+
+### 确定文件路径
+
+从阶段二确认的项目的 `local_path` 取出路径，TODO.md 位于 `{local_path}/TODO.md`。
+
+若该项目无 `local_path`，询问用户本地目录，写入后提示注册：
+```bash
+todo project set-path [项目名] [本地路径]
+```
+
+### 切换到 chore/todo 分支
+
+在写入前，在项目目录操作 git：
+
+```bash
+cd {local_path}
+
+# 1. 记录当前分支
+ORIGINAL_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# 2. 确定 staging 基准分支（用于创建 chore/todo 及事后合并目标）
+if git show-ref --verify --quiet refs/heads/staging; then
+  BASE_BRANCH=staging
+else
+  BASE_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null \
+                | sed 's@^refs/remotes/origin/@@' || echo "main")
+fi
+
+# 3. 切换到 chore/todo（不存在则从 BASE_BRANCH 创建）
+if git show-ref --verify --quiet refs/heads/chore/todo; then
+  git checkout chore/todo
+else
+  git checkout -b chore/todo "$BASE_BRANCH"
+fi
+```
+
+**非 git 仓库**：若 `local_path` 不在 git 仓库中，跳过此步骤，直接写入文件。
+
+**BRANCH_GUARD hook**：执行 `git checkout -b chore/todo` 时，BRANCH_GUARD hook 可能会提示与其他分支语义相似。`chore/todo` 是永久追踪分支，不是功能分支，**直接确认新建，忽略相似分支警告**，继续执行后续步骤。
+
+### 重复检查
+
+加载文件，扫描是否有语义重叠的已有条目。若有：
+> "发现可能重叠的条目：**[已有标题]**。这是同一件事还是独立需求？"
+
+由用户决定：跳过、替换或独立写入。
+
+### 写入格式
+
+追加到 `## 🚧 待开发` 末尾：
+
+```markdown
+### [任务标题（≤20 字）]
+**优先级**: P? | **日期**: YYYY-MM-DD
+
+[描述：做什么、为什么。不写怎么做。篇幅以说清楚为准，不限长短。]
+
+---
+```
+
+文件不存在则创建，初始结构：
+
+```markdown
+# TODO / Backlog
+
+## 🚧 待开发
+
+## ✅ 已完成
+```
+
+### 提交、合并到 staging、切回原分支
+
+写入后在项目目录执行：
+
+```bash
+cd {local_path}
+
+# 1. 在 chore/todo 上提交
+git add TODO.md
+git commit -m "todo: add [任务标题]"
+
+# 2. 合并到 staging（或主分支）
+git checkout "$BASE_BRANCH"
+git merge --no-ff chore/todo -m "Merge chore/todo: add [任务标题]"
+
+# 3. 切回原分支
+git checkout "$ORIGINAL_BRANCH"
+```
+
+完成后确认：
+
+> "✅ 已将 **[任务标题]** 写入 `{local_path}/TODO.md`，提交到 `chore/todo`，合并到 `$BASE_BRANCH`，当前回到 `$ORIGINAL_BRANCH`。"

package/skills/{writing/capture-insight → creative/insight}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: capture-insight
+name: insight
 version: "1.1.0"
 user_invocable: true
 description: "Capture and record a fleeting insight or observation. Triggers immediately when the user expresses an observation, judgment, or idea — phrases like 'I noticed', 'just an observation', 'record this', 'insight', 'I have a judgment', or tossing out an opinionated thought. Distinct from 'I have an idea to execute' (that's a task). Clarifies the core with 2-3 quick Q&As, then saves to the insights/ folder. Trigger early — insights are fragile."