ponytail-install

一键把 ponytail 技能装进本机所有 AI coding agent。 只有 node 环境就能跑，零依赖，不需要在 agent 里配任何东西。

用法

npx ponytail-install                # 探测 + 安装到所有检测到的工具
npx ponytail-install list           # 查看检测到哪些工具、装没装
npx ponytail-install uninstall      # 卸载（只删本工具装过的，不碰你其他技能）
npx ponytail-install --tools=claude,codex,opencode   # 只装指定工具
npx ponytail-install --dry-run      # 预演，不写文件

安装幂等，可重复执行；重复跑就是覆盖更新到最新版技能。

装完重启 agent 即生效（各工具都会自动扫描技能目录，无需配置）。

装了什么

6 个技能（原样来自 @dietrichgebert/ponytail 的 skills/）：

| 技能 | 作用 | |---|---| | ponytail | 主技能：懒人资深开发模式 | | ponytail-audit | 全仓库过度工程审计 | | ponytail-debt | 记下所有 ponytail 捷径债务 | | ponytail-gain | 展示基准收益记分板 | | ponytail-help | 模式速查卡 | | ponytail-review | 只抓复杂度的代码审查 |

支持的 agent 工具（自动探测，装了哪个就装哪个）

| 工具 | 目标目录 | 状态 | |---|---|---| | Claude Code | ~/.claude/skills | 官方 | | Codex | ~/.codex/skills | 官方 | | opencode | ~/.config/opencode/skills | 官方 | | Trae / Trae CN / Trae Work / TRAE SOLO | ~/.trae/skills | 实测 | | WorkBuddy | ~/.workbuddy/skills | 实测 | | Cursor | ~/.cursor/skills-cursor | 实测（新版目录名） | | .agents 通用兼容层 | ~/.agents/skills | opencode 与 Codex 都认 | | Qoder / QoderWork | ~/.qoder/skills | 尽力而为（官方支持存疑，无副作用） |

探测规则：对应工具目录存在即装。没检测到的工具会跳过，不报错。

卸载

uninstall 按各目录下的 .ponytail-manifest.json 精确删除自己装过的 6 个技能， 不会碰你手工放的其他技能。

技能文件从哪来

skills/ 目录是从 @dietrichgebert/ponytail 打包同步的，发布时随包分发，运行时零依赖、离线可用。 要跟随上游更新：重新复制上游包的 skills/ 目录，升版本号再发布。

开发

npm test    # 跑 list 验证本机探测

本机验证链路：install → uninstall → 重装，覆盖 8 个目标目录全通过。