Skip to content

在 agent 里使用

IpMan 既是命令行工具，也是一组伴生技能——你可以直接对 agent 说"整理一下我的技能"，由它驱动同一套引擎完成。

安装伴生技能

ipman skill-sync --scope claude-code-user

--scope 可以是 user（全局 ~/.claude/skills）、.（当前项目——需先在该项目 ipman init），或 ipman status 里看到的某个 <scope-id>。没有显式 scope 就不会安装。

这会把两个技能装进你的 agent 技能目录：

  • ipman —— 管家技能。教 agent 用 ipman status --json 等命令渲染面板、征得确认后执行整理动作。
  • ipman-update —— 更新技能（见下）。

原则：IpMan 从不擅自安装到任何地方，安装目标必须显式登记；技能内容与 CLI 版本严格锁步（ipman skill-sync --check 做三方版本对比：技能 vs CLI vs PyPI）。

更新：/ipman-update

命令行由 PyPI 更新，技能由 CLI 重新生成。/ipman-update 技能把这两步串起来：

  1. ipman skill-sync --check --json 检查是否有新版
  2. 检测安装方式（pipx / uv / pip），征得同意后升级 CLI
  3. ipman skill-sync 重新生成全部伴生技能，让它们与新 CLI 对齐

绝不静默升级；只更新已登记的目标；技能内自更新走 --self 原地再生，零探测。

状态栏

ipman statusline    # -> 📦 user⚑12 | myproj✓3 | !1断链

⚑ 表示目录已接管，✓ 表示原生（未接管）；异常计数（如断链）仅在非零时显示。性能 <50ms（读缓存，不做实时深扫）。

在 Claude Code 的 settings.json 里，把它加进（或追加到）你的 statusLine 命令即可常驻显示。

agent 场景的交互协议

agent 里不跑 TUI，但体验同构。伴生技能规定三步：

  1. 渲染面板 —— 用 ipman status --json / scan --json 在聊天里渲染与 TUI 同构的面板（scope 全景、启用区/归档区，同一套状态词汇）。
  2. 选择与确认 —— 候选少时用宿主的选项问答（方向键+空格+回车，体验同 /plugin）；候选多时按编号点名。凡写入类动作（absorb/dedup --apply/clean --apply/takeover/release/enable/disable/pack create）必经一次显式确认，dry-run 结果先展示。
  3. 执行并回报 —— 调用与 TUI 完全相同的 CLI 命令，把结果对照面板复述。

三种形态一套引擎：人直接跑 ipman → TUI；人在 agent 内 → 三步协议；脚本/CI → --json + 退出码。statusline 作为常驻被动展示补充第四种。

语言

伴生技能的触发词与面板会随你的 locale 呈现；CLI 输出的状态值、报错也按 LANG/LC_ALL 自动中英切换。