双子座命令行编排器

Name: 双子座命令行编排器
Author: dnnyngyen

作者：dnnyngyen17 星标更新：2025-07-08

安装使用来源：spider==github.com

项目介绍

Gemini CLI 编排器 v2.0 - 顺序思维 MCP

这是一个以元提示优先的MCP服务器，使用Google的Gemini AI引导AI代理通过智能、多步骤的代码库分析。

🧠 核心理念

不要把智能构建到系统中。而是构建能够激发代理智能的提示。

此工具不会包裹或替代你的思考——它通过结构化的流程引导你更系统地思考复杂的代码库分析。

🚀 快速开始

步骤 1：安装 Gemini CLI

npm install -g @google/gemini-cli

步骤 2：认证（一次性设置）

gemini auth login

步骤 3：安装此工具

npm install

步骤 4：测试是否工作

node gemini-collaboration-guide.mjs

步骤 5：尝试第一次分析（使用Claude Code CLI）

# 从规划一个简单的分析开始
gemini_plan_analysis goal="理解这个项目的主架构"

# 然后为第一步编写特定的提示
gemini_craft_prompt step_description="分析 package.json 和 README 获取项目概述" context="开始新的分析"

就这样！认证由gemini CLI自动处理。

工作原理

此工具不试图对你的分析“聪明”，而是提供四个简单的工具来引导你进行系统化分析：

🎯 `gemini_plan_analysis(goal)`

将复杂的分析目标分解成逐步计划。具体说明你想了解什么以及为什么。

示例：

gemini_plan_analysis goal="审计身份验证系统中的安全漏洞"

🔍 `gemini_craft_prompt(step_description, context)`

帮助你为Gemini编写更好的提示，通过建议每个分析步骤的有效命令和上下文。

示例：

gemini_craft_prompt step_description="分析JWT令牌处理" context="发现3个身份验证端点，专注于令牌安全性"

🔄 `gemini_iterate_analysis(current_understanding, iteration_goal)`

使用观察-思考-行动循环指导迭代分析，实现动态问题解决。

示例：

gemini_iterate_analysis current_understanding="在登录中发现潜在SQL注入" iteration_goal="调查其他端点是否有类似问题"

📊 `gemini_synthesize_findings(steps_summary, synthesis_goal)`

将多个分析步骤的见解综合成全面的理解。

示例：

gemini_synthesize_findings steps_summary="分析了身份验证系统，发现了2个漏洞，测试了5个端点" synthesis_goal="创建带有优先修复的安全审计报告"

示例工作流

这是如何使用编排器进行安全审计：

# 1. 规划整体分析
gemini_plan_analysis goal="分析身份验证系统中的安全漏洞"
# → 输出：包含具体步骤的5阶段分析计划

# 2. 执行每个计划步骤
gemini_craft_prompt step_description="识别身份验证机制" context="身份验证系统的安全审计"
# → 输出：优化的gemini命令用于分析身份验证文件
# → 你运行：cat src/auth/**/* | gemini -m gemini-2.5-flash -p "..."

# 3. 如需深入
gemini_iterate_analysis current_understanding="发现JWT+会话身份验证" iteration_goal="检查常见身份验证漏洞"
# → 输出：系统性漏洞测试的ReAct循环指导

# 4. 综合最终报告
gemini_synthesize_findings steps_summary="分析了3种身份验证机制，发现了2个问题" synthesis_goal="带有修复的安全审计报告"
# → 输出：最终报告的全面综合策略

🎯 关键优势

✅ 简化认证 - 使用现有的gemini CLI配置
✅ 真正的元提示 - 引导你的智能，而不是取代它
✅ 多步骤分析 - 将复杂问题分解成可管理的步骤
✅ 灵活的工作流 - 根据发现的情况调整方法
✅ 直接Gemini集成 - 没有包装复杂性和认证开销

📚 文档

工作原理 - 深入探讨架构和元提示哲学
贡献指南 - 如何为项目做出贡献
行为准则 - 社区标准和期望

🤝 贡献

我们欢迎贡献！请参阅我们的贡献指南和行为准则，了解如何参与。

MCP 配置

🚨 对现有用户的重要提示

如果你之前安装过此MCP服务器（特别是使用了gemini-orchestrator.mjs），你可能有缓存的配置。为了清晰起见，文件名已更改为gemini-collaboration-guide.mjs。如果遇到设置问题，请参阅下面的“处理先前安装”。

Claude Code CLI（推荐）

配置MCP服务器最简单且可靠的方法：

# 使用Claude Code内置命令添加服务器
claude mcp add gemini-collaboration-guide node /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs

# 验证已添加
claude mcp list

# 在Claude Code中测试
/mcp

重要：

使用gemini-collaboration-guide.mjs文件的完整绝对路径
服务器名称必须精确为gemini-collaboration-guide
添加服务器后重启Claude Code

处理先前安装/文件名更改

如果你之前配置过此MCP服务器或遇到如“状态：✘失败”等问题，请按照以下步骤操作：

# 1. 删除任何旧配置
claude mcp remove gemini-cli-orchestrator    # 旧名称
claude mcp remove gemini-orchestrator        # 另一个旧名称  
claude mcp remove gemini-collaboration-guide # 清除状态

# 2. 验证干净状态
claude mcp list

# 3. 使用正确的文件名添加（使用您的实际路径）
claude mcp add gemini-collaboration-guide node /Users/dannynguyen/gemini-cli-orchestrator/gemini-collaboration-guide.mjs

# 4. 完全重启Claude Code

# 5. 测试是否工作
/mcp

手动配置（备选方案）

如果你偏好手动JSON配置：

Claude Desktop - 配置文件：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gemini-collaboration-guide": {
      "command": "node",
      "args": ["/absolute/path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs"]
    }
  }
}

Cursor IDE - 配置文件：.cursor/mcp.json

{
  "mcpServers": {
    "gemini-collaboration-guide": {
      "command": "node",
      "args": ["/absolute/path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs"]
    }
  }
}

Windsurf IDE - 配置文件：windsurf_config.json

{
  "mcpServers": {
    "gemini-collaboration-guide": {
      "command": "node",
      "args": ["/absolute/path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs"],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

故障排除

如果/mcp显示“未配置MCP服务器”或工具不可用：

检查文件名/配置冲突（最常见的问题）
- 按照上面的“处理先前安装”部分操作
- 文件名已从gemini-orchestrator.mjs更改为gemini-collaboration-guide.mjs

清洁设置过程：

# 删除所有旧配置
claude mcp remove gemini-cli-orchestrator
claude mcp remove gemini-orchestrator  
claude mcp remove gemini-collaboration-guide

# 使用正确文件名添加
claude mcp add gemini-collaboration-guide node /absolute/path/to/gemini-collaboration-guide.mjs

验证文件存在：

ls -la /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs

测试服务器能否启动：

node /path/to/your/gemini-cli-orchestrator/gemini-collaboration-guide.mjs --help

配置更改后完全重启Claude Code

验证成功：

claude mcp list    # 应该显示：gemini-collaboration-guide
/mcp              # 应该显示四个工具

常见错误：

状态：✘失败 → 通常是因为文件名错误（使用gemini-collaboration-guide.mjs）
文件不存在 → 检查绝对路径是否正确
工具未出现 → 配置后重启Claude Code

高级用法示例

安全审计工作流

1. 开始：“Web应用程序的全面安全审计”
2. 第一步：“识别所有身份验证机制” → @src/auth/ @middleware/
3. 第二步：“分析API端点的安全性” → @src/api/ @src/routes/
4. 第三步：“审查数据验证和清理” → @src/validation/ @src/models/
5. 第四步：“检查常见的漏洞（OWASP）” → @src/
6. 结论：“生成带有修复步骤的优先安全报告”

性能分析工作流

1. 开始：“识别React应用程序中的性能瓶颈”
2. 第一步：“分析组件渲染模式” → @src/components/
3. 第二步：“审查状态管理效率” → @src/store/ @src/hooks/
4. 第三步：“检查不必要的重新渲染” → @src/components/
5. 第四步：“分析捆绑大小和导入” → @package.json @webpack.config.js
6. 结论：“提供性能优化建议”

架构审查工作流

1. 开始：“审查微服务架构的可扩展性”
2. 第一步：“理解服务边界” → @services/ @docker-compose.yml
3. 第二步：“分析服务间通信” → @src/api/ @src/clients/
4. 第三步：“审查数据流和依赖关系” → @src/models/ @src/schemas/
5. 第四步：“评估错误处理和弹性” → @src/middleware/ @src/utils/
6. 结论：“推荐可扩展性的架构改进”

文件模式示例

使用通配符模式聚焦于相关文件的分析：

# 特定语言模式
@**/*.js @**/*.ts          # JavaScript/TypeScript
@**/*.py                   # Python
@**/*.go                   # Go
@**/*.rs                   # Rust
@**/*.java                 # Java

# 特定框架模式
@src/components/ @src/hooks/     # React
@src/models/ @src/views/         # MVC框架
@src/services/ @src/controllers/ # 服务层

# 文件类型模式
@package.json @*.config.js       # 配置
@**/*.test.js @**/*.spec.js      # 测试
@README.md @docs/                # 文档

要求

Node.js 18+
安装并认证Google Gemini CLI
基本了解通配符模式

故障排除

“命令未找到：gemini”

npm install -g @google/gemini-cli

“认证失败”

gemini auth login

“未找到文件”

# 检查你的文件模式是否匹配你的项目结构
# 使用更广泛的模式，如@src/ 或 @**/*.js

v2.0 新特性

🎉 完整的架构重设计 - 从复杂的包装器变为简单的编排器
🎉 消除认证复杂性 - 使用原生gemini CLI认证
🎉 真正的元提示方法 - 引导智能而非替换它
🎉 顺序思维工作流 - 具有状态管理的多步骤分析
🎉 简化设置 - 没有复杂的配置或环境变量

哲学

此工具体现了元提示原则：信任代理智能而非系统复杂性。

此工具不试图对你的分析“聪明”，而是提供简单的工具来引导你系统地思考复杂问题。结果是更深入的分析和更好的见解。

非常适合通过智能、结构化的流程利用Gemini的巨大上下文窗口。

双子座命令行编排器

项目介绍

Gemini CLI 编排器 v2.0 - 顺序思维 MCP

🧠 核心理念

🚀 快速开始

工作原理

🎯 gemini_plan_analysis(goal)

🔍 gemini_craft_prompt(step_description, context)

🔄 gemini_iterate_analysis(current_understanding, iteration_goal)

📊 gemini_synthesize_findings(steps_summary, synthesis_goal)

示例工作流

🎯 关键优势

📚 文档

🤝 贡献

MCP 配置

🚨 对现有用户的重要提示

Claude Code CLI（推荐）

处理先前安装/文件名更改

手动配置（备选方案）

故障排除

高级用法示例

安全审计工作流

性能分析工作流

架构审查工作流

文件模式示例

要求

故障排除

v2.0 新特性

哲学

🎯 `gemini_plan_analysis(goal)`

🔍 `gemini_craft_prompt(step_description, context)`

🔄 `gemini_iterate_analysis(current_understanding, iteration_goal)`

📊 `gemini_synthesize_findings(steps_summary, synthesis_goal)`