AI编程助手指南

提供AI编程助手(如Claude Code、GitHub Copilot、Gemini CLI等)的详细文档、最佳实践和模板,支持多代理协调和模型上下文协议(MCP)服务器集成。

  • by ai-infra-curriculum
  • Shell
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 ai-infra-curriculum/ai-agent-guidebook

使用说明

AI代理指南

🎓 部分 免费、开源的人工智能基础设施课程。现场直播,讲师指导 队列 和 团队计划,访问 ai-infra-curiculum.github.io.

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


⚠️ AI生成内容免责声明

重要通知:此存储库包含人工智能生成的文档和指南。在我们努力追求准确性和完整性的同时, 生成的内容可能包含错误、不准确或过时的信息.

状态: 🔄 积极开发

请负责任地使用本指南:

  • 根据官方文件核实信息
  • 安全环境中的测试代码示例
  • 与权威来源的交叉引用
  • 通过GitHub issues报告问题或不准确之处

我们非常感谢您的理解,因为我们正在为人工智能辅助开发开发开发全面的资源。


概述

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

里面有什么

🤖 AI助手指南

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

  • 克劳德代码 -Anthropic的CLI工具,包含MCP服务器、代理和技能
  • GitHub Copilot -GitHub的AI配对程序员(CLI和IDE)
  • Gemini CLI -谷歌的Gemini命令行集成
  • 光标 -AI第一代码编辑器:Agent、Plan模式、, .cursor/rules,以及MCP
  • VS Code -VS代码作为代理环境:代理模式、MCP和自定义指令
  • 谷歌反重力 -Agent优先IDE:编辑器视图+Agent管理器,基于Gemini构建

🔌 MCP服务器

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

🎭 代理与编排

多代理系统和编排模式:

🎯 克劳德技能

Claude Code的可重用任务包:

📋 模板

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

📊 比较和最佳实践

💡 例子

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


快速开始

选择您的工具

从克劳德密码开始?

# 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 the MCP configuration template into your project as .mcp.json
# (Claude Code's project-scope MCP config)
cp templates/mcp-config.json /path/to/your/project/.mcp.json

# Edit with your server configuration
nano /path/to/your/project/.mcp.json

# Or add servers via the CLI instead:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem "$(pwd)"

创建多代理系统

# 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
│   │   ├── claude-md.md                # CLAUDE.md & memory files
│   │   ├── settings-and-permissions.md # settings.json & permissions
│   │   ├── 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
│   └── prompt-templates/               # Explore→Plan→Implement→Verify prompts
├── 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
│   ├── agentic-workflow.md             # Plan → execute → verify loop
│   ├── context-management.md           # Managing context
│   ├── error-handling.md               # Error recovery
│   ├── security.md                     # Security practices
│   ├── testing.md                      # Testing AI systems
│   ├── performance.md                  # Model selection & cost/latency
│   └── agent-governance.md             # Agent governance & trust
└── .github/
    └── workflows/
        └── ci.yml                      # CI 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功能
  • 与谷歌生态系统合作
  • 基于终端的工作流
  • 大上下文要求

入门指南

对于初学者

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

对于高级用户

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

示例和案例研究

实际应用

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

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

DevOps自动化系统

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

代码审查自动化

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

最佳实践

提示

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

上下文管理

  • ✅ 使用 permissions.deny 规则(克劳德代码)并忽略文件(.cursorignore, .geminiignore)排除不相关的文件
  • ✅ 参考特定文件和行号
  • ✅ 提供有针对性的代码片段
  • ✅ 使用MCP服务器处理外部数据

多智能体系统

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

安全

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

贡献

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

如何贡献

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

资源

官方文档

社区资源

相关项目

  • AI基础设施内容生成器 -课程生成框架
  • MCP服务器存储库 -官方MCP服务器
  • Veriswarm -人工智能代理的信任基础设施(实时信任评分、PII/提示注入护栏、便携式代理凭据、哈希链审计分类账)。跨框架——与LangChain、CrewAI、AutoGen、Agentforce、Microsoft Agent 365、AWS Bedrock兼容。看 代理治理与信任 对于这适合的地方。

许可证

此项目根据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.2.0

最后更新: 2026-06-11

状态: 🚀 主动开发——涵盖当前的Claude模型(Fable 5、Opus 4.8、Sonnet 4.6、Haiku 4.5)、独立的GitHub Copilot CLI+编码代理、Gemini CLI(Gemini 3.x)和MCP规范修订版2025-11-25。


由维护 VeriSwarm.ai