快速上手

1. 先看清楚

ipman            # 终端：交互式 TUI（两屏：scope 全景 → 启用区+归档区）
ipman status     # 纯文本全景
ipman scan       # 深扫：野生技能、重复组、断链

2. 接管散装技能

ipman absorb --user            # 清点 ~/.claude/skills：哪些可接管
ipman absorb --user my-notes   # 接管一个：收进存储（git 建档）、原位换软链
ipman absorb --user --all      # 全部散装技能（git clone 与套件自动豁免）

agent 看到的技能一模一样；marketplace 插件、套件外壳（如 gstack）、git clone 一概不碰。

3. 去重与清理

ipman dedup            # 重复报告（dry-run）→ --apply 合并为一份原件
ipman clean            # 清理报告（dry-run）→ --apply 移入 ~/.ipman/trash 隔离区

4. 停用 / 启用 / 功能包

ipman disable my-notes --scope user    # 撤链留档——还在本机，不是删除
ipman enable  my-notes --scope user    # 精确恢复到停用前的版本
ipman pack create writing-kit my-notes baoyu-comic
ipman enable --pack writing-kit --scope .    # 整包装进当前项目

TUI 里：Space 多选 → p 一键生成功能包；归档区一键启用。

5. 接管目录（可选的保护层）

ipman takeover user    # 整个 ~/.claude/skills 交给 IpMan 保管（agent 无感）
ipman release  user    # 随时归还，内容原地恢复

被接管的 scope 经得起事故：链接被误删也只需 ipman sync --user 一键重建。

6. 在 agent 里用

ipman skill-sync --scope claude-code-user   # 显式安装伴生技能（ipman + ipman-update）
ipman statusline                            # agent 状态栏单行状态

之后对 agent 说"整理一下我的技能"——同一套引擎，每个写入动作先征求确认。想更新工具时说"更新 ipman"即触发 /ipman-update。详见 在 agent 里使用。