⚡

Navigator多Claude工作流安装器 nav-install-multi-claude

用于并行AI执行的多Claude工作流编排脚本安装器，支持自动检测和安装必要的脚本，以实现高效的AI工作流管理。关键词：多Claude、并行执行、工作流编排、AI执行。

AI应用 0 次安装 0 次浏览 更新于 3/4/2026

安装Navigator多Claude工作流编排脚本。当用户说“安装多Claude工作流”、“设置多Claude”或“启用并行执行”时自动调用。

Navigator多Claude工作流安装器

安装多Claude编排脚本以实现并行AI执行。

何时调用

自动调用当用户说：

  • “安装多Claude工作流”
  • “设置多Claude编排”
  • “启用并行执行”
  • “完成Navigator 4.3.0安装”
  • “安装Navigator工作流”

不要调用如果：

  • 脚本已安装（检查which navigator-multi-claude.sh）
  • 用户只是询问多Claude（信息性的）
  • Navigator插件未安装

安装内容

脚本安装到$HOME/bin/：

  • navigator-multi-claude.sh - 完整的6阶段工作流编排
  • navigator-multi-claude-poc.sh - 简单的3阶段POC
  • install-multi-claude.sh - 本安装器（用于将来更新）

为什么需要：插件安装只复制技能/模板。多Claude脚本位于插件结构之外，需要单独安装。

执行步骤

第1步：检查是否已安装

if command -v navigator-multi-claude.sh &> /dev/null; then
  INSTALLED_PATH=$(which navigator-multi-claude.sh)
  INSTALLED_VERSION=$(grep -o 'VERSION=.*' "$INSTALLED_PATH" | head -1 | cut -d'=' -f2 | tr -d '"' || echo "unknown")

  echo "✅ 多Claude工作流已安装"
  echo ""
  echo "位置：$INSTALLED_PATH"
  echo "版本：$INSTALLED_VERSION"
  echo ""
  echo "要重新安装/更新："
  echo "  rm $INSTALLED_PATH"
  echo "  '安装多Claude工作流'"

  exit 0
fi

第2步：验证先决条件

# 检查Claude CLI
if ! command -v claude &> /dev/null; then
  echo "❌ 未在PATH中找到Claude Code CLI"
  echo ""
  echo "多Claude工作流需要Claude Code CLI来生成子Claude实例。"
  echo ""
  echo "首先安装Claude Code，然后重试："
  echo "  https://docs.claude.com/claude-code/installation"
  exit 1
fi

# 检查Navigator插件是否安装
PLUGIN_PATHS=(
  "$HOME/.claude/plugins/marketplaces/navigator-marketplace"
  "$HOME/.config/claude/plugins/navigator"
  "$HOME/.claude/plugins/navigator"
)

PLUGIN_FOUND=false
for path in "${PLUGIN_PATHS[@]}"; do
  if [ -d "$path" ]; then
    PLUGIN_FOUND=true
    PLUGIN_PATH="$path"
    break
  fi
done

if [ "$PLUGIN_FOUND" = false ]; then
  echo "❌ 未找到Navigator插件"
  echo ""
  echo "首先安装Navigator插件："
  echo "  /plugin marketplace add alekspetrov/navigator"
  echo "  /plugin install navigator"
  exit 1
fi

echo "✅ 先决条件验证通过"
echo "   - Claude CLI：$(which claude)"
echo "   - Navigator插件：$PLUGIN_PATH"
echo ""

第3步：从GitHub下载最新脚本

echo "📥 从GitHub下载多Claude脚本..."
echo ""

# 检测已安装插件版本
if [ -f "$PLUGIN_PATH/.claude-plugin/plugin.json" ]; then
  PLUGIN_VERSION=$(grep -o '"version": "[^"]*"' "$PLUGIN_PATH/.claude-plugin/plugin.json" | head -1 | cut -d'"' -f4)
  VERSION_TAG="v$PLUGIN_VERSION"
  echo "   插件版本：$PLUGIN_VERSION"
  echo "   获取匹配脚本：$VERSION_TAG"
else
  # 如果版本检测失败，则回退到最新稳定版
  VERSION_TAG="main"
  echo "   ⚠️  无法检测插件版本"
  echo "   从：main分支获取（最新稳定版）"
fi

echo ""

# 克隆仓库到临时位置
TEMP_DIR="/tmp/navigator-install-$$"
if git clone --depth 1 --branch "$VERSION_TAG" https://github.com/alekspetrov/navigator.git "$TEMP_DIR" 2>&1; then
  echo "✅ 下载了Navigator仓库"
else
  echo "❌ 从GitHub下载失败"
  echo ""
  echo "可能的原因："
  echo "  - 无互联网连接"
  echo "  - 版本标签$VERSION_TAG不存在"
  echo "  - GitHub速率限制超标"
  echo ""
  echo "是否重试使用main分支？[y/N]"
  exit 1
fi

echo ""

第4步：运行安装脚本

echo "📦 安装多Claude脚本..."
echo ""

cd "$TEMP_DIR"

if [ -f "scripts/install-multi-claude.sh" ]; then
  # 运行安装程序
  chmod +x scripts/install-multi-claude.sh
  ./scripts/install-multi-claude.sh

  INSTALL_EXIT=$?

  if [ $INSTALL_EXIT -eq 0 ]; then
    echo ""
    echo "✅ 多Claude工作流安装成功"
  else
    echo ""
    echo "❌ 安装失败，退出码$INSTALL_EXIT"
    echo ""
    echo "检查上面的输出以查找错误。"
    exit 1
  fi
else
  echo "❌ 在仓库中未找到install-multi-claude.sh"
  echo ""
  echo "此版本可能不支持多Claude工作流。"
  echo "升级到Navigator v4.3.0+以获得多Claude功能。"
  exit 1
fi

echo ""

第5步：验证安装

echo "🔍 验证安装..."
echo ""

# 检查脚本是否在PATH中
if command -v navigator-multi-claude.sh &> /dev/null; then
  INSTALLED_PATH=$(which navigator-multi-claude.sh)
  echo "✅ navigator-multi-claude.sh：$INSTALLED_PATH"
else
  echo "⚠️  navigator-multi-claude.sh不在PATH中"
  echo "   可能需要重启终端或运行："
  echo "   export PATH=\"\$HOME/bin:\$PATH\""
fi

if command -v navigator-multi-claude-poc.sh &> /dev/null; then
  INSTALLED_PATH=$(which navigator-multi-claude-poc.sh)
  echo "✅ navigator-multi-claude-poc.sh：$INSTALLED_PATH"
else
  echo "⚠️  navigator-multi-claude-poc.sh不在PATH中"
fi

echo ""

第6步：清理和后续步骤

# 清理临时目录
rm -rf "$TEMP_DIR"
echo "🧹 清理了临时文件"
echo ""

echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "✅ 多Claude工作流准备就绪"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "用简单任务测试："
echo "  navigator-multi-claude-poc.sh \"添加hello world函数\""
echo ""
echo "完整6阶段工作流："
echo "  navigator-multi-claude.sh \"实现用户认证\""
echo ""
echo "文档："
echo "  - 发布说明：RELEASE-NOTES-v4.3.0.md"
echo "  - POC学习：scripts/POC-LEARNINGS.md"
echo ""
echo "状态：实验性（30%成功率）"
echo "建议：用于简单功能，密切监控输出"
echo ""

错误处理

Git克隆失败

❌ 从GitHub下载失败

可能的原因：
  - 无互联网连接
  - 版本标签v4.3.1不存在
  - GitHub速率限制超标

手动安装：
  1. 下载：https://github.com/alekspetrov/navigator/archive/refs/heads/main.zip
  2. 解压并cd到目录
  3. 运行：./scripts/install-multi-claude.sh

版本不匹配

⚠️  插件版本：4.3.1
    最新发布：4.3.0
    从main分支安装

这可能包含未发布的更改。
继续？[y/N]

已安装

✅ 多Claude工作流已安装

位置：/Users/username/bin/navigator-multi-claude.sh
版本：4.3.0

现在可以使用！

权限被拒绝

❌ 权限被拒绝：/usr/local/bin/

安装需要写入权限到：
  - $HOME/bin/（推荐）
  - /usr/local/bin/（需要sudo）

修复：
  mkdir -p $HOME/bin
  export PATH="$HOME/bin:$PATH"

然后重试：'安装多Claude工作流'

成功标准

安装成功时：

  • [ ] 从GitHub下载脚本
  • [ ] install-multi-claude.sh执行无错误
  • [ ] 脚本添加到PATH（通过which验证）
  • [ ] 版本与插件版本匹配（或明确覆盖）
  • [ ] 用户可以调用navigator-multi-claude-poc.sh --help

回滚程序

如果安装失败或引起问题：

# 移除已安装脚本
rm -f $HOME/bin/navigator-multi-claude.sh
rm -f $HOME/bin/navigator-multi-claude-poc.sh
rm -f $HOME/bin/install-multi-claude.sh

# 验证移除
which navigator-multi-claude.sh
# 应输出：navigator-multi-claude.sh not found

注释

为什么单独安装：

  • 插件系统只从.claude-plugin/复制技能/模板
  • 多Claude脚本是可执行的Bash文件，需要在PATH中
  • 安装位置因系统而异（$HOME/bin vs /usr/local/bin）
  • 脚本需要chmod +x以执行

版本匹配：

  • 总是获取与安装插件版本匹配的脚本
  • 防止版本漂移（v4.3.1插件与v4.3.0脚本）
  • 如果版本标签不存在，则回退到main分支

安装内容：

$HOME/bin/
├── navigator-multi-claude.sh         # 完整6阶段工作流
├── navigator-multi-claude-poc.sh     # 3阶段POC
└── install-multi-claude.sh           # 重新安装器

相关技能

  • nav-start：检测缺少工作流并提示安装
  • nav-upgrade：更新插件（工作流需要单独重新安装）
  • nav-stats：显示多Claude工作流效率指标

示例

示例1：全新安装

用户：“安装多Claude工作流”

助手执行：

  1. 检查先决条件（Claude CLI，Navigator插件）
  2. 从GitHub下载（v4.3.1标签）
  3. 运行install-multi-claude.sh
  4. 验证安装
  5. 显示测试命令

输出：

✅ 多Claude工作流准备就绪

用简单任务测试：
  navigator-multi-claude-poc.sh "添加hello world函数"

示例2：已安装

用户：“设置多Claude”

助手检查：

which navigator-multi-claude.sh
# 找到位置：/Users/alex/bin/navigator-multi-claude.sh

输出：

✅ 多Claude工作流已安装

位置：/Users/alex/bin/navigator-multi-claude.sh
版本：4.3.0

现在可以使用！

示例3：插件更新后

用户将插件从4.3.0更新到4.3.1，然后：“安装多Claude工作流”