multi-ai-consultant

多 AI 顾问

当 Claude Code 陷入困境或需要做出关键决策时，向外部 AI 征求第二意见。

---

此技能的作用

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

• 尝试一次后仍未能解决的错误
• 做出架构决策
• 需要验证安全问题
• 需要新的视角

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

---

何时使用此技能

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

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

1. 一次调试尝试失败后

   • 尝试了一种方法来修复错误
   • 问题仍未解决，或出现了不同的错误
   • → 建议：“要我向 [Gemini|Fresh Claude] 征求第二意见吗？”

2. 做出架构决策前

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

3. 安全变更

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

4. 不确定时

   • 存在多种可行方案
   • 权衡取舍不明确
   • 文档中的建议相互矛盾
   • → 建议：“你想让我咨询其他 AI，获取更多看法吗？”

手动调用（用户命令）

用户可以明确请求咨询：

• /consult-gemini [question] - Gemini 2.5 Pro，支持思考、搜索和依据
• /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 搜索、扩展推理、依据	~$0.10-0.50
OpenAI GPT-4	codex CLI	代码库分析、代码审查	自动扫描目录、OpenAI 推理	~$0.05-0.30
Fresh Claude	Task tool	快速征求第二意见、节省预算	功能相同，视角新鲜	免费

AI 详细对比：针对特定用例选择咨询哪个 AI 时，加载 references/ai-strengths.md。

---

工作原理

架构

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. 🔍 主要差异 - 观点一致与分歧之处，以及各 AI 发现或遗漏的内容
4. ⚡ 综合结论 - 综合视角、根本原因和权衡取舍
5. ✅ 建议的行动 - 明确的后续步骤，注明文件路径和行号

结尾请写：“要我按此方案继续吗？”

---

设置

完整安装指南：安装 CLI、配置 API 密钥或设置模板时，加载 references/setup-guide.md。

快速设置：

1. 安装 CLI：bun add -g @google/generative-ai-cli（Gemini）、bun add -g codex（Codex，可选）
2. 设置 API 密钥：export GEMINI_API_KEY="..."、export OPENAI_API_KEY="..."
3. 安装技能：创建指向 ~/.claude/skills/multi-ai-consultant 的符号链接
4. 复制模板：将 GEMINI.md、codex.md、.geminiignore 复制到项目根目录
5. 验证：gemini -p "test"、codex exec - --yolo

获取 API 密钥：

• Gemini：https://aistudio.google.com/apikey
• OpenAI：https://platform.openai.com/api-keys

---

用法

详细示例：学习咨询工作流或查看实际场景时，请加载 references/usage-examples.md。

快速示例：

• Bug：尝试失败 1 次后 → 使用 /consult-gemini 获取经网络搜索研究的解决方案
• 架构：做出设计决策时 → 使用 /consult-gemini 获取最新最佳实践
• 代码审查：验证重构时 → 使用 /consult-codex 进行结合代码仓库的代码一致性检查
• 快速意见：进行合理性检查时 → 使用 /consult-claude 获取免费的新视角

提供 5 个详细示例：

1. JWT 身份验证 Bug（节省约 30 分钟，发现特定于平台的问题）
2. 状态管理方案选择（基于 2025 年模式做出明智决策）
3. 重构审查（发现 3 个一致性问题）
4. 安全验证（通过 OWASP 2025 发现 2 个严重问题）
5. 多 AI 工作流（用于高风险的数据库方案选择）

---

斜杠命令

完整命令参考：需要详细语法、选项或费用跟踪信息时，请加载 references/commands-reference.md。

快速命令概览：

/consult-gemini [question]

• 用途：网络研究、最新文档、扩展思考
• 功能：Google Search、grounding、思考模式
• 费用：约 $0.10-0.50
• 示例：/consult-gemini Is this JWT secure by 2025 standards?

/consult-codex [question]

• 用途：结合代码仓库的分析、代码审查
• 功能：自动扫描目录、检查一致性
• 费用：约 $0.05-0.30
• 示例：/consult-codex Review for performance bottlenecks

/consult-claude [question]

• 用途：快速征求第二意见、节省预算
• 功能：免费、快速、提供新视角
• 费用：免费
• 示例：/consult-claude Am I missing something obvious?

/consult-ai [question]

• 用途：路由器（推荐使用哪个 AI）
• 功能：分析问题，推荐最合适的 AI
• 费用：取决于所选 AI
• 示例：/consult-ai How should we structure this architecture?

---

模板

模板用于自定义咨询时的 AI 行为（从项目根目录自动加载）：

1. GEMINI.md - Gemini 的系统指令（强制采用 5 部分格式、进行网络搜索）
2. codex.md - Codex 的系统指令（强制进行结合代码仓库的分析）
3. .geminiignore - 在 .gitignore 之外配置隐私排除项
4. consultation-log-parser.sh - 查看咨询历史记录（可选）

安装：将文件从 ~/.claude/skills/multi-ai-consultant/templates/ 复制到项目根目录

---

隐私与安全

自动保护：

• 两个 CLI 都会自动遵循 .gitignore
• 创建 .geminiignore 以添加额外的排除项（.env*、*secret*、*credentials*）
• 咨询前检查会在检测到敏感模式时发出警告

隐私最佳实践：

• 始终正确配置 .gitignore
• 创建 .geminiignore 以加强保护
• 智能选择上下文（指定文件，而非整个代码仓库）
• 确认即将发送的内容：git status --ignored

详细的隐私配置：设置 .geminiignore 或隐私排除项时，请加载 references/setup-guide.md。

---

费用跟踪

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

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

查看日志：consultation-log-parser.sh --summary

输出示例：

Total consultations: 47
Gemini: 23 ($4.25), Codex: 12 ($1.85), Fresh Claude: 12 ($0.00)
Total cost: $6.10

详细的费用跟踪：查看日志、计算费用或管理预算时，请加载 references/commands-reference.md。

---

常见问题

完整故障排除指南：遇到错误或设置问题时，加载 references/troubleshooting.md。

最常见的 5 个问题：

1. 未安装 CLI：gemini: command not found → 修复：bun add -g @google/generative-ai-cli
2. API 密钥无效：身份验证失败 → 修复：export GEMINI_API_KEY="..."
3. 上下文过大：超出令牌限制 → 修复：使用指定文件，而非整个代码库
4. 隐私泄露：发送了 .env 文件 → 修复：将其添加到 .gitignore 和 .geminiignore
5. 未发现技能：无法正常工作 → 修复：检查 ~/.claude/skills/multi-ai-consultant

---

令牌效率

不使用此技能

典型场景（卡在 Bug 上）：

1. 尝试方法 1（约 4k 个令牌）
2. 查询 CLI 语法（约 3k 个令牌）
3. 尝试方法 2（约 4k 个令牌）
4. 查询文档（约 3k 个令牌）
5. 尝试方法 3（约 4k 个令牌）

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

使用此技能

相同场景：

1. 尝试方法 1（约 4k 个令牌）
2. 执行 /consult-gemini（约 1k 个令牌）
3. Gemini 找到问题（少于 5k 个令牌，单独计费）
4. 实施修复（约 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、Codex 或全新的 Claude）
• 基于比较：了解不同 AI 之间的能力、成本和取舍
• 基于策略：规划组合策略（免费 → 付费、优先付费、注意预算）
• 基于能力：了解特色功能（Google Search、扩展思考、接地、仓库感知、全新视角）
• 基于场景：多 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 | [email protected]