harveyz-skill 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,15 @@ 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

package/lib/installer.js

@@ -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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -41,6 +41,8 @@
     "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

@@ -1,6 +1,6 @@
 ---
 name: add-todo
-version: "4.0.0"
+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'."
 ---
@@ -88,6 +88,36 @@ description: "Add a new requirement, task, or feature request to any project's T
 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` 是永久追踪分支，不是功能分支，**直接确认新建，忽略相似分支警告**，继续执行后续步骤。
+
 ### 重复检查
 
 加载文件，扫描是否有语义重叠的已有条目。若有：
@@ -118,6 +148,25 @@ todo project set-path [项目名] [本地路径]
 ## ✅ 已完成
 ```
 
-写入后确认：
+### 提交、合并到 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`。"
+> "✅ 已将 **[任务标题]** 写入 `{local_path}/TODO.md`，提交到 `chore/todo`，合并到 `$BASE_BRANCH`，当前回到 `$ORIGINAL_BRANCH`。"

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

@@ -2,7 +2,7 @@
 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.1.0"
+version: "1.2.0"
 ---
 
 # npm-release
@@ -100,14 +100,26 @@ npm version <new-version> --no-git-tag-version
 
 ---
 
+## Step 3.5 — 同步 .npmignore 和 package.json files 字段
+
+运行生成脚本，确保 `.npmignore` 和 `package.json` 中的 `files` 字段与当前 `skills-index.json` 保持一致：
+
+```bash
+node scripts/generate-npmignore.js
+```
+
+检查输出有无报错。此步骤必须在提交前完成，否则新增或重命名的 skill 路径不会被正确包含/排除。
+
+---
+
 ## Step 4 — 创建 release 分支并提交
 
 ```bash
 # 从当前 staging 切出 release 分支
 git checkout -b release/<new-version>
 
-# 只提交 CHANGELOG 和 package.json、package-lock.json
-git add CHANGELOG.md package.json package-lock.json
+# 提交 CHANGELOG、package.json、package-lock.json 和 .npmignore
+git add CHANGELOG.md package.json package-lock.json .npmignore
 git commit -m "chore(release): bump version to <new-version>"
 ```
 

package/skills/research/youtube-learner/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: youtube-learner
-version: "1.3.0"
+version: "1.3.1"
 description: "Process a YouTube video using the vdl CLI: transcribe, generate article and summary. Triggers when the user provides a YouTube URL and wants to learn from, summarize, transcribe, or extract key points from the video — e.g. 'help me understand this talk', 'summarize this YouTube video', 'get the transcript', 'process this video', 'summarize it'."
 user_invocable: true
 ---
@@ -35,7 +35,7 @@ npm link
 | `url` | YouTube 链接 | 从用户消息提取 |
 | `--focus` | 关注点（影响摘要内容） | 若用户未提供，主动询问："你最想从这个视频中了解什么？（例如：核心论点、技术细节、行动项）" |
 | `--mode` | 处理模式 | **必须询问用户**（见下方「模式选择」） |
-| `--lang` | 输出语言 | 默认 `zh-CN`；若用户用英文交流则用 `en` |
+| `--lang` | 输出语言 | 默认 `zh-CN`；若用户用英文交流则用 `en`；必须将解析结果赋给 `<LANG>` 占位符 |
 
 ### 模式选择
 
@@ -64,9 +64,18 @@ npm link
 
 ## 执行命令
 
+将以下占位符全部替换后再执行：
+
+| 占位符 | 替换为 |
+|--------|--------|
+| `<URL>` | YouTube 链接 |
+| `<FOCUS>` | 用户填写的关注点 |
+| `<MODE>` | `transcript` / `audio` / `media` / `full` |
+| `<LANG>` | `zh-CN`（中文对话）或 `en`（英文对话） |
+
 ```bash
 cd /Users/harveyzhang96/Projects/Video-Learner && \
-vdl "<URL>" --focus "<FOCUS>" --mode <MODE> --lang zh-CN
+vdl "<URL>" --focus "<FOCUS>" --mode <MODE> --lang <LANG>
 ```
 
 `vdl` 会自动：

package/skills-index.json

@@ -1,11 +1,21 @@
 {
   "toolBundleMeta": {
-    "shell-tools": "终端工具（p-launch 本地仓库管理器）"
+    "shell-tools": "终端工具（p-launch 本地仓库管理器 + todo-tool 任务管理器）",
+    "tools": "开发者 OS 工具（hub — 项目管理 + git 状态 + 任务跟踪）"
   },
   "tools": [
     {
       "name": "p-launch",
       "bundle": "shell-tools"
+    },
+    {
+      "name": "todo-tool",
+      "bundle": "shell-tools"
+    },
+    {
+      "name": "hub",
+      "path": "tools/hub",
+      "bundle": "tools"
     }
   ],
   "bundleMeta": {

package/tools/hub/hub/__main__.py

@@ -0,0 +1,24 @@
+import sys
+
+
+def main():
+    from hub.core.db import HubDB
+    from hub.core.migrate import needs_migration, run_migration
+
+    db = HubDB()
+    if needs_migration():
+        n = run_migration(db)
+        if n:
+            import typer
+            typer.echo(f"hub: migrated {n} tasks from todo-tool ✓")
+
+    if len(sys.argv) == 1:
+        from hub.tui.app import HubApp
+        HubApp().run()
+        return
+    from hub.cli import app
+    app()
+
+
+if __name__ == "__main__":
+    main()

package/tools/hub/hub/cli/__init__.py

@@ -0,0 +1,14 @@
+import json
+import sys
+import typer
+
+from hub.cli import projects as proj_cmd
+from hub.cli import tasks as task_cmd
+
+app = typer.Typer(
+    name="hub",
+    no_args_is_help=False,
+    add_completion=False,
+)
+app.add_typer(proj_cmd.app, name="projects")
+app.add_typer(task_cmd.app, name="tasks")

package/tools/hub/hub/cli/projects.py

@@ -0,0 +1,100 @@
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from hub.core.db import HubDB
+from hub.core import projects as proj
+
+app = typer.Typer(no_args_is_help=True)
+
+_DEFAULT_MD = Path.home() / ".hskill" / "public" / "PROJECTS.md"
+
+
+def _md_path() -> Path:
+    if env := os.environ.get("HUB_MD_PATH"):
+        return Path(env)
+    return _DEFAULT_MD
+
+
+def _out(data, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": True, "data": data}))
+
+
+def _err(msg: str, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": False, "error": msg}))
+    else:
+        typer.echo(f"Error: {msg}", err=True)
+    raise SystemExit(1)
+
+
+@app.command("list")
+def projects_list(json_out: bool = typer.Option(False, "--json")):
+    """List all registered projects."""
+    db = HubDB()
+    projects = proj.list_projects(db)
+    if json_out:
+        _out(projects, json_out)
+    else:
+        if not projects:
+            typer.echo("No projects. Use: hub projects add <name> --path <path>")
+            return
+        for p in projects:
+            typer.echo(f"  {p['name']:<24} {p['path'] or ''}")
+            if p.get("description"):
+                typer.echo(f"    {p['description']}")
+
+
+@app.command("add")
+def projects_add(
+    name: str = typer.Argument(..., help="Project name (GitHub repo name)"),
+    path: str = typer.Option("", "--path", help="Local directory path"),
+    description: str = typer.Option("", "--desc", help="Short description"),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Register or update a project."""
+    db = HubDB()
+    result = proj.add_project(db, name, path=path, description=description, md_path=_md_path())
+    if json_out:
+        _out(result, json_out)
+    else:
+        typer.echo(f"✓ {name}")
+
+
+@app.command("path")
+def projects_path(
+    name: str = typer.Argument(...),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Print the local path for a project (for shell cd / agent use)."""
+    db = HubDB()
+    p = proj.get_project_path(db, name)
+    if p is None:
+        _err(f"Project '{name}' not found", json_out)
+    if json_out:
+        _out(p, json_out)
+    else:
+        print(p)
+
+
+@app.command("sync")
+def projects_sync(json_out: bool = typer.Option(False, "--json")):
+    """Re-scan configured dirs and update PROJECTS.md. (Requires p-launch config.)"""
+    try:
+        import sys as _sys
+        _sys.path.insert(0, str(Path(__file__).parents[4] / "p-launch"))
+        from p_launch import read_project_dirs, collect_repos, sync_to_index
+        dirs = read_project_dirs()
+        repos = collect_repos(dirs)
+        sync_to_index(repos, _md_path())
+        if json_out:
+            _out({"scanned": len(repos)}, json_out)
+        else:
+            typer.echo(f"✓ Scanned {len(repos)} repos")
+    except ImportError:
+        _err("p-launch not installed; cannot auto-scan", json_out)

package/tools/hub/hub/cli/tasks.py

@@ -0,0 +1,114 @@
+import json
+import sys
+from typing import Optional
+
+import typer
+
+from hub.core.db import HubDB
+from hub.core import tasks as task
+
+app = typer.Typer(no_args_is_help=True)
+
+
+def _out(data, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": True, "data": data}))
+
+
+def _err(msg: str, json_out: bool) -> None:
+    if json_out:
+        print(json.dumps({"ok": False, "error": msg}))
+    else:
+        typer.echo(f"Error: {msg}", err=True)
+    raise SystemExit(1)
+
+
+@app.command("list")
+def tasks_list(
+    project:  Optional[str] = typer.Option(None, "--project",  "-p"),
+    status:   Optional[str] = typer.Option(None, "--status",   "-s"),
+    priority: Optional[str] = typer.Option(None, "--priority", "-P"),
+    json_out: bool           = typer.Option(False, "--json"),
+):
+    """List tasks, optionally filtered."""
+    db = HubDB()
+    tasks = task.list_tasks(db, project=project, status=status, priority=priority)
+    if json_out:
+        _out(tasks, json_out)
+    else:
+        if not tasks:
+            typer.echo("No tasks.")
+            return
+        for t in tasks:
+            check = "✓" if t["status"] == "done" else "○"
+            typer.echo(f"  [{t['id']:>4}] {check} [{t['priority']}] {t['title']}  ({t['project']})")
+
+
+@app.command("add")
+def tasks_add(
+    title:    str           = typer.Argument(...),
+    project:  str           = typer.Option(..., "--project", "-p"),
+    priority: str           = typer.Option("P2", "--priority", "-P"),
+    json_out: bool          = typer.Option(False, "--json"),
+):
+    """Add a new task."""
+    db = HubDB()
+    try:
+        t = task.add_task(db, title=title, project=project, priority=priority)
+    except ValueError as e:
+        _err(str(e), json_out)
+    if json_out:
+        _out(t, json_out)
+    else:
+        typer.echo(f"✓ [{t['id']}] {t['title']}")
+
+
+@app.command("done")
+def tasks_done(
+    task_id:  int  = typer.Argument(...),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Mark a task as done."""
+    db = HubDB()
+    result = task.mark_done(db, task_id)
+    if result is None:
+        _err(f"Task {task_id} not found", json_out)
+    if json_out:
+        _out(result, json_out)
+    else:
+        typer.echo(f"✓ done: {result['title']}")
+
+
+@app.command("update")
+def tasks_update(
+    task_id:  int            = typer.Argument(...),
+    title:    Optional[str]  = typer.Option(None, "--title"),
+    priority: Optional[str]  = typer.Option(None, "--priority"),
+    status:   Optional[str]  = typer.Option(None, "--status"),
+    json_out: bool           = typer.Option(False, "--json"),
+):
+    """Update task fields."""
+    db = HubDB()
+    result = task.update_task(db, task_id, title=title, priority=priority, status=status)
+    if result is None:
+        _err(f"Task {task_id} not found", json_out)
+    if json_out:
+        _out(result, json_out)
+    else:
+        typer.echo(f"✓ updated [{task_id}]")
+
+
+@app.command("rm")
+def tasks_rm(
+    task_id:  int  = typer.Argument(...),
+    json_out: bool = typer.Option(False, "--json"),
+):
+    """Delete a task."""
+    db = HubDB()
+    deleted = task.delete_task(db, task_id)
+    if not deleted:
+        _err(f"Task {task_id} not found", json_out)
+    if json_out:
+        _out({"deleted": True}, json_out)
+    else:
+        typer.echo(f"✓ deleted [{task_id}]")

package/tools/hub/hub/core/db.py

@@ -0,0 +1,46 @@
+import os
+import sqlite3
+from pathlib import Path
+
+
+def get_db_path() -> Path:
+    if env := os.environ.get("HUB_DB_PATH"):
+        return Path(env)
+    return Path.home() / ".hskill" / "hub" / "tasks.db"
+
+
+class HubDB:
+    def __init__(self, db_path: Path = None):
+        self.db_path = db_path or get_db_path()
+        self.db_path.parent.mkdir(parents=True, exist_ok=True)
+        self._init()
+
+    def _conn(self) -> sqlite3.Connection:
+        conn = sqlite3.connect(self.db_path)
+        conn.row_factory = sqlite3.Row
+        conn.execute("PRAGMA foreign_keys = ON")
+        return conn
+
+    def _init(self) -> None:
+        with self._conn() as conn:
+            conn.execute("""
+                CREATE TABLE IF NOT EXISTS projects (
+                    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+                    name        TEXT NOT NULL UNIQUE,
+                    path        TEXT,
+                    description TEXT DEFAULT '',
+                    created_at  TEXT NOT NULL
+                )
+            """)
+            conn.execute("""
+                CREATE TABLE IF NOT EXISTS tasks (
+                    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+                    title       TEXT NOT NULL,
+                    project_id  INTEGER NOT NULL REFERENCES projects(id),
+                    priority    TEXT DEFAULT 'P2',
+                    status      TEXT DEFAULT 'todo',
+                    created_at  TEXT NOT NULL
+                )
+            """)
+            conn.execute("CREATE INDEX IF NOT EXISTS idx_task_project ON tasks(project_id)")
+            conn.execute("CREATE INDEX IF NOT EXISTS idx_task_status  ON tasks(status)")

package/tools/hub/hub/core/migrate.py

@@ -0,0 +1,49 @@
+"""One-time migration: copy tasks from todo-tool's DB into hub's DB."""
+import sqlite3
+from pathlib import Path
+
+
+_OLD_DB = Path.home() / ".local" / "share" / "todo" / "tasks.db"
+_SENTINEL = Path.home() / ".hskill" / "hub" / ".migrated"
+
+
+def needs_migration() -> bool:
+    return _OLD_DB.exists() and not _SENTINEL.exists()
+
+
+def run_migration(hub_db) -> int:
+    """Copy projects + tasks from todo-tool DB. Returns number of tasks migrated."""
+    if not _OLD_DB.exists():
+        return 0
+    old = sqlite3.connect(_OLD_DB)
+    old.row_factory = sqlite3.Row
+    migrated = 0
+    try:
+        from hub.core.projects import add_project
+        from hub.core.tasks import add_task, mark_done
+        from pathlib import Path as _Path
+        md = _Path.home() / ".hskill" / "public" / "PROJECTS.md"
+
+        for row in old.execute("SELECT repo_name, local_path FROM projects").fetchall():
+            try:
+                add_project(hub_db, row["repo_name"], path=row["local_path"] or "", md_path=md)
+            except Exception:
+                pass  # already exists is fine
+
+        for row in old.execute(
+            "SELECT t.title, p.repo_name as project, t.priority, t.status "
+            "FROM tasks t JOIN projects p ON p.id = t.project_id"
+        ).fetchall():
+            try:
+                t = add_task(hub_db, title=row["title"], project=row["project"], priority=row["priority"])
+                if row["status"] == "done":
+                    mark_done(hub_db, t["id"])
+                migrated += 1
+            except Exception:
+                pass
+    finally:
+        old.close()
+
+    _SENTINEL.parent.mkdir(parents=True, exist_ok=True)
+    _SENTINEL.touch()
+    return migrated