🚀 Claude Code 的超级增强器！Agent Skills 让多模型协作成为现实

一句话总结：想让 Claude 变得更强大？Agent Skills 让 Claude 可以召唤 Codex 和 Gemini 一起干活，三个臭皮匠顶个诸葛亮！

🎯 这是什么神仙项目？

你有没有想过，如果能让不同的 AI 模型一起协作会怎样？Agent Skills 就是实现这个梦想的工具！

这是一个由 GudaStudio 开发的开源项目，基于 Anthropic 官方推出的 Agent Skills 机制，让 Claude Code 能够：

• 🤝 与 OpenAI Codex 协作处理复杂算法和后端逻辑
• 🎨 与 Google Gemini 协作设计前端 UI 和样式
• 🔄 实现多模型交叉验证，让代码质量更上一层楼
• 🛡️ 保持代码主权，外部模型只提供建议，最终决策权在你手中

GitHub 地址：https://github.com/GuDaStudio/skills

---

💡 为什么需要多模型协作？

单一模型的局限性

每个 AI 模型都有自己的优势和短板：

• Claude：逻辑严谨、代码质量高，但在某些特定领域可能不如专业模型
• Codex：算法实现和 Debug 能力强，但前端设计可能不够出色
• Gemini：UI/UX 设计优秀，但后端逻辑理解有时存在缺陷

多模型协作的优势

通过 Agent Skills，你可以：

1. 取长补短：让每个模型做自己最擅长的事
2. 交叉验证：多个模型同时审查代码，发现潜在问题
3. 提升质量：综合多方建议，生成更优质的解决方案
4. 加速开发：并行处理不同任务，提高开发效率

---

🌟 核心特性

1. 🔌 模块化设计

每个 Skill 都是独立的模块，包含：

• 📝 任务指令和元数据
• 🐍 Python 桥接脚本
• 🔧 配置文件和资源

目前已收录的 Skills：

Skill	功能	协作模型
collaborating-with-codex	算法实现、Bug 分析、代码审查	OpenAI Codex
collaborating-with-gemini	UI/UX 设计、前端原型、样式优化	Google Gemini

2. 🎭 智能工作流

项目提供了一套完整的 5 阶段工作流：

Phase 1: 上下文检索 (Auggie)
   ↓
Phase 2: 多模型协作分析 (Codex + Gemini)
   ↓
Phase 3: 原型获取 (分路处理)
   ├─ Route A: 前端/UI → Gemini
   └─ Route B: 后端/逻辑 → Codex
   ↓
Phase 4: 编码实施 (Claude 重构)
   ↓
Phase 5: 审计与交付 (双模型 Code Review)

3. 🛡️ 安全机制

• 零写入权限：外部模型对文件系统拥有零写入权限
• 沙箱策略：支持 read-only、workspace-write、danger-full-access 三种模式
• Diff 原型：模型只返回 Unified Diff Patch，不直接修改代码
• 人工审批：关键步骤需要用户确认才能继续

4. 🔄 会话管理

支持多轮对话，通过 SESSION_ID 维护上下文：

# 开启新会话
python scripts/codex_bridge.py --cd "/project" --PROMPT "分析认证流程"

# 继续会话
python scripts/codex_bridge.py --cd "/project" --SESSION_ID "uuid" --PROMPT "提供修复建议"

---

🚀 快速上手

前置要求

• Python 3.8+ (推荐 3.10)
• Claude Code v2.0.56+
• Codex CLI / Gemini CLI (根据需要安装)

一键安装

Windows (PowerShell):

# 克隆仓库
git clone --recurse-submodules https://github.com/GuDaStudio/skills
cd skills

# 查看可用 Skills
.\install.ps1 -List

# 一键安装所有 Skills（用户级）
.\install.ps1 -User -All

# 或者选择性安装
.\install.ps1 -User -Skill collaborating-with-codex

Linux / macOS:

# 克隆仓库
git clone --recurse-submodules https://github.com/GuDaStudio/skills
cd skills

# 查看可用 Skills
./install.sh --list

# 一键安装所有 Skills（用户级）
./install.sh --user --all

# 或者选择性安装
./install.sh --user --skill collaborating-with-codex

验证安装

启动 Claude Code 后，输入：

list all available SKILLs please

如果看到 collaborating-with-codex 和 collaborating-with-gemini，说明安装成功！

---

🎬 实战演示

场景 1：后端逻辑优化

# 让 Codex 分析认证流程
python scripts/codex_bridge.py \
  --cd "/your/project" \
  --PROMPT "Analyze the authentication flow and suggest improvements. OUTPUT: Unified Diff Patch ONLY."

返回示例：

{
  "success": true,
  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
  "agent_messages": "--- a/auth.py\n+++ b/auth.py\n@@ -10,5 +10,8 @@\n+    # Add rate limiting\n+    if check_rate_limit(user):\n+        return error('Too many attempts')\n..."
}

场景 2：前端 UI 设计

# 让 Gemini 设计登录页面
python scripts/gemini_bridge.py \
  --cd "/your/project" \
  --PROMPT "Design a modern login page with glassmorphism style. OUTPUT: Unified Diff Patch ONLY."

场景 3：多模型交叉审查

# 1. 让 Codex 审查代码
python scripts/codex_bridge.py --cd "/project" --PROMPT "Review login.py for security issues"

# 2. 让 Gemini 也审查同一段代码
python scripts/gemini_bridge.py --cd "/project" --PROMPT "Review login.py for security issues"

# 3. Claude 综合两者建议，生成最终修复方案

---

🎨 配置全局提示词（强烈推荐）

为了让 Skills 发挥最大效能，建议在 ~/.claude/CLAUDE.md 中配置全局提示词。

项目提供了一套完整的协作协议，包括：

• 🔄 强制多模型协作：除非任务极简单，否则必须与 Codex/Gemini 协作
• 🛑 硬性阻断机制：关键步骤需用户确认
• 🎯 精准资源调度：不同阶段调用不同模型
• 🔒 代码主权保护：外部模型零写入权限

详细配置请参考 README.md

---

🔧 技术亮点

1. 统一的 JSON 返回格式

// 成功时
{
  "success": true,
  "SESSION_ID": "uuid",
  "agent_messages": "模型回复内容",
  "all_messages": []
}

// 失败时
{
  "success": false,
  "error": "错误信息"
}

2. 灵活的沙箱策略

模式	说明	适用场景
read-only	只读模式（默认）	代码分析、审查
workspace-write	工作区写入	原型开发
danger-full-access	完全访问	高级用户

3. 丰富的参数配置

collaborating-with-codex 参数：

• --PROMPT：任务指令（必填）
• --cd：工作目录（必填）
• --sandbox：沙箱策略
• --SESSION_ID：会话 ID
• --return-all-messages：返回完整推理信息
• --image：附加图片
• --model：指定模型
• --yolo：跳过所有审批（慎用）

collaborating-with-gemini 参数：

• --PROMPT：任务指令（必填）
• --cd：工作目录（必填）
• --sandbox：是否启用沙箱
• --SESSION_ID：会话 ID
• --return-all-messages：返回完整推理信息
• --model：指定模型

---

💎 最佳实践

1. 明确任务分工

• 前端/UI/样式 → Gemini（上下文 < 32k）
• 后端/逻辑/算法 → Codex
• 代码重构/最终实现 → Claude

2. 始终要求 Diff 格式

在 PROMPT 中明确要求：

OUTPUT: Unified Diff Patch ONLY. Strictly prohibit any actual modifications.

3. 利用会话管理

复杂任务分多轮对话处理，保存 SESSION_ID 以维护上下文。

4. 交叉验证

重要代码让 Codex 和 Gemini 同时审查，综合建议后再实施。

---

🤔 常见问题

Q1: 需要额外付费吗？

Skills 本身完全免费开源，但使用 Codex 和 Gemini 可能产生相应的 API 费用。

Q2: 会不会泄露代码？

不会！外部模型只读取代码进行分析，不会上传或存储。且你可以使用 read-only 沙箱模式确保安全。

Q3: 支持哪些编程语言？

支持所有主流编程语言，包括 Python、JavaScript、TypeScript、Go、Rust 等。

Q4: 可以添加自定义 Skill 吗？

可以！项目采用模块化设计，你可以参考现有 Skills 创建自己的协作模型。

---

🌈 未来展望

GudaStudio 团队正在开发更多 Skills：

• 🔍 代码搜索增强：集成更强大的语义搜索
• 🧪 自动化测试：AI 生成测试用例
• 📊 性能分析：智能性能优化建议
• 🌐 多语言支持：支持更多 AI 模型

---

🎁 总结

Agent Skills 是一个革命性的工具，它：

• ✅ 让多个 AI 模型协同工作
• ✅ 提升代码质量和开发效率
• ✅ 保持代码安全和主权
• ✅ 完全免费开源

如果你是 Claude Code 用户，这个项目绝对值得一试！

---

📚 相关链接

• GitHub 仓库：https://github.com/GuDaStudio/skills
• 官方文档：Agent Skills Overview
• 问题反馈：GitHub Issues
• 联系作者：gudaclaude@gmail.com

---

⭐ 给个 Star 吧！

如果这个项目对你有帮助，别忘了去 GitHub 给个 ⭐ 支持一下！

---

作者寄语：AI 的未来不是单打独斗，而是协作共赢。Agent Skills 只是一个开始，让我们一起探索 AI 协作的无限可能！