`ruflo plugins install` 命令不存在（正确技能入口是 npx skills add）

你会遇到什么

你跑 ruflo migrate status（或其它提示命令），工具贴心地建议你执行 ruflo plugins install <plugin> 修复——但这条命令根本不存在，或语法错误，复制粘贴直接失败。这不是你敲错了，是工具自己的提示文案指向了错误的子系统和语法。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

先给结论：插件/技能安装面不是 plugins install（issue #2985，2026-08-12），提示文案与实际命令面脱节。

链路：工具内提示 → 你执行 → 命令面解析 → 无此命令/语法错误。断点在第二步：用户被引导到不存在的入口——这是工具的错误报告缺口，不是你的操作问题。

实测（2026-08-29，v3.38.20）：npx -y ruflo init --no-signup --no-skills-sh --no-codex-detect 成功；init 日志明确给出技能安装的正确入口：Want all 267 plugin skills? npx skills add ruvnet/ruflo --all。

推论：遇到「工具提示你跑它建议的命令却跑不通」，以 ruflo --help 的实际命令面为准——实测命令面为 init/start/status 等 PRIMARY COMMANDS；拿不准再查官方文档或对应 issue。

一步步来

1. 先看真实命令面 — 必做

ruflo --help：PRIMARY COMMANDS 为 init/start/status 等；没有 plugins install。

2. 技能安装用 skills 入口 — 必做

npx skills add ruvnet/ruflo --all（267 个插件技能；本市场 init 时用 --no-skills-sh 跳过了全量拉取，未实测全量，如实标注）。

3. 初始化用 init — 必做

npx -y ruflo init；交互注册场景加 --no-signup --no-codex-detect。

4. 命令拿不准时 — 排查

以 --help 为准，再查 issue（如 #2985）确认是否已知的提示文案缺陷。

怎么确认修好了

• ruflo --version 输出版本（实测 ruflo v3.38.20）；
• init 正常完成并给出后续提示（技能入口、daemon 提示等）。

其它环境的表现

• 国内网络：init 建议走 npmmirror（npm_config_registry=https://registry.npmmirror.com）；
• 常见混淆：migrate status 的提示文案 ≠ 可执行命令，以 --help 为准；

症状

ruflo migrate status 等提示建议执行 ruflo plugins install <plugin>，但该命令不存在或语法错误，打印的修复无法成功。

原因

错误的子系统 + 错误的语法（issue #2985，2026-08-12）：插件/技能安装面不是 plugins install。实测 init 输出显示技能安装正确入口是 npx skills add ruvnet/ruflo --all（267 个插件技能）。

解法

1. 技能安装：npx skills add ruvnet/ruflo --all（init 输出建议；本市场 2026-08-29 init 时 --no-skills-sh 跳过，未实测全量拉取）。
2. 初始化：npx -y ruflo init（交互注册场景用 --no-signup --no-codex-detect 跳过）。
3. 不确定的命令先 ruflo --help 查命令面（实测输出：init/start/status 等 PRIMARY COMMANDS）。