AI代理指南

AI驱动的编码助手、多代理编排和模型上下文协议（MCP）服务器的综合指南。

______________________________________________________________________

⚠️ AI生成内容免责声明

重要通知：此存储库包含人工智能生成的文档和指南。在我们努力追求准确性和完整性的同时， 生成的内容可能包含错误、不准确或过时的信息. 状态: 🔄 积极发展请负责任地使用本指南： - 根据官方文件核实信息 - 安全环境中的测试代码示例 - 与权威来源的交叉引用 - 通过GitHub issues报告问题或不准确之处我们非常感谢您的理解，因为我们正在为人工智能辅助开发开发开发全面的资源。

______________________________________________________________________

概述

本指南提供了使用现代AI编码助手的深入文档、最佳实践、模板和示例。无论您是使用Claude Code、GitHub Copilot、Gemini CLI还是构建多代理系统，此存储库都是您的完整参考。

里面是什么

🤖 AI助手指南

主要AI编码助理的完整文档：

克劳德代码 -Anthropic的CLI工具，包含MCP服务器、代理和技能
**** -GitHub的AI配对程序员（CLI和IDE）
Gemini CLI -谷歌的Gemini命令行集成

🔌 MCP服务器

模型上下文协议服务器文档：

MCP服务器目录 -50+MCP服务器的综合列表
MCP服务器指南 -安装、配置和使用
构建MCP服务器 -创建自己的MCP服务器

🎭 代理与编排

多代理系统和编排模式：

代理体系结构 -设计模式和最佳实践
编排模式 -协调多个代理
Agent通信 -消息传递和状态管理

🎯 克劳德技能

Claude Code的可重用任务包：

技能指南 -创建和使用Claude技能
技能模板 -现成的技能示例
技能目录 -社区技能收集

📋 模板

项目设置的生产就绪模板：

CLAUDE.md模板 -项目编排文件
AGENTS.md模板 -多代理系统配置
MCP配置模板 -MCP服务器设置
技能模板 -克劳德技能结构

📊 比较和最佳实践

特征比较矩阵 -比较AI助手
用例指南 -哪个工具用于哪个任务
最佳实践 -经过验证的模式和反模式

💡 例子

真实世界的例子和案例研究：

内容生成系统 -多智能体课程构建器
DevOps自动化 -基础设施管理
代码审查系统 -自动代码分析

______________________________________________________________________

快速开始

选择您的工具

从克劳德密码开始？

# Read the Claude Code guide
cat guides/claude-code/README.md

# Copy CLAUDE.md template to your project
cp templates/CLAUDE.md /path/to/your/project/

使用GitHub Copilot？

# Read the Copilot guide
cat guides/github-copilot/README.md

# Install Copilot CLI
gh extension install github/gh-copilot

正在尝试Gemini CLI？

# Read the Gemini CLI guide
cat guides/gemini-cli/README.md

设置MCP服务器

# Copy MCP configuration template
cp templates/mcp-config.json ~/.config/claude-code/mcp.json

# Edit with your server configuration
nano ~/.config/claude-code/mcp.json

创建多代理系统

# Copy AGENTS.md template to your project
cp templates/AGENTS.md /path/to/your/project/

# Customize for your workflow
nano /path/to/your/project/AGENTS.md

______________________________________________________________________

存储库结构

ai-agent-guidebook/
├── README.md                           # This file
├── guides/
│   ├── claude-code/
│   │   ├── README.md                   # Claude Code overview
│   │   ├── installation.md             # Setup and installation
│   │   ├── mcp-servers.md              # MCP server integration
│   │   ├── agents.md                   # Agent orchestration
│   │   ├── skills.md                   # Claude Skills usage
│   │   ├── hooks.md                    # Event hooks
│   │   ├── advanced.md                 # Advanced techniques
│   │   └── troubleshooting.md          # Common issues
│   ├── github-copilot/
│   │   ├── README.md                   # Copilot overview
│   │   ├── cli-guide.md                # CLI usage
│   │   ├── ide-guide.md                # IDE integration
│   │   ├── chat-guide.md               # Copilot Chat
│   │   ├── workspace-guide.md          # Workspace context
│   │   └── best-practices.md           # Usage patterns
│   ├── gemini-cli/
│   │   ├── README.md                   # Gemini CLI overview
│   │   ├── installation.md             # Setup guide
│   │   ├── usage.md                    # Command reference
│   │   └── integration.md              # Integration patterns
│   ├── mcp-servers/
│   │   ├── guide.md                    # MCP introduction
│   │   ├── catalog.md                  # Server catalog (50+)
│   │   ├── installation.md             # Setup instructions
│   │   ├── configuration.md            # Configuration guide
│   │   ├── building.md                 # Build your own
│   │   └── advanced.md                 # Advanced topics
│   ├── agents-subagents/
│   │   ├── architecture.md             # System design
│   │   ├── orchestration.md            # Coordination patterns
│   │   ├── communication.md            # Message protocols
│   │   ├── state-management.md         # State persistence
│   │   └── examples.md                 # Real examples
│   └── skills/
│       ├── guide.md                    # Skills overview
│       ├── creating.md                 # Build skills
│       ├── catalog.md                  # Skill collection
│       └── templates/                  # Skill templates
├── templates/
│   ├── CLAUDE.md                       # Claude orchestration template
│   ├── AGENTS.md                       # Multi-agent template
│   ├── mcp-config.json                 # MCP configuration
│   ├── skill-template/                 # Claude Skill template
│   └── project-templates/              # Complete project setups
├── examples/
│   ├── content-generation/             # Curriculum builder example
│   ├── devops-automation/              # Infrastructure automation
│   ├── code-review/                    # Code analysis system
│   └── data-pipeline/                  # Data processing example
├── comparisons/
│   ├── feature-matrix.md               # Tool comparison
│   ├── use-cases.md                    # Which tool when
│   ├── performance.md                  # Performance benchmarks
│   └── cost-analysis.md                # Cost comparison
├── best-practices/
│   ├── prompting.md                    # Effective prompts
│   ├── context-management.md           # Managing context
│   ├── error-handling.md               # Error recovery
│   ├── security.md                     # Security practices
│   └── testing.md                      # Testing AI systems
└── .github/
    └── workflows/
        └── validate.yml                # CI/CD validation

______________________________________________________________________

主要特点

克劳德代码

✅ MCP服务器集成 -50多个预构建服务器，用于扩展功能
✅ 多代理编排 -为复杂任务生成专业代理
✅ 克劳德技能 -可重复使用的任务包和工作流
✅ 事件挂钩 -使用shell命令自定义行为
✅ 检查点系统 -保存并恢复长时间运行的任务
✅ 上下文管理 -智能上下文下的高效令牌使用

GitHub Copilot

✅ IDE集成 -与VS Code、JetBrains、Vim深度集成
✅ CLI助手 -命令行助手 gh copilot
✅ 副驾驶聊天 -会话编码辅助
✅ 工作区上下文 -项目意识建议
✅ 代码补全 -实时代码建议

Gemini CLI

✅ 谷歌人工智能集成 -访问Gemini模型
✅ 命令行界面 -基于终端的交互
✅ 多模式支持 -文本、图像等
✅ 上下文窗口 -大上下文支持

______________________________________________________________________

用例

选择正确的工具

在以下情况下使用克劳德代码：

构建复杂的多智能体系统
需要MCP服务器生态系统（数据库、API、工具）
编排长时间运行的内容生成
需要检查点/恢复功能
构建自定义克劳德技能

在以下情况下使用GitHub Copilot：

在IDE中编写代码
需要实时代码完成
使用GitHub工作流
快速命令行帮助
结对编程场景

在以下情况下使用Gemini CLI：

需要多模式AI功能
与谷歌生态系统合作
基于终端的工作流
大上下文要求

______________________________________________________________________

入门指南

对于初学者

从这里开始 -选择正确的工具
基本设置 -安装和配置
第一步 -你的第一个人工智能辅助任务

对于高级用户

多智能体系统 -构建复杂的编排
MCP服务器开发 -创建自定义服务器
定制技能 -构建可重复使用的任务包
性能优化 -最大化效率

______________________________________________________________________

示例和案例研究

实际应用

人工智能基础设施课程生成器

8阶段多代理工作流
基于检查点的进度跟踪
集成50+MCP服务器
生成了超过200000字的内容

DevOps自动化系统

基础设施即代码生成
Kubernetes资源管理
CI/CD管道编排
多云部署

代码审查自动化

自动代码分析
安全漏洞扫描
最佳做法执行
文档生成

______________________________________________________________________

最佳实践

提示

✅ 具体详细
✅ 提供上下文和示例
✅ 将复杂任务分解为步骤
✅ 迭代并优化提示

上下文管理

✅ 使用 .claudeignore 排除不相关的文件
✅ 参考特定文件和行号
✅ 提供有针对性的代码片段
✅ 使用MCP服务器处理外部数据

多智能体系统

✅ 明确代理人职责
✅ 使用消息协议进行通信
✅ 实现状态持久化
✅ 故障恢复设计

安全

✅ 永远不要提交API密钥或机密
✅ 使用环境变量
✅ 执行前检查生成的代码
✅ 验证AI输出

______________________________________________________________________

贡献

我们欢迎捐款！查看我们的贡献指南了解详情。

如何贡献

添加指南内容 -扩展现有指南或创建新指南
分享示例 -提交真实世界的用例
创建模板 -构建可重用的模板
文档MCP服务器 -添加到目录
分享技能 -贡献克劳德技能

______________________________________________________________________

资源

官方文件

克劳德代码文档 -克劳德代码官方文档
**** -官方复印件文件
Gemini API文件 -Google Gemini文档
MCP规范 -模型上下文协议规范

社区资源

出色的MCP服务器 -精心策划的MCP服务器列表
MCP目录 -可搜索的MCP服务器目录
克劳德代码社区 -社区讨论

许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

______________________________________________________________________

联系

GitHub: https://github.com/ai-infra-curriculum/ai-agent-guidebook
问题: https://github.com/ai-infra-curriculum/ai-agent-guidebook/issues
讨论: https://github.com/ai-infra-curriculum/ai-agent-guidebook/discussions

______________________________________________________________________

更新日志

看更改日志.md 查看版本历史和发行说明。

______________________________________________________________________

版本: 1.0.0

最后更新: 2025-11-04

状态: 🚀 积极发展

AI Agent Guidebook

快速接入

详细介绍

AI代理指南

⚠️ AI生成内容免责声明

概述

里面是什么

🤖 AI助手指南

🔌 MCP服务器

🎭 代理与编排

🎯 克劳德技能

📋 模板

📊 比较和最佳实践

💡 例子

快速开始

选择您的工具

设置MCP服务器

创建多代理系统

存储库结构

主要特点

克劳德代码

GitHub Copilot

Gemini CLI

用例

选择正确的工具

入门指南

对于初学者

对于高级用户

示例和案例研究

实际应用

最佳实践

提示

上下文管理

多智能体系统

安全

贡献

如何贡献

资源

官方文件

社区资源

相关项目

许可证

联系

更新日志

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP