himan

himan 是面向个人和团队的 AI 资产（Resource）管理工具，并以 CLI 的方式调用。

适用场景是跨 agent、跨终端、跨项目复用和治理 AI 资产。

它管理 rule、command、skill 和 config，资产存放在 Git source 中，支持版本发布、安装，并通过 himan.lock 固定项目安装结果。

适合谁使用

• 多 agent 使用者：同时使用 Cursor、Claude Code、Codex、OpenClaw、Copilot，希望同一套资产在不同 agent 中保持一致。
• 多项目个人开发者：希望把常用规则、命令、skill 和配置从单个项目中抽离出来，在多个项目间复用。
• 团队或平台维护者：希望用 Git 评审、发布、归档和回滚 AI 资产，并让项目通过 himan.lock 获得稳定一致的安装结果。

为什么用 himan

• 以 Git 作为资产来源：资产源头就是普通 Git 仓库，版本历史、权限、评审和备份沿用团队现有流程。
• 不绑定单一 agent：同一套资产可安装到 Cursor、Claude Code、Codex、OpenClaw、Copilot，不受某个 agent 目录结构限制。
• 安装结果可复现：项目内写入 himan.lock，记录默认 source、可选额外 source、精确版本、目标 agent 和安装模式；换机器后 himan install 即可恢复。
• 在真实项目中开发和验证：create / dev 直接在当前项目的 agent 目录工作，验证后用 publish 回写 source、发布新版本并更新文档索引。
• 适合团队治理：支持多 source、别名、归档、恢复、批量发布、递归安装 skill 依赖，以及 doctor 本地健康检查。

安装

要求 Node.js >=22 <23 和 Git。

npm install -g @hi-man/himan
himan --help

也可以临时运行：

npx @hi-man/himan --help
pnpm dlx @hi-man/himan --help

3 分钟入门

以下示例假设你已有一个可访问、可 push 的空 Git 仓库，用作 himan Git source。

# 1. 初始化 source，并设置当前项目默认 agent
himan init https://github.com/your-org/your-himan-source.git --agent codex

# 2. 创建 skill 空壳，并在当前项目 agent 目录里完善和验证
himan create skill api-review --description "Review API changes"

# 3. 用 coding agent 编写内容，推荐结合 himan-skill-metadata 生成元数据

# 4. 发布 patch 版本，写回 source，并安装回当前项目
himan publish skill api-review

# 5. 检查本机、source、agent、lock 和安装目标
himan doctor

himan create 只负责创建资产空壳；编写 SKILL.md 和维护 himan.yaml 通常交给 coding agent 完成。

如果 source 中已经有可用资产，也可以在初始化时直接安装：

himan init https://github.com/your-org/your-himan-source.git \
  --agent codex \
  --install skill/code-review

换一台机器或同事拉取包含 himan.lock 的项目后：

himan init https://github.com/your-org/your-himan-source.git --agent codex
himan install

himan install 无参数时会按当前项目的 himan.lock 恢复安装，而不是盲目使用最新版本；资源条目未指定 source 时使用 lock 顶层默认 source。

核心概念

| 概念 | 说明 | | ------------ | ------------------------------------------------------------------------------------ | | source | 存放资产的 Git 仓库，目录通常包含 rules/、commands/、skills/、configs/。 | | resource | himan 中的一份可复用、可安装资产，类型为 rule、command、skill、config。 | | agent | 资产安装目标，支持 cursor、claude-code、codex、openclaw、copilot。 | | himan.lock | 项目级锁文件，记录已安装资产的默认 source、可选额外 source、版本、agent 和安装模式。 | | Git tag | 资产版本以 <type>/<name>@<semver> 标记，例如 skill/[email protected]。 |

常用工作流

| 场景 | 命令 | | ------------------- | --------------------------------------------------------------------------------- | | 添加 source | himan source add team https://github.com/your-org/himan-source.git --alias team | | 切换 source | himan source use team | | 设置默认 agent | himan agent use codex | | 安装资产 | himan install skill code-review | | 递归安装 skill 依赖 | himan install skill code-review -r --depth 2 | | 评价资产 | himan comment skill code-review 9 "Stable team default" | | 进入开发态 | himan dev skill code-review | | 发布新版本 | himan publish skill code-review --minor | | 批量发布 | himan publish skill skill-a,skill-b | | 归档资产 | himan resource archive skill old-workflow --reason "Replaced by new-workflow" |

完整命令表见 docs/command-reference.md。

资产仓库结构

your-himan-source/
  README.md
  CHANGELOG.md
  rules/my-rule/content.md
  commands/my-command/content.md
  skills/my-skill/SKILL.md
  configs/my-config/config.toml
  archive/

每个资产目录可以放一个 himan.yaml，用于描述名称、类型、版本、入口、默认 agent、分类、依赖、comment.score / comment.text 评价和静态分析信息。

更多目录规范、安装目标、lock 行为、多 source、归档和发布细节见 docs/user-guide.md。

配套观测工具

himan-tracker 是同一生态下的本地优先观测工具，目前可用于 Codex 数据采集，并面向 Claude Code 等 agent 扩展；它用来统计对话、运行时 token、耗时，以及 skill、MCP tool、Plugin 使用情况。

它适合回答这些问题：哪些 skill 真正在用、哪些资产长期未使用、token 成本趋势如何、团队智能体工作流是否值得继续投入。默认不采集 prompt、response、代码内容、stdout/stderr 或 shell 参数。

npm install -g @hi-man/himan-tracker
himan-tracker setup
himan-tracker summary --since 7d
himan-tracker server start --open

功能支持

| 能力 | 状态 | | --------------------------------- | ---------------------------------------------------- | | Git source | 已支持 | | Registry source | 预留，暂未开放 | | rule / command / skill 资产 | 已支持 | | config 资产 | 已支持 Codex；Cursor、Claude Code、OpenClaw 暂未支持 | | 项目级 himan.lock | 已支持 | | 多 agent 安装 | 已支持 Cursor、Claude Code、Codex、OpenClaw | | skill 依赖递归安装 | 已支持 |

文档

• 用户指南：概念、source 结构、安装目标、lock、发布、归档和 FAQ。
• 命令参考：完整命令速查。
• 错误码：稳定错误码和处理建议。
• 开发文档：本仓库开发、测试和 npm 发布流程。

补充说明

• npm 包只承诺 CLI 使用，不提供稳定 Node.js 程序化 API。