Multi-AI Consultant

多 AI 顾问

当 Claude Code 陷入困境或需要做出关键决策时，咨询外部 AI，获取第二意见。

---

此技能的作用

此技能可让未来的 Claude Code 会话在以下情况下咨询其他 AI：

• 尝试一次后仍无法修复 Bug
• 做出架构决策
• 需要验证安全问题
• 需要新的视角

关键创新：使用现有的 CLI 工具（gemini、codex），而不是构建 MCP 服务——简单得多，也更易于维护。

---

何时使用此技能

自动触发（无需用户操作）

遇到以下情况时，Claude Code 应自动建议使用此技能：

1. 调试失败一次后

   • 尝试过一种 Bug 修复方法
   • 问题仍未解决，或出现了不同的错误
   • → 建议：“要不要咨询 [Gemini|Fresh Claude]，获取第二意见？”

2. 做出架构决策前

   • 重要的设计选择（状态管理、路由、数据流）
   • 框架选择
   • 数据库架构设计
   • → 自动咨询（告知用户）：“正在咨询 Gemini 以验证架构……”

3. 安全变更

   • 身份验证逻辑
   • 授权规则
   • 密码学
   • 输入验证
   • → 自动咨询：“正在咨询 Gemini 以验证安全方案……”

4. 存在不确定性时

   • 有多种可行方案
   • 权衡不明确
   • 文档中的建议相互矛盾
   • → 建议：“您希望我咨询另一个 AI，获取更多视角吗？”

手动调用（用户命令）

用户可以通过以下命令明确请求咨询：

• /consult-gemini [question] - Gemini 2.5 Pro，支持思考、搜索和 grounding
• /consult-codex [question] - 通过 Codex CLI 使用 OpenAI GPT-4（了解代码仓库）
• /consult-claude [question] - 全新的 Claude 子 Agent（免费、快速）
• /consult-ai [question] - 路由器，会询问要使用哪个 AI

---

三种 AI

AI	工具	使用场景	特殊功能	费用
Gemini 2.5 Pro	gemini CLI	网络研究、最新文档、思考	Google 搜索、扩展推理、grounding	~$0.10-0.50
OpenAI GPT-4	codex CLI	了解代码仓库的分析、代码审查	自动扫描目录、OpenAI 推理	~$0.05-0.30
Fresh Claude	Task tool	快速获取第二意见、经济实惠	相同能力、全新视角	免费

---

工作原理

架构

Claude Code encounters bug/decision
        ↓
Suggests consultation (or user requests)
        ↓
User approves
        ↓
Execute appropriate slash command
        ↓
CLI command calls external AI
        ↓
Parse response
        ↓
Synthesize: Claude's analysis + External AI's analysis
        ↓
Present 5-part comparison
        ↓
Ask permission to implement

五部分综合格式

每次咨询都必须遵循此格式（避免照搬回答）：

1. 🤖 我的分析 - Claude 的原始推理和尝试
2. 💎/🔷/🔄 其他 AI 的分析 - 外部 AI 的完整回答
3. 🔍 关键差异 - 各方的共识、分歧，以及各自发现或遗漏的内容
4. ⚡ 综合结论 - 综合视角、根本原因和权衡
5. ✅ 建议的操作 - 包含文件路径/行号的具体后续步骤

以此结尾：“要按此方案继续吗？”

---

设置说明

1. 安装 CLI

Gemini CLI（必需）：

npm install -g @google/generative-ai-cli
export GEMINI_API_KEY="your-key"

获取 API 密钥：https://aistudio.google.com/apikey

Codex CLI（可选）：

npm install -g codex
export OPENAI_API_KEY="sk-..."

获取 API 密钥：https://platform.openai.com/api-keys

Fresh Claude：内置（使用 Task tool，无需设置）

2. 安装技能

cd ~/.claude/skills
git clone [this-repo] multi-ai-consultant
# OR symlink from development location

3. 将模板复制到项目

# Copy to project root
cp ~/.claude/skills/multi-ai-consultant/templates/GEMINI.md ./
cp ~/.claude/skills/multi-ai-consultant/templates/codex.md ./
cp ~/.claude/skills/multi-ai-consultant/templates/.geminiignore ./

# Copy log parser (optional)
cp ~/.claude/skills/multi-ai-consultant/templates/consultation-log-parser.sh ~/bin/
chmod +x ~/bin/consultation-log-parser.sh

4. 验证安装

# Test Gemini CLI
gemini -p "test" && echo "✅ Gemini working"

# Test Codex CLI (if installed)
codex exec "test" --yolo && echo "✅ Codex working"

# Test skill discovery
# Ask Claude Code: "I'm stuck on this bug, can you help?"
# Claude should suggest consultation

---

使用示例

示例 1：修复 Bug 陷入困境

场景：尝试一次后，JWT 身份验证仍然失败

Claude 的处理过程：

1. Try initial fix (token expiry check)
2. Still failing (now "invalid signature" error)
3. → Automatically suggest consultation
4. User approves
5. Execute /consult-gemini with:
   - Problem: 401 error details
   - What was tried: token expiry fix
   - Current status: invalid signature error
   - Context: @src/auth/session.ts @src/middleware/jwt.ts
6. Gemini finds: Using process.env instead of env binding (Cloudflare)
7. Synthesize both perspectives
8. Ask permission to implement Gemini's fix

结果：借助第二意见修复 Bug，避免再进行 2-3 次反复尝试

示例 2：架构决策

场景：为新功能选择状态管理方案

Claude 的处理过程：

1. User asks: "How should we handle state for this feature?"
2. → Auto-consult Gemini (architectural decision)
3. Execute /consult-gemini with:
   - Problem: State management choice
   - Options considered: Redux, Zustand, Context
   - Context: @src/ (existing patterns)
4. Gemini searches for latest React state management best practices
5. Synthesize Claude's + Gemini's analysis
6. Present recommendation with trade-offs

结果：依据最新最佳实践做出明智决策

示例 3：手动咨询

用户：“我想听听对这次重构的第二意见。”

Claude 的处理过程：

1. User explicitly requests consultation
2. Ask which AI: Gemini, Codex, or Fresh Claude?
3. User chooses Codex (wants repo-aware analysis)
4. Execute /consult-codex with:
   - Problem: Refactoring proposal
   - Context: (Codex scans repo automatically)
5. Codex checks consistency with existing code
6. Synthesize both perspectives
7. Present recommendation

结果：验证重构方案，并检查一致性

---

斜杠命令

/consult-gemini [question]

适用场景：需要网络调研、最新文档或深度思考时

功能：

1. 执行预检（Gemini CLI 是否正常运行？）
2. 根据问题类型智能选择上下文
3. 使用锁定的配置执行：gemini-2.5-pro --thinking --google-search --grounding
4. 解析 JSON 响应
5. 按 5 部分格式综合结果
6. 将费用记录到 ~/.claude/ai-consultations/consultations.log

示例：

/consult-gemini Is this JWT validation secure by 2025 standards?

上下文：使用 @<path> 语法选择性添加上下文

系统指令：自动加载项目根目录中的 GEMINI.md

隐私：遵循 .gitignore 和 .geminiignore

---

/consult-codex [question]

适用场景：需要结合代码仓库分析、代码审查或 OpenAI 推理时

功能：

1. 执行预检（OpenAI API 密钥是否有效？）
2. cd 到项目目录（Codex 会自动扫描）
3. 使用 --yolo 标志执行：codex exec - -m gpt-4-turbo --yolo
4. 从临时文件解析输出
5. 按 5 部分格式综合结果
6. 记录费用（估算 token 数量）

示例：

/consult-codex Review this codebase for performance issues

上下文：结合代码仓库（自动读取所有未被 Git 忽略的文件）

系统指令：自动加载项目根目录中的 codex.md，或 ~/.codex/instructions.md

隐私：遵循 .gitignore；如果当前目录不在 Git 仓库中，会发出警告

---

/consult-claude [question]

适用场景：需要快速征求第二意见、免费获取全新视角时

功能：

1. 使用 Read 工具收集上下文
2. 为子 Agent 构建详细提示词
3. 启动 Task 工具（通用子 Agent）
4. 获取全新视角
5. 按 5 部分格式综合结果
6. 记录咨询（免费，但会跟踪）

示例：

/consult-claude Am I missing something obvious in this state management bug?

上下文：手动读取相关文件并以内联方式传入

优势：免费、能力相同、速度快、视角全新

限制：不支持网络搜索和深度思考，知识截止时间相同

---

/consult-ai [question]

适用场景：不确定该使用哪个 AI 时

功能：

1. 分析问题类型（Bug、架构、安全等）
2. 根据需求推荐 AI
3. 询问用户选择
4. 路由到相应命令

示例：

/consult-ai How should we structure this microservices architecture?

→ Recommends Gemini (needs web research for latest patterns)
→ User approves
→ Executes /consult-gemini internally

决策因素：

• 需要网络调研？→ Gemini
• 需要结合代码仓库分析？→ Codex
• 需要节省预算？→ Fresh Claude
• 需要深度思考？→ Gemini
• 需要全新视角？→ Fresh Claude

---

模板

GEMINI.md（项目根目录）

用于 Gemini 咨询的系统指令。要求：

• 采用 5 部分响应格式
• 与 Claude 的分析进行比较
• 搜索最新文档
• 提供具体代码引用
• 不照搬原文

自动加载：放在项目根目录，Gemini CLI 会自动读取

codex.md（项目根目录或 ~/.codex/instructions.md）

用于 Codex 咨询的系统指令。要求：

• 采用 5 部分响应格式
• 结合代码仓库分析
• 检查一致性
• 评估影响
• 提供具体文件引用

自动加载：Codex CLI 会从项目根目录或全局配置中读取

.geminiignore（项目根目录）

在 .gitignore 之外添加额外的隐私排除项。排除：

• .env* 文件
• *secret*、*credentials*
• 构建产物
• 大型媒体文件
• API 密钥和令牌

自动加载：Gemini CLI 会遵循此文件

consultation-log-parser.sh

查看咨询历史记录：

consultation-log-parser.sh           # Last 10
consultation-log-parser.sh --all     # All consultations
consultation-log-parser.sh --summary # Stats only
consultation-log-parser.sh --ai gemini # Filter by AI

日志格式：timestamp,ai,model,input_tokens,output_tokens,cost,project_path

---

费用跟踪

每次咨询都会记录到 ~/.claude/ai-consultations/consultations.log

格式：

2025-11-07T14:23:45-05:00,gemini,gemini-2.5-pro,15420,850,0.1834,/home/user/project
2025-11-07T15:10:22-05:00,codex,gpt-4-turbo,8230,430,0.0952,/home/user/project
2025-11-07T16:05:11-05:00,claude-subagent,claude-sonnet-4-5,0,0,0.00,/home/user/project

查看日志：

consultation-log-parser.sh --summary
# Total consultations: 47
# Gemini: 23, Codex: 12, Fresh Claude: 12
# Total cost: $8.45

定价（请确认当前费率）：

• Gemini 2.5 Pro：每个输入 token 约 $0.000015，每个输出 token 约 $0.00006
• GPT-4 Turbo：每个输入 token 约 $0.00001，每个输出 token 约 $0.00003
• Fresh Claude：免费（相同的 API 调用）

---

隐私与安全

自动保护

两个 CLI 都会自动遵循 .gitignore。.gitignore 中的文件绝不会被发送。

额外保护（.geminiignore）

在项目根目录中创建 .geminiignore，以添加额外的排除项：

*.env*
*secret*
*credentials*
.dev.vars
wrangler.toml

咨询前检查

Claude Code 应在以下情况下发出警告：

• 在上下文中检测到敏感文件模式
• 不在 Git 仓库中（Codex）
• 上下文过大（估算超过 100k 个令牌）

请求许可：“即将向 [AI] 发送上下文。文件包括：[列表]。是否继续？”

手动验证

咨询前，用户可以检查：

# What will be sent to Gemini
ls -la @src/

# Check gitignore is working
git status --ignored

---

已知问题与解决方案

1. 未安装 CLI

错误：gemini: command not found 或 codex: command not found

修复：

npm install -g @google/generative-ai-cli
npm install -g codex

预防：斜杠命令中进行预检

---

2. API 密钥无效

错误：“API key invalid”或身份验证失败

修复：

export GEMINI_API_KEY="your-key"
export OPENAI_API_KEY="sk-..."

# Or add to ~/.bashrc
echo 'export GEMINI_API_KEY="your-key"' >> ~/.bashrc
source ~/.bashrc

预防：预检会在咨询前测试 API

---

3. 上下文过大

错误：超出令牌限制或咨询费用很高

修复：使用智能上下文选择

• Bug：只提供有问题的文件及其导入项（而非整个代码库）
• 架构：仅提供相关目录
• 使用 @path/to/specific/file.ts，而非 @.

预防：斜杠命令会引导用户智能选择上下文

---

4. 隐私泄露

风险：意外发送 .env 或机密信息

修复：

• 两种 CLI 都会遵循 .gitignore（自动执行）
• 创建 .geminiignore 以加强保护
• Claude 会在检测到敏感模式时发出警告

预防：始终检查是否已配置 .gitignore

---

5. 费用超支

问题：咨询费用不断累积

修复：

• 检查日志：consultation-log-parser.sh --summary
• 简单问题使用 Fresh Claude（免费）
• 使用智能上下文（指定文件，而非整个仓库）

预防：费用跟踪，并在上下文过大时发出警告

---

6. Codex 卡住

错误：codex exec 卡在等待批准的状态

修复：始终使用 --yolo 标志

预防：斜杠命令默认包含 --yolo（不易遗漏）

---

7. JSON 解析失败（Gemini）

错误：jq: parse error

修复：解析前检查退出代码，失败时回退到纯文本

预防：斜杠命令会先检查退出代码

---

8. 不在 Git 仓库中（Codex）

警告：如果不在 Git 仓库中，Codex 会发出警告（安全功能）

修复：如适用，添加 --skip-git-repo-check 标志

预防：斜杠命令中包含该标志

---

令牌效率

不使用此技能

典型场景（遇到难以解决的 Bug）：

1. 尝试方案 1（约 4k 个令牌）
2. 查找 CLI 语法（约 3k 个令牌）
3. 格式化回复（约 2k 个令牌）
4. 尝试方案 2（约 4k 个令牌）
5. 查阅文档（约 3k 个令牌）
6. 尝试方案 3（约 4k 个令牌）

合计：约 20k 个令牌，30–45 分钟

使用此技能

相同场景：

1. 尝试方案 1（约 4k 个令牌）
2. 执行 /consult-gemini（执行约需 1k 个令牌）
3. Gemini 找出问题（单独计费，但少于 5k 个令牌）
4. 实施修复（约 3k 个令牌）

合计：约 8k 个令牌，5–10 分钟

节省：约 60% 的令牌，约 75% 的时间

价值：Gemini 的网页搜索能找到 Claude 未能发现的问题

---

成效指标

时间效率

• 不使用技能：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%，功能相同

---

故障排除

Gemini 无法运行

# Check CLI installed
which gemini

# Check API key set
echo $GEMINI_API_KEY

# Test manually
gemini -p "test"

# Check API key valid
curl -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"test"}]}]}' \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent?key=$GEMINI_API_KEY"

Codex 无法运行

# Check CLI installed
which codex

# Check API key set (if using API key auth)
echo $OPENAI_API_KEY

# Test manually
echo "test" | codex exec - --yolo

# Check OpenAI API (if installed)
openai api models.list

Fresh Claude 无法运行

# Fresh Claude uses Task tool (built-in)
# If Task tool fails, check Claude Code CLI status
claude --version

未发现 Skill

# Check skill installed
ls -la ~/.claude/skills/multi-ai-consultant

# Check SKILL.md has YAML frontmatter
head -20 ~/.claude/skills/multi-ai-consultant/SKILL.md

# Ask Claude Code to list skills
# It should mention multi-ai-consultant

---

贡献

发现问题？

• 在已知问题部分记录
• 提供修复方案/临时解决方法
• 更新斜杠命令以避免问题

添加新的 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/*

---

许可证

MIT 许可证——参见 LICENSE 文件

---

最后更新：2025-11-07 状态：已可用于生产环境 维护者：Jeremy Dawes | [email protected] | https://jezweb.com.au