@hi-man/himan 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -6,6 +6,22 @@ The format is based on Keep a Changelog, and this project follows semver for the
 
 ## [Unreleased]
 
+## [0.5.2] - 2026-05-14
+
+### Added
+
+- Added `-g` as a shorthand for `--global` on `install`, `publish`, `agent use`, and `agent clear`.
+
+### Fixed
+
+- Fixed the `himan-resource-manage` skill to stop create/dev/publish workflows when the local Himan CLI is older than the project-directory resource flow.
+
+## [0.5.1] - 2026-05-14
+
+### Fixed
+
+- Fixed `himan-skill-metadata` version resolution so existing skills use lock/source metadata before falling back to `0.0.1` for new skills.
+
 ## [0.5.0] - 2026-05-14
 
 ### Added

package/README.md

@@ -62,7 +62,7 @@ himan publish rule my-rule --patch
   - `claude-code` -> `.claude/{rules|commands|skills}/<name>`
   - `codex` -> `.agents/{rules|commands|skills}/<name>`
   - `openclaw` -> `.openclaw/{rules|commands|skills}/<name>`
-- 加 `--global` 时会安装到用户级 agent 目录，并仍按当前项目生效的 agent 选择目标：
+- 加 `-g` / `--global` 时会安装到用户级 agent 目录，并仍按当前项目生效的 agent 选择目标：
   - `cursor` -> `~/.cursor/{rules|commands|skills}/<name>`
   - `claude-code` -> `~/.claude/{rules|commands|skills}/<name>`
   - `codex` -> `~/.agents/{rules|commands|skills}/<name>`
@@ -72,9 +72,9 @@ himan publish rule my-rule --patch
   - `command` -> `.agents/commands/<name>`
   - `skill` -> `.agents/skills/<name>`
   `dev` 修改项目内资源时不再创建 `.himan/dev`，只在资源仅存在于用户级全局目录时复制到当前项目对应 agent 目录。
-- lock 文件：项目安装 `install <type> <name[@version]>` 会写入 `himan.lock`，记录 source、精确版本、agent 和安装模式；`himan install`（无参数）会按 lock 记录的 source 批量恢复安装，不受当前 default source 切换影响。`--global` 安装不写当前项目的 `himan.lock`。
+- lock 文件：项目安装 `install <type> <name[@version]>` 会写入 `himan.lock`，记录 source、精确版本、agent 和安装模式；`himan install`（无参数）会按 lock 记录的 source 批量恢复安装，不受当前 default source 切换影响。`-g` / `--global` 安装不写当前项目的 `himan.lock`。
 - 安装模式：默认 `--mode copy` 将资源复制到目标 agent 目录；也可用 `--mode link` 使用软链，lock 会记录并复现该模式。
-- 默认 agent：`agent use <agent>` 默认写当前项目 `.himan/config.json`；加 `--global` 写入 `~/.himan/config.json`。当前项目配置优先于全局配置。
+- 默认 agent：`agent use <agent>` 默认写当前项目 `.himan/config.json`；加 `-g` / `--global` 写入 `~/.himan/config.json`。当前项目配置优先于全局配置。
 
 版本以 Git tag 为准，格式：`rule/my-rule@1.0.0`。更多设计见 [docs/mvp](./docs/mvp/README.md)。
 
@@ -196,19 +196,19 @@ analysis:
 | 命令                              | 说明                                                      |
 | --------------------------------- | --------------------------------------------------------- |
 | `list [type] [--agent a,b] [--json]` | 查看当前项目 `himan.lock` 中记录的已安装资源；未传 `type` 时按 `rule`/`command`/`skill` 分组展示 |
-| `install [type] [name[@version]] [--global] [--agent a,b] [--mode link\|copy] [--include-archived]` | 有参数时从当前 default source 安装指定资源；**无参数**时按 `himan.lock` 记录的 source 批量安装；加 `--global` 时安装到用户级 agent 目录且不写项目 lock；可覆盖安装目标 agent 或安装模式；归档资源必须显式传 `--include-archived` 才能按历史版本安装 |
+| `install [type] [name[@version]] [-g\|--global] [--agent a,b] [--mode link\|copy] [--include-archived]` | 有参数时从当前 default source 安装指定资源；**无参数**时按 `himan.lock` 记录的 source 批量安装；加 `-g` / `--global` 时安装到用户级 agent 目录且不写项目 lock；可覆盖安装目标 agent 或安装模式；归档资源必须显式传 `--include-archived` 才能按历史版本安装 |
 | `dev <type> <name>`               | 切换到开发态；项目资源原地编辑，全局资源先复制到当前项目目标目录 |
 | `uninstall <type> <name>`         | 从项目移除安装目标，并同步删除 `himan.lock` 条目           |
-| `publish <type> <name> [--global]` | 默认 `--patch`；可选 `--minor` / `--major`（勿同时使用多个）；发布后默认安装到当前项目并更新 lock，`--global` 安装到用户级目录 |
+| `publish <type> <name> [-g\|--global]` | 默认 `--patch`；可选 `--minor` / `--major`（勿同时使用多个）；发布后默认安装到当前项目并更新 lock，`-g` / `--global` 安装到用户级目录 |
 
 ### 4) agent（默认 Agent）
 
 | 命令 | 说明 |
 |------|------|
 | `agent list [--json]` | 查看支持的 agent |
-| `agent use <agent[,agent]> [--project\|--global] [--json]` | 设置当前项目或全局默认 agent；默认 `--project` |
+| `agent use <agent[,agent]> [--project\|-g\|--global] [--json]` | 设置当前项目或全局默认 agent；默认 `--project` |
 | `agent current [--json]` | 查看当前项目、全局和最终生效的默认 agent |
-| `agent clear [--project\|--global] [--json]` | 清除当前项目或全局默认 agent；默认 `--project` |
+| `agent clear [--project\|-g\|--global] [--json]` | 清除当前项目或全局默认 agent；默认 `--project` |
 
 ### 5) doctor（可用性检查）
 
@@ -226,9 +226,9 @@ analysis:
 - `himan doctor ...`
 
 说明：资源与项目相关命令统一使用 `--agent` 指定目标 Agent。
-若未显式传 `--agent`，`create` / `install` 会使用当前项目默认 agent、全局默认 agent、资源 metadata 或内置默认 `cursor` 中最合适的一项；`dev` 会优先使用当前项目已有安装位置，找不到时再从用户级全局安装位置复制到当前项目。`install --global` 会优先复用当前项目 lock 里该资源的 agent，未命中时再使用默认 install 解析顺序，但目标根目录是用户 home 下对应 agent 目录。
+若未显式传 `--agent`，`create` / `install` 会使用当前项目默认 agent、全局默认 agent、资源 metadata 或内置默认 `cursor` 中最合适的一项；`dev` 会优先使用当前项目已有安装位置，找不到时再从用户级全局安装位置复制到当前项目。`install -g` / `install --global` 会优先复用当前项目 lock 里该资源的 agent，未命中时再使用默认 install 解析顺序，但目标根目录是用户 home 下对应 agent 目录。
 
-`publish` 会展示 prepare、resolve-version、publish-source、sync-store、install、cleanup、done 等阶段日志。发布源优先使用旧版 `.himan/dev` 目录，其次使用当前项目 agent 目标目录，最后回退到 source 仓库对应资源目录。若资源目录包含 `himan.yaml`，发布前会校验元数据与入口文件；若没有 `himan.yaml`，则按默认入口推断最小元数据并发布，不会强制创建 `himan.yaml`。若待发布资源内容与最新已发布版本一致，则以 `E_PUBLISH_NO_CHANGES` 终止发布。发布需要可推送的 Git 权限。发布 commit 会包含资源目录以及自动维护的 source 根目录 `README.md` / `CHANGELOG.md`。发布成功后会从新版本 store 以 `copy` 模式重新安装；默认安装到当前项目并更新 `himan.lock`，传 `--global` 时安装到用户级目录且不写当前项目 lock。
+`publish` 会展示 prepare、resolve-version、publish-source、sync-store、install、cleanup、done 等阶段日志。发布源优先使用旧版 `.himan/dev` 目录，其次使用当前项目 agent 目标目录，最后回退到 source 仓库对应资源目录。若资源目录包含 `himan.yaml`，发布前会校验元数据与入口文件；若没有 `himan.yaml`，则按默认入口推断最小元数据并发布，不会强制创建 `himan.yaml`。若待发布资源内容与最新已发布版本一致，则以 `E_PUBLISH_NO_CHANGES` 终止发布。发布需要可推送的 Git 权限。发布 commit 会包含资源目录以及自动维护的 source 根目录 `README.md` / `CHANGELOG.md`。发布成功后会从新版本 store 以 `copy` 模式重新安装；默认安装到当前项目并更新 `himan.lock`，传 `-g` / `--global` 时安装到用户级目录且不写当前项目 lock。
 
 `rename` 暂不推荐使用。该命令会移动 source 仓库里的资源目录并更新资源 metadata 名称、README 资源索引和 CHANGELOG。已有发布 tag 不会被改写；若旧资源已有历史版本，rename 会为新名字创建一个指向当前最新版本的 tag。默认会迁移当前项目中对应的安装目标、`.himan/dev` 副本和 lock 条目；传 `--no-project` 时只改 source。对于 skill，命令只自动更新 metadata / front matter 中的精确 `name` 字段，不会自动替换 `SKILL.md` 正文中的旧名称引用。
 

package/dist/cli/agent-commands.js

@@ -21,7 +21,7 @@ export function registerAgentCommands(command, services) {
     command
         .command("use")
         .argument("<agent_list>", "agent list, comma separated")
-        .option("--global", "save as global default")
+        .option("-g, --global", "save as global default")
         .option("--project", "save as current project default")
         .option("--json", "output json format")
         .description("Set default agents globally or for current project")
@@ -54,7 +54,7 @@ export function registerAgentCommands(command, services) {
     });
     command
         .command("clear")
-        .option("--global", "clear global default agents")
+        .option("-g, --global", "clear global default agents")
         .option("--project", "clear current project default agents")
         .option("--json", "output json format")
         .description("Clear configured default agents")
@@ -71,7 +71,7 @@ export function registerAgentCommands(command, services) {
 }
 function parseScope(options) {
     if (options.global && options.project) {
-        throw new HimanError(errorCodes.CLI_USAGE, "Use only one of --global or --project.");
+        throw new HimanError(errorCodes.CLI_USAGE, "Use only one of -g/--global or --project.");
     }
     return options.global ? "global" : "project";
 }

package/dist/cli/project-commands.js

@@ -38,7 +38,7 @@ export function registerProjectCommands(command, services, options = {}) {
         .argument("[name[@version]]", "resource name with optional @version")
         .option("--agent <list>", "install target agents, comma separated")
         .option("--mode <mode>", "install mode: link or copy")
-        .option("--global", "install into user-level agent directories")
+        .option("-g, --global", "install into user-level agent directories")
         .option("--include-archived", "allow installing an archived resource explicitly")
         .description("Install resource, or install from himan.lock")
         .action(async (type, nameVersion, options) => {
@@ -51,7 +51,7 @@ export function registerProjectCommands(command, services, options = {}) {
                 }
                 if (options.global) {
                     throw new HimanError(errorCodes.CLI_USAGE, "Global install requires a resource:\n"
-                        + "  - himan install <type> <name[@version]> --global [--mode link|copy]");
+                        + "  - himan install <type> <name[@version]> -g [--mode link|copy]");
                 }
                 const results = await services.installFromLock(process.cwd(), agents, mode);
                 if (results.length === 0) {
@@ -67,7 +67,7 @@ export function registerProjectCommands(command, services, options = {}) {
                 throw new HimanError(errorCodes.CLI_USAGE, "Install usage:\n"
                     + "  - himan install  # install from himan.lock\n"
                     + "  - himan install <type> <name[@version]> [--mode link|copy]  # install single resource\n"
-                    + "  - himan install <type> <name[@version]> --global [--mode link|copy]  # install single resource globally");
+                    + "  - himan install <type> <name[@version]> -g [--mode link|copy]  # install single resource globally");
             }
             const resourceType = ensureResourceType(type);
             const { name, version } = parseNameVersion(nameVersion);
@@ -112,7 +112,7 @@ export function registerProjectCommands(command, services, options = {}) {
         .option("--patch", "patch release")
         .option("--minor", "minor release")
         .option("--major", "major release")
-        .option("--global", "install the published version into user-level agent directories")
+        .option("-g, --global", "install the published version into user-level agent directories")
         .description("Publish resource (default: --patch)")
         .action(async (type, name, options) => {
         await runAction(async () => {
@@ -121,7 +121,7 @@ export function registerProjectCommands(command, services, options = {}) {
             const installScope = options.global ? "global" : "project";
             process.stdout.write(options.global
                 ? "Published resource will be installed globally; current project lock will not be updated.\n"
-                : "Published resource will be installed into the current project and recorded in himan.lock. Use --global to install globally instead.\n");
+                : "Published resource will be installed into the current project and recorded in himan.lock. Use -g/--global to install globally instead.\n");
             const result = await services.publish(resourceType, name, releaseType, process.cwd(), {
                 installScope,
                 onProgress: (progress) => {

package/docs/mvp/README.md

@@ -57,11 +57,11 @@
 
 ### 2.6 `publish`
 
-- `himan publish <type> <name> --patch|--minor|--major [--global]`（默认 patch，三选一）
+- `himan publish <type> <name> --patch|--minor|--major [-g|--global]`（默认 patch，三选一）
 - 发布内容优先取旧版项目 `.himan/dev/<type>/<name>`，其次取当前项目 agent 目标目录，否则取源仓库内对应资源目录。
 - 新版本：基于已有 tag 最新 semver 递增；无任何历史时从 `0.0.0` 起算。
 - 写回源仓库、提交、打 tag、推送，并将该版本同步到本地 store。
-- 发布过程展示阶段日志。发布成功后，用新版本 store 以 copy 模式重新安装；默认安装到项目目标并更新 lock，`--global` 安装到用户级目录且不写项目 lock。
+- 发布过程展示阶段日志。发布成功后，用新版本 store 以 copy 模式重新安装；默认安装到项目目标并更新 lock，`-g` / `--global` 安装到用户级目录且不写项目 lock。
 
 ### 2.7 `create`
 
@@ -72,9 +72,9 @@
 ### 2.8 `agent`
 
 - `himan agent list` 查看支持的 agent。
-- `himan agent use <agent[,agent]>` 设置当前项目默认 agent；加 `--global` 设置全局默认 agent。
+- `himan agent use <agent[,agent]>` 设置当前项目默认 agent；加 `-g` / `--global` 设置全局默认 agent。
 - `himan agent current` 查看当前项目、全局和最终生效的默认 agent。
-- `himan agent clear` 清除默认 agent 配置；默认清除当前项目，加 `--global` 清除全局配置。
+- `himan agent clear` 清除默认 agent 配置；默认清除当前项目，加 `-g` / `--global` 清除全局配置。
 - 默认 agent 解析顺序：显式 `--agent` > 当前项目配置 > 全局配置 > 资源 metadata > `cursor`。
 
 ---

package/docs/mvp/impl.md

@@ -58,7 +58,7 @@
 - 下一版本：基于历史最新 tag；无历史则从 `0.0.0` 按 patch/minor/major 递增
 - 将内容同步回缓存仓库中的规范路径，更新元数据中的版本字段，提交、打 tag、推送
 - 将新 tag 对应内容拉取到 store 新版本目录
-- 发布过程展示阶段日志；用新版本 store 以 copy 模式重新安装。默认安装到项目内对应类型目标并更新 lock，`--global` 安装到用户级目标且不写项目 lock
+- 发布过程展示阶段日志；用新版本 store 以 copy 模式重新安装。默认安装到项目内对应类型目标并更新 lock，`-g` / `--global` 安装到用户级目标且不写项目 lock
 
 ### 2.7 `create <type> <name>`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hi-man/himan",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Prompt and agent asset management CLI",
   "keywords": [
     "ai",