harveyz-skill 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-06-15
+
+### Added
+- `hub git`：新增 CLI 子命令，与 TUI git 面板功能对等
+  - `hub git status [--project <name>]`：显示当前分支、upstream 同步状态、工作区变更、最近提交
+  - `hub git fetch [--project <name>]`：fetch 所有 remote
+  - `hub git branches [--project <name>]`：列出所有分支及 ahead/behind 状态
+
+### Changed
+- `hub`：版本升至 1.1.0
+- `hub`：安装升级机制改为基于源码文件内容哈希（sha256）检测，不再依赖版本号；npm 更新后下次启动自动重装
+
 ## [0.15.0] - 2026-06-15
 
 ### Added

package/package.json

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

package/skills/coding/init-workflow/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: init-workflow
-description: "Initialize or update git branch management standards: reads workflow-config.yml, audits config, incrementally generates and deploys git hooks (pre-commit, commit-msg, pre-push, post-checkout), and generates workflow docs. Triggers: initializing a new git repo, first-time git setup, user asks to set/update branch protection or naming rules, reinstalling git hooks, or syncing after skill/template updates."
+description: "Initialize or update git branch management standards: reads .hskill/init-workflow/workflow-config.yml, audits config, incrementally generates and deploys git hooks (pre-commit, commit-msg, pre-push, post-checkout), and generates workflow docs. Triggers: initializing a new git repo, first-time git setup, user asks to set/update branch protection or naming rules, reinstalling git hooks, or syncing after skill/template updates."
 user_invocable: true
 version: "4.1.0"
 ---
 
 # Git 工作流初始化
 
-读取 `workflow-config.yml`，审核配置，差量部署 git hooks。
+读取 `.hskill/init-workflow/workflow-config.yml`，审核配置，差量部署 git hooks。
 重新运行时自动检测配置变更、用户手改冲突、用户代码与新规则的交叉冲突，一次性汇总让用户决策后再写入。
 
 ---
@@ -26,16 +26,17 @@ git rev-parse --show-toplevel
 
 ### Step 2 — 读取配置
 
-按以下顺序查找 `workflow-config.yml`：
+按以下顺序查找配置文件：
 
-1. 项目根目录 `workflow-config.yml`
-2. 项目根目录 `.claude/workflow-config.yml`
+1. `.hskill/init-workflow/workflow-config.yml`
+2. 项目根目录 `workflow-config.yml`（向后兼容）
+3. 项目根目录 `.claude/workflow-config.yml`（向后兼容）
 
-若两处均不存在，询问用户：
-- 使用默认配置（从此 skill 的 `references/workflow-config.yml` 复制到项目根目录）
+若均不存在，询问用户：
+- 使用默认配置（从此 skill 的 `references/workflow-config.yml` 复制到 `.hskill/init-workflow/workflow-config.yml`）
 - 还是中止并自行创建后重新运行
 
-找到后读取并解析 YAML。
+找到后读取并解析 YAML。若文件来自向后兼容路径（2 或 3），询问用户是否将其移动到 `.hskill/init-workflow/workflow-config.yml`；用户同意则执行移动，否则继续使用原位置（不影响本次运行）。
 
 ---
 
@@ -154,13 +155,13 @@ git config merge.ff false
 
 ### Step 7 — 从配置渲染并写入工作流文档（差量）
 
-每次运行都根据当前 `workflow-config.yml` 的最终状态重新渲染文档，确保文档与配置始终一致。
+每次运行都根据当前 `.hskill/init-workflow/workflow-config.yml` 的最终状态重新渲染文档，确保文档与配置始终一致。
 
 #### 7a. 渲染文档
 
 ```bash
 python3 <skill-path>/references/render_docs.py \
-  workflow-config.yml \
+  .hskill/init-workflow/workflow-config.yml \
   <skill-path>/references/git-workflow-template.md \
   docs/reference/git-workflow.md
 # 输出 NEW / UPDATED / UNCHANGED
@@ -205,7 +206,7 @@ python3 <skill-path>/references/render_docs.py \
 ```
 文件                                状态
 ─────────────────────────────────────────────────────
-workflow-config.yml                已读取
+.hskill/init-workflow/workflow-config.yml   已读取
 .githooks/.workflow-config.lock    UPDATED（记录新配置快照）
 .githooks/pre-commit               UPDATED（main 块 hash 更新；develop 块新增）
 .githooks/commit-msg               UNCHANGED

package/skills/design/sync-design/SKILL.md

@@ -15,7 +15,7 @@ user_invocable: true
 
 ## 步骤 ①：读取 Manifest
 
-读取 `docs/reference/design-html-manifest.json`。
+读取 `.hskill/sync-design/manifest.json`。
 
 **如果文件不存在：**
 执行【附录 A：首次初始化流程】，完成后继续步骤 ②。
@@ -182,7 +182,7 @@ git diff <entry.lastSyncCommit 或 manifest.baseBranch（如无 lastSyncCommit
 **用户选「是」：**
 1. `git rev-parse HEAD` 获取当前 commit hash
 2. 将所有已处理 entry 的 `lastSyncCommit` 更新为该 hash
-3. 写回 `docs/reference/design-html-manifest.json`（含配置演进的 patterns 变更）
+3. 写回 `.hskill/sync-design/manifest.json`（含配置演进的 patterns 变更）
 4. 询问是否 `git add` 并给出建议 commit message：
    `chore: sync HTML design backups — <entry id 列表>`
 
@@ -304,6 +304,12 @@ find src -name "*.scss" -o -name "variables.css" 2>/dev/null | head -3
 
 ### A-5. 创建 Manifest
 
+```bash
+mkdir -p .hskill/sync-design
+```
+
+将以下内容写入 `.hskill/sync-design/manifest.json`：
+
 ```json
 {
   "version": 3,

package/skills/meta/clean-git/SKILL.md

@@ -21,7 +21,7 @@ version: "1.0.0"
 
 ## Step 1：读取配置
 
-检查 `.claude/branch-cleanup.md` 是否存在：
+检查 `.hskill/clean-git/branch-cleanup.md` 是否存在：
 
 **存在** → 解析三段内容：
 - `## Always Delete` 段：每行 `` `pattern` `` 为必删 glob 规则
@@ -182,8 +182,8 @@ git branch -r | grep "origin/<branch>"
 **若本次无配置文件，询问：**
 
 ```
-未检测到 .claude/branch-cleanup.md。
+未检测到 .hskill/clean-git/branch-cleanup.md。
 是否根据本次规则生成配置文件，方便下次复用？[y/n]
 ```
 
-若用户确认，生成 `.claude/branch-cleanup.md`，内容包含本次使用的 Always Delete / Always Keep 规则和 LLM context。
+若用户确认，生成 `.hskill/clean-git/branch-cleanup.md`，内容包含本次使用的 Always Delete / Always Keep 规则和 LLM context。

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

@@ -1,6 +1,6 @@
 ---
 name: release-project
-description: "Universal project release skill. Triggers on: release, bump version, publish, new version, cut release. Two phases: Init (first run — scans project and generates .hskill/release-profile.md); Execute (daily use — reads profile and runs full release flow). Works with npm, Python, Rust, Java, or any versioned project."
+description: "Universal project release skill. Triggers on: release, bump version, publish, new version, cut release. Two phases: Init (first run — scans project and generates .hskill/release-project/release-profile.md); Execute (daily use — reads profile and runs full release flow). Works with npm, Python, Rust, Java, or any versioned project."
 user_invocable: true
 version: "1.1.0"
 ---
@@ -9,17 +9,17 @@ version: "1.1.0"
 
 通用项目发布 skill，两个阶段：
 
-- **Init** — 扫描项目，和用户确认，生成 `.hskill/release-profile.md`（每个项目做一次）
+- **Init** — 扫描项目，和用户确认，生成 `.hskill/release-project/release-profile.md`（每个项目做一次）
 - **Execute** — 读取 profile，完全按照它走发布流程
 
 ---
 
 ## 入口判断
 
-检查 `.hskill/release-profile.md` 是否存在：
+检查 `.hskill/release-project/release-profile.md` 是否存在：
 
 ```bash
-ls .hskill/release-profile.md 2>/dev/null && echo "EXISTS" || echo "NOT_FOUND"
+ls .hskill/release-project/release-profile.md 2>/dev/null && echo "EXISTS" || echo "NOT_FOUND"
 ```
 
 - **NOT_FOUND** → 执行 Init 阶段
@@ -36,7 +36,7 @@ ls .hskill/release-profile.md 2>/dev/null && echo "EXISTS" || echo "NOT_FOUND"
 
 依次从以下来源收集信息：
 
-1. 项目配置文件：`workflow-config.yml`、`CLAUDE.md`、`AGENTS.md`、`CONTRIBUTING.md`
+1. 项目配置文件：`.hskill/init-workflow/workflow-config.yml`、`CLAUDE.md`、`AGENTS.md`、`CONTRIBUTING.md`
 2. git 历史和现有分支：
 
 ```bash
@@ -101,18 +101,18 @@ ls .github/workflows/ .gitlab-ci.yml .circleci/ 2>/dev/null
 读取 `references/release-profile-template.md` 作为骨架，把 I-1 到 I-4 收集到的信息填进去。
 
 ```bash
-mkdir -p .hskill
+mkdir -p .hskill/release-project
 ```
 
 模板只提供四个顶级节（分支模型、版本文件、发布方式、特殊规则），每节的具体内容完全由项目决定，用最能清楚表达意图的方式写——几行文字、表格、命令示例均可。没有特殊规则就删掉那节。
 
-写完后给用户看，确认无误再保存。告诉用户：**`.hskill/release-profile.md` 可以随时手动编辑**，是下次发版的唯一依据。
+写完后给用户看，确认无误再保存。告诉用户：**`.hskill/release-project/release-profile.md` 可以随时手动编辑**，是下次发版的唯一依据。
 
 ---
 
 ## Execute 阶段
 
-**读取 `.hskill/release-profile.md`，完全按照它执行。** profile 是唯一依据，不在 profile 里的事不要自己发明。
+**读取 `.hskill/release-project/release-profile.md`，完全按照它执行。** profile 是唯一依据，不在 profile 里的事不要自己发明。
 
 ### Step E-0 — 读取 profile + 前置检查
 
@@ -215,7 +215,7 @@ git push origin <tag>
 
 ## 常见问题
 
-**profile 信息有误** — 直接编辑 `.hskill/release-profile.md` 后重新触发 Execute。
+**profile 信息有误** — 直接编辑 `.hskill/release-project/release-profile.md` 后重新触发 Execute。
 
 **发版前检查失败** — 按失败信息修复后，重新从 E-0 开始。
 

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

@@ -2,6 +2,7 @@ import json
 import sys
 import typer
 
+from hub.cli import git as git_cmd
 from hub.cli import projects as proj_cmd
 from hub.cli import tasks as task_cmd
 
@@ -12,3 +13,4 @@ app = typer.Typer(
 )
 app.add_typer(proj_cmd.app, name="projects")
 app.add_typer(task_cmd.app, name="tasks")
+app.add_typer(git_cmd.app, name="git")

package/tools/hub/hub/cli/git.py

@@ -0,0 +1,120 @@
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from hub.core.db import HubDB
+from hub.core.projects import get_project_path
+from hub.tui.git import (
+    fetch_repo,
+    get_branches,
+    get_recent_commits,
+    get_working_tree,
+    is_git_with_remote,
+)
+
+app = typer.Typer(no_args_is_help=True)
+
+
+def _resolve_path(project: Optional[str]) -> Path:
+    if project:
+        db = HubDB()
+        p = get_project_path(db, project)
+        if not p:
+            typer.echo(f"Error: project '{project}' not found", err=True)
+            raise SystemExit(1)
+        return Path(p)
+    return Path.cwd()
+
+
+@app.command("status")
+def git_status(
+    project: Optional[str] = typer.Option(None, "--project", "-p", help="Project name"),
+    commits: int = typer.Option(5, "--commits", "-n", help="Number of recent commits to show"),
+):
+    """Show branch, working tree, and recent commits."""
+    path = _resolve_path(project)
+
+    branches = get_branches(path)
+    current = next((b for b in branches if b["is_current"]), None)
+    wt = get_working_tree(path)
+    recent = get_recent_commits(path, n=commits)
+
+    typer.echo(f"\n{path.name}")
+
+    typer.echo("\nBRANCH")
+    if current:
+        typer.echo(f"  local    {current['name']}")
+        if current["upstream"]:
+            typer.echo(f"  tracking {current['upstream']}")
+            parts = []
+            if current["ahead"]:
+                parts.append(f"↑{current['ahead']}")
+            if current["behind"]:
+                parts.append(f"↓{current['behind']}")
+            typer.echo(f"  sync     {' '.join(parts) if parts else 'up to date'}")
+        else:
+            typer.echo("  tracking none (local only)")
+    else:
+        typer.echo("  not a git repository")
+
+    typer.echo("\nWORKING TREE")
+    total = wt["modified"] + wt["new"] + wt["deleted"]
+    if total == 0:
+        typer.echo("  clean")
+    else:
+        parts = []
+        if wt["modified"]:
+            parts.append(f"{wt['modified']} modified")
+        if wt["new"]:
+            parts.append(f"{wt['new']} new")
+        if wt["deleted"]:
+            parts.append(f"{wt['deleted']} deleted")
+        typer.echo(f"  {', '.join(parts)}")
+
+    if recent:
+        typer.echo("\nRECENT COMMITS")
+        for c in recent:
+            msg = c["msg"][:50] + "…" if len(c["msg"]) > 50 else c["msg"]
+            typer.echo(f"  {c['sha']}  {msg}  ({c['date']})")
+
+    typer.echo("")
+
+
+@app.command("fetch")
+def git_fetch(
+    project: Optional[str] = typer.Option(None, "--project", "-p", help="Project name"),
+):
+    """Fetch all remotes."""
+    path = _resolve_path(project)
+    if not is_git_with_remote(path):
+        typer.echo("No remote configured — nothing to fetch.", err=True)
+        raise SystemExit(1)
+    typer.echo(f"Fetching {path.name}…")
+    fetch_repo(path)
+    typer.echo("Done.")
+
+
+@app.command("branches")
+def git_branches(
+    project: Optional[str] = typer.Option(None, "--project", "-p", help="Project name"),
+):
+    """List branches with upstream sync status."""
+    path = _resolve_path(project)
+    branches = get_branches(path)
+    if not branches:
+        typer.echo("No branches found (not a git repository?).")
+        return
+    for b in branches:
+        marker = "*" if b["is_current"] else " "
+        if b["is_local_only"]:
+            sync = "(local only)"
+        else:
+            parts = []
+            if b["ahead"]:
+                parts.append(f"↑{b['ahead']}")
+            if b["behind"]:
+                parts.append(f"↓{b['behind']}")
+            sync = " ".join(parts) if parts else "up to date"
+        typer.echo(f"  {marker} {b['name']:<32} {sync}")

package/tools/hub/hub.sh

@@ -15,10 +15,20 @@ fi
 
 VENV_DIR="${HOME}/.hskill/tools/hub/venv"
 INSTALL_DIR="${HOME}/.hskill/tools/hub"
+HASH_FILE="${VENV_DIR}/.installed_hash"
 
-if [ ! -x "${VENV_DIR}/bin/hub" ]; then
+_hash_source() {
+  find "${INSTALL_DIR}" -type f \( -name "*.py" -o -name "*.toml" -o -name "*.json" \) \
+    ! -path "*/__pycache__/*" \
+    | sort | xargs sha256sum 2>/dev/null | sha256sum | awk '{print $1}'
+}
+
+CURRENT_HASH=$(_hash_source)
+
+if [ ! -x "${VENV_DIR}/bin/hub" ] || [ "$(cat "${HASH_FILE}" 2>/dev/null)" != "${CURRENT_HASH}" ]; then
   python3 -m venv "${VENV_DIR}"
-  "${VENV_DIR}/bin/pip" install -q "${INSTALL_DIR}"
+  "${VENV_DIR}/bin/pip" install -q --upgrade "${INSTALL_DIR}"
+  echo "${CURRENT_HASH}" > "${HASH_FILE}"
 fi
 
 exec "${VENV_DIR}/bin/hub" "$@"

package/tools/hub/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hub"
-version = "1.0.0"
+version = "1.1.0"
 requires-python = ">=3.11"
 dependencies = [
     "typer>=0.12",

package/tools/hub/tool.json

@@ -1,6 +1,6 @@
 {
   "name": "hub",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "personal developer OS — projects, git status, tasks",
   "extraPaths": ["hub", "pyproject.toml"],
   "uninstallPaths": ["~/.hskill/tools/hub/venv", "~/.hskill/tools/hub"],