name: 多AI顾问 description: 咨询外部AI(Gemini 2.5 Pro、OpenAI Codex、Claude)获取第二意见。用于调试失败、架构决策、安全验证或需要新视角并进行合成分析。 license: MIT allowed-tools: [Bash, Read, Task, Write] metadata: version: 1.0.0 author: Claude Skills Maintainers last-verified: 2025-11-07 production-tested: true keywords: - ai咨询 - 第二意见 - gemini - openai - codex - 调试 - 架构 - 多AI - 合成 - 新视角 - 卡住 - 网络研究 - 思考模式 - 仓库感知
多AI顾问
当Claude Code遇到困难或需要做出关键决策时,咨询外部AI获取第二意见。
此技能的作用
此技能使未来的Claude Code会话能够在以下情况下咨询其他AI:
- 一次调试尝试失败后卡在错误上
- 做出架构决策时
- 安全担忧需要验证时
- 需要新视角时
关键创新:使用现有的CLI工具(gemini、codex)而不是构建MCP服务器——更简单且更易于维护。
何时使用此技能
自动触发(无需用户操作)
Claude Code应在以下情况下自动建议使用此技能:
-
1次调试尝试失败后
- 尝试了一种修复错误的方法
- 仍然不工作或出现不同错误
- → 建议:“我是否应该咨询[Gemini|新的Claude]获取第二意见?”
-
架构决策前
- 重大设计选择(状态管理、路由、数据流)
- 框架选择
- 数据库模式设计
- → 自动咨询(告知用户):“正在咨询Gemini进行架构验证…”
-
安全更改时
- 身份验证逻辑
- 授权规则
- 密码学
- 输入验证
- → 自动咨询:“正在咨询Gemini以验证安全方法…”
-
不确定时
- 多种有效方法
- 权衡不清晰
- 文档中建议冲突
- → 建议:“您是否希望我咨询另一个AI获取额外视角?”
手动调用(用户命令)
用户可以使用以下命令明确请求咨询:
/consult-gemini [问题]- Gemini 2.5 Pro,带有思考、搜索、接地/consult-codex [问题]- OpenAI GPT-4,通过Codex CLI(仓库感知)/consult-claude [问题]- 新的Claude子代理(免费、快速)/consult-ai [问题]- 路由器,询问使用哪个AI
三个AI
| AI | 工具 | 何时使用 | 特殊功能 | 成本 |
|---|---|---|---|---|
| Gemini 2.5 Pro | gemini CLI |
网络研究、最新文档、思考 | Google搜索、扩展推理、接地 | ~$0.10-0.50 |
| OpenAI GPT-4 | codex CLI |
仓库感知分析、代码审查 | 自动扫描目录、OpenAI推理 | ~$0.05-0.30 |
| Fresh Claude | Task工具 | 快速第二意见、预算友好 | 相同能力、新视角 | 免费 |
详细AI比较:加载 references/ai-strengths.md 当选择哪个AI咨询特定用例时。
工作原理
架构
Claude Code遇到错误/决策
↓
建议咨询(或用户请求)
↓
用户批准
↓
执行适当的斜杠命令
↓
CLI命令调用外部AI
↓
解析响应
↓
合成:Claude的分析 + 外部AI的分析
↓
呈现5部分比较
↓
请求权限实施
5部分合成格式
每次咨询必须遵循此格式(防止鹦鹉学舌):
- 🤖 我的分析 - Claude的原始推理和尝试
- 💎/🔷/🔄 其他AI的分析 - 外部AI的完整响应
- 🔍 关键差异 - 同意、分歧、每个AI抓住/遗漏了什么
- ⚡ 合成 - 结合视角、根本原因、权衡
- ✅ 推荐操作 - 具体的下一步,包括文件路径/行号
结束于:“我应该继续这种方法吗?”
设置
完整安装指南:加载 references/setup-guide.md 当安装CLI、配置API密钥或设置模板时。
快速设置:
- 安装CLI:
bun add -g @google/generative-ai-cli(Gemini),bun add -g codex(Codex, 可选) - 设置API密钥:
export GEMINI_API_KEY="...",export OPENAI_API_KEY="..." - 安装技能:符号链接到
~/.claude/skills/multi-ai-consultant - 复制模板:
GEMINI.md,codex.md,.geminiignore到项目根目录 - 验证:
gemini -p "test",codex exec - --yolo
获取API密钥:
使用
详细示例:加载 references/usage-examples.md 当学习咨询工作流或查看真实场景时。
快速示例:
- 错误:1次尝试失败后 →
/consult-gemini获取网络研究的解决方案 - 架构:设计决策 →
/consult-gemini获取最新最佳实践 - 代码审查:重构验证 →
/consult-codex获取仓库感知的一致性检查 - 快速意见:理智检查 →
/consult-claude获取免费新视角
5个详细示例可用:
- JWT身份验证错误(节省约30分钟,找到平台特定问题)
- 状态管理选择(通过2025模式通知决策)
- 重构审查(找到3个一致性问题)
- 安全验证(通过OWASP 2025找到2个关键问题)
- 多AI工作流(高风险数据库选择)
斜杠命令
完整命令参考:加载 references/commands-reference.md 当需要详细语法、选项或成本跟踪信息时。
快速命令概述:
/consult-gemini [问题]
- 使用:网络研究、最新文档、扩展思考
- 功能:Google搜索、接地、思考模式
- 成本:~$0.10-0.50
- 示例:
/consult-gemini 这个JWT是否符合2025年安全标准?
/consult-codex [问题]
- 使用:仓库感知分析、代码审查
- 功能:自动扫描目录、一致性检查
- 成本:~$0.05-0.30
- 示例:
/consult-codex 审查性能瓶颈
/consult-claude [问题]
- 使用:快速第二意见、预算友好
- 功能:免费、快速、新视角
- 成本:免费
- 示例:
/consult-claude 我是否遗漏了什么明显的东西?
/consult-ai [问题]
- 使用:路由器(推荐使用哪个AI)
- 功能:分析问题、建议最佳AI
- 成本:根据选择的AI变化
- 示例:
/consult-ai 我们应该如何构建这个架构?
模板
模板为咨询定制AI行为(从项目根目录自动加载):
- GEMINI.md - Gemini的系统指令(强制执行5部分格式、网络搜索)
- codex.md - Codex的系统指令(强制执行仓库感知分析)
- .geminiignore - 超出
.gitignore的隐私排除 - consultation-log-parser.sh - 查看咨询历史(可选)
安装:从 ~/.claude/skills/multi-ai-consultant/templates/ 复制到项目根目录
隐私与安全
自动保护:
- 两个CLI自动尊重
.gitignore - 创建
.geminiignore用于额外排除(.env*、*secret*、*credentials*) - 预咨询检查,如果检测到敏感模式则警告
隐私最佳实践:
- 始终正确配置
.gitignore - 创建
.geminiignore用于额外安全 - 使用智能上下文选择(特定文件,而不是整个仓库)
- 验证将发送什么:
git status --ignored
详细隐私配置:加载 references/setup-guide.md 当设置 .geminiignore 或隐私排除时。
成本跟踪
每次咨询记录到 ~/.claude/ai-consultations/consultations.log
日志格式:timestamp,ai,model,input_tokens,output_tokens,cost,project_path
查看日志:consultation-log-parser.sh --summary
示例输出:
总咨询数:47
Gemini:23 ($4.25), Codex:12 ($1.85), 新的Claude:12 ($0.00)
总成本:$6.10
详细成本跟踪:加载 references/commands-reference.md 当查看日志、计算成本或管理预算时。
常见问题
完整故障排除:加载 references/troubleshooting.md 当遇到错误或设置问题时。
前5个问题:
- CLI未安装:
gemini: command not found→ 修复:bun add -g @google/generative-ai-cli - API密钥无效:身份验证失败 → 修复:
export GEMINI_API_KEY="..." - 上下文太大:令牌限制超出 → 修复:使用特定文件,而不是整个仓库
- 隐私泄露:
.env文件发送 → 修复:添加到.gitignore和.geminiignore - 技能未发现:不工作 → 修复:检查
~/.claude/skills/multi-ai-consultant
令牌效率
无此技能
典型场景(卡在错误上):
- 尝试方法1(~4k令牌)
- 研究CLI语法(~3k令牌)
- 尝试方法2(~4k令牌)
- 研究文档(~3k令牌)
- 尝试方法3(~4k令牌)
总计:~20k令牌,30-45分钟
有此技能
相同场景:
- 尝试方法1(~4k令牌)
- 执行
/consult-gemini(~1k令牌) - Gemini找到问题(<5k令牌,单独计费)
- 实施修复(~3k令牌)
总计:~8k令牌,5-10分钟
节省:~60%令牌,~75%时间
成功指标
时间效率
- 无技能:30-45分钟(试错)
- 有技能:5-10分钟(咨询 + 修复)
- 节省:~75%
令牌效率
- 无技能:~20k令牌(多次尝试)
- 有技能:~8k令牌(一次咨询)
- 节省:~60%
错误预防
- 手动CLI使用:3-5个常见错误(标志、解析、隐私)
- 有技能:0错误(所有命令处理)
- 预防:100%
质量
- 手动:不合成的风险(仅复制外部AI)
- 有技能:通过
GEMINI.md/codex.md强制合成 - 改进:保证增值
为什么CLI方法(非MCP)?
| 方面 | MCP服务器 | CLI方法 |
|---|---|---|
| 设置时间 | 4-6小时 | 60-75分钟 |
| 复杂性 | 高(MCP协议) | 低(bash + CLI) |
| 维护 | 更新MCP SDK | 更新CLI(罕见) |
| 灵活性 | 锁定到AI | 任何有CLI的AI |
| 调试 | MCP协议 | 标准bash |
| 依赖 | MCP SDK, npm | 仅CLI |
赢家:CLI方法 - 80%更少努力,相同功能
何时加载参考
加载参考文件当处理AI咨询的特定方面时:
ai-strengths.md
加载当:
- 基于选择:选择咨询哪个AI(Gemini vs Codex vs 新的Claude)
- 基于比较:理解能力、成本和权衡之间
- 基于策略:规划组合策略(免费 → 付费、付费优先、预算意识)
- 基于能力:理解特殊功能(Google搜索、扩展思考、接地、仓库感知、新视角)
- 基于场景:多AI咨询工作流、验证工作流
setup-guide.md
加载当:
- 基于安装:设置Gemini CLI、Codex CLI或安装技能
- 基于配置:配置API密钥、环境变量或系统路径
- 基于隐私:设置 .geminiignore、隐私排除或安全配置
- 基于模板:安装 GEMINI.md、codex.md、.geminiignore 或 consultation-log-parser.sh
- 基于验证:测试CLI安装、API密钥或技能发现
commands-reference.md
加载当:
- 基于命令:使用 /consult-gemini、/consult-codex、/consult-claude 或 /consult-ai
- 基于语法:理解命令标志、选项或上下文选择
- 基于成本:理解成本跟踪、日志格式或查看咨询历史
- 基于日志:使用 consultation-log-parser.sh 或分析咨询模式
usage-examples.md
加载当:
- 基于场景:学习如何使用技能进行错误、架构决策或代码审查
- 基于工作流:理解咨询工作流、合成过程或多AI方法
- 基于示例:查看咨询的真实示例及其结果(5个详细示例可用)
troubleshooting.md
加载当:
- 基于错误:遇到特定错误(命令未找到、API密钥无效、解析失败)
- 基于诊断:故障排除CLI问题、API连接性或技能发现
- 基于修复:解决已知问题,有逐步解决方案(8个常见问题记录)
- 基于调试:手动测试CLI、检查配置或验证安装
贡献
发现问题?
- 在 troubleshooting.md 中记录
- 包括修复/变通方法
- 更新斜杠命令以防止
添加新AI?
- 创建新斜杠命令:
commands/consult-newai.md - 添加到路由器:更新
commands/consult-ai.md - 创建模板:
templates/newai.md(如果CLI支持系统指令) - 更新文档
改进合成?
- 编辑模板:
templates/GEMINI.md、templates/codex.md - 用真实咨询测试
- 测量前后质量
参考
外部资源
- Gemini CLI:https://ai.google.dev/gemini-api/docs/cli
- OpenAI Codex:https://www.npmjs.com/package/codex
- OpenAI API:https://platform.openai.com/docs
- Gemini API定价:https://ai.google.dev/pricing
- OpenAI定价:https://openai.com/pricing
内部文件
- 规划文档:
planning/multi-ai-consultant-*.md - 斜杠命令:
commands/*.md - 模板:
templates/* - 脚本:
scripts/* - 参考:
references/*.md(5个参考文件)
许可证
MIT许可证 - 参见LICENSE文件
最后更新:2025-11-07 状态:生产就绪 维护者:Claude Skills Maintainers | maintainers@example.com