@hi-man/himan 0.4.0 → 0.5.0

package/docs/mvp/README.md

@@ -53,23 +53,20 @@
 ### 2.5 `dev`
 
 - `himan dev <type> <name>`，`type` 支持 `rule|command|skill`；需先 `install`。
-- 将当前安装内容复制到项目开发目录（已存在则默认不覆盖），再按安装模式更新项目目标：
-  - `rule`：`.himan/dev/rule/<name>`
-  - `command`：`.himan/dev/command/<name>`
-  - `skill`：`.himan/dev/skill/<name>`
+- 项目内资源直接在当前 agent 目标目录原地修改；若资源只存在于用户级全局目录，则复制到当前项目对应 agent 目标目录。
 
 ### 2.6 `publish`
 
-- `himan publish <type> <name> --patch|--minor|--major`（默认 patch，三选一）
-- 发布内容优先取项目 `.himan/dev/<type>/<name>`，否则取源仓库内对应资源目录。
+- `himan publish <type> <name> --patch|--minor|--major [--global]`（默认 patch，三选一）
+- 发布内容优先取旧版项目 `.himan/dev/<type>/<name>`，其次取当前项目 agent 目标目录，否则取源仓库内对应资源目录。
 - 新版本：基于已有 tag 最新 semver 递增；无任何历史时从 `0.0.0` 起算。
 - 写回源仓库、提交、打 tag、推送，并将该版本同步到本地 store。
-- 发布成功后，用新版本 store 以 copy 模式重新安装到项目目标、更新 lock，并删除对应 `.himan/dev/<type>/<name>`。
+- 发布过程展示阶段日志。发布成功后，用新版本 store 以 copy 模式重新安装；默认安装到项目目标并更新 lock，`--global` 安装到用户级目录且不写项目 lock。
 
 ### 2.7 `create`
 
 - `himan create <type> <name>` 及常用选项（描述、目标 agent、dry-run、force、json 等）
-- 生成 `rule` / `command` / `skill` 标准目录与 `himan.yaml`、入口模板
+- 在当前项目 agent 目标目录生成 `rule` / `command` / `skill` 标准目录与 `himan.yaml`、入口模板
 - 与 `publish` 衔接：`create → 编辑 → publish`
 
 ### 2.8 `agent`
@@ -103,7 +100,7 @@
 **项目目录：**
 - `.cursor` / `.claude` / `.agents` / `.openclaw`：按 agent 和资源类型保存运行态目标（软链或副本）
 - `.himan/config.json`：项目默认 agent 配置
-- `.himan/dev/<type>/<name>`：资源开发态可编辑副本
+- 当前项目 agent 目标目录：资源创建和开发态可编辑位置；旧版 `.himan/dev/<type>/<name>` 仍可作为 publish 输入
 
 **源仓库内资源布局：**
 - `rules/<name>/`、`commands/<name>/`、`skills/<name>/`，可含 `himan.yaml`，并包含约定入口文件（如 `content.md`、`SKILL.md`）。

package/docs/mvp/create-resource.md

@@ -58,10 +58,10 @@ repo/
 
 可用 `himan source init-docs` 生成根目录文档模板。命令默认只创建缺失的 `README.md` / `CHANGELOG.md`；已有文件会保留，除非显式传 `--force`。`--force` 覆盖文档时会扫描当前 source 中已有的 `rule`、`command`、`skill`，写入 README 资源索引，并在 CHANGELOG 初始条目中记录已整理的资源。资源引用会优先使用 Git tag 中的最新 semver 版本，找不到 tag 时再回退到 `himan.yaml` 的 `version`。对于尚未补齐 `himan.yaml` 的资源，文档整理会按默认入口识别资源；其中 skill 会额外读取 `skills/<name>/SKILL.md` front matter 中的 `name` 和 `description`。`--dry-run` 只返回将执行的创建、覆盖或跳过动作，不写盘。有实际文件变更时，命令会提交并 push 到当前 Git source。
 
-`create` 和 `publish` 会自动维护根目录文档：
+`create` 默认只在当前项目 agent 目标目录生成可验证资源；`publish` 会把项目目录中的资源同步回 source 仓库，并自动维护根目录文档：
 
 - `README.md`：只维护 `<!-- himan:resources:start -->` / `<!-- himan:resources:end -->` 标记内的资源索引；如果旧 README 没有标记，则在文件末尾追加受控资源索引区
-- `CHANGELOG.md`：向 `[Unreleased]` 写入资源变更；新增资源写入 `Added`，发布版本写入 `Changed`
+- `CHANGELOG.md`：向 `[Unreleased]` 写入发布版本的 `Changed` 条目
 
 推荐的 `README.md` 基本结构：
 
@@ -110,15 +110,15 @@ himan install rule code-review
 
 ## 4. 资源目录与元数据
 
-`create` 生成资源目录，结构示例：
+`create` 生成当前项目 agent 目标目录，结构示例：
 
 ```text
-repo/
-  rules/<name>/
+project/
+  .cursor/rules/<name>/
     content.md
-  commands/<name>/
+  .cursor/commands/<name>/
     content.md
-  skills/<name>/
+  .agents/skills/<name>/
     SKILL.md
 ```
 
@@ -143,7 +143,7 @@ agents:
 
 1. 读取本地配置，确认已初始化源
 2. 校验类型与资源名格式
-3. 解析目标路径 `rules|commands|skills/<name>`
+3. 解析当前项目 agent 目标路径，例如 `.agents/skills/<name>`
 4. 目录已存在且无 `--force` → 报错
 5. 生成 `himan.yaml` 与入口模板（`--dry-run` 则不落盘）
 6. 终端或 `--json` 输出结果；下一步由用户编辑再 `publish`
@@ -178,17 +178,17 @@ agents:
 ## 9. 与资源工作流衔接
 
 ```text
-create → edit → publish
+create → edit in project agent folder → publish
 ```
 
-`create` 会在当前 Git source 缓存仓库中生成资源目录；用户编辑该目录后执行 `publish`。资源已有发布版本并安装到项目后，可再进入 `dev` 工作流：
+`create` 会在当前项目 agent 目标目录中生成资源目录；用户编辑并验证该目录后执行 `publish`。资源已有发布版本并安装到项目后，可再进入 `dev` 工作流，直接在项目 agent 目标目录原地修改：
 
 ```bash
 himan create rule code-review --description "enforce standards"
 himan publish rule code-review --patch
 himan install rule code-review
 himan dev rule code-review
-# 编辑 .himan/dev/rule/code-review/
+# 编辑 .cursor/rules/code-review/ 或当前默认 agent 对应目录
 himan publish rule code-review --patch
 ```
 

package/docs/mvp/impl.md

@@ -14,7 +14,7 @@
 **原则：**
 
 - 本地 store 按版本存放，已存在的版本目录不被覆盖（安装时复用缓存）
-- 开发目录 `.himan/dev` 与运行态 agent 目录（`.cursor` / `.claude` / `.agents` / `.openclaw`）分离
+- 创建和开发默认直接使用运行态 agent 目录（`.cursor` / `.claude` / `.agents` / `.openclaw`），旧版 `.himan/dev` 目录仅作为兼容发布输入
 - 正式发布版本以 **Git Tag** 为唯一事实来源；`himan.yaml` 中的 version 在发布时会与 tag 对齐
 
 ---
@@ -49,21 +49,21 @@
 ### 2.5 `dev <type> <name>`
 
 - 命令层接受 `rule|command|skill`；依赖已安装（能解析当前安装目标）
-- 将当前安装内容复制到 `.himan/dev/<type>/<name>`（目录已存在则默认不覆盖）
-- 按安装模式将项目目标更新为 dev 目录的软链或副本
+- 当前项目已存在资源时直接返回项目 agent 目标目录，用户原地修改
+- 当前项目不存在但用户级全局目录存在时，将全局资源复制到当前项目对应 agent 目标目录
 
 ### 2.6 `publish <type> <name>`
 
-- 发布源：优先项目 `.himan/dev/<type>/<name>`，否则缓存仓库内该资源目录
+- 发布源：优先旧版项目 `.himan/dev/<type>/<name>`，其次当前项目 agent 目标目录，否则缓存仓库内该资源目录
 - 下一版本：基于历史最新 tag；无历史则从 `0.0.0` 按 patch/minor/major 递增
 - 将内容同步回缓存仓库中的规范路径，更新元数据中的版本字段，提交、打 tag、推送
 - 将新 tag 对应内容拉取到 store 新版本目录
-- 用新版本 store 以 copy 模式重新安装项目内对应类型目标，更新 lock，并删除对应 `.himan/dev/<type>/<name>` 开发目录
+- 发布过程展示阶段日志；用新版本 store 以 copy 模式重新安装。默认安装到项目内对应类型目标并更新 lock，`--global` 安装到用户级目标且不写项目 lock
 
 ### 2.7 `create <type> <name>`
 
 - 校验类型与资源命名规则
-- 在缓存仓库中创建 `rules|commands|skills/<name>` 及 `himan.yaml`、入口模板
+- 在当前项目 agent 目标目录创建 `rules|commands|skills/<name>` 及 `himan.yaml`、入口模板
 - 支持覆盖、试运行、JSON 输出；创建后不自动发布
 
 ### 2.8 `agent`

package/package.json

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