# 技能与 MCP 工具

如果您试图理解 **Antigravity 技能**和 **MCP 工具**之间的区别，简短版本是：

- **技能**是可重用的 `SKILL.md` 剧本，告诉 AI 助手如何执行工作流。
- **MCP 工具**是集成或可调用功能，让助手能够与外部系统交互。

两者是互补的，而不是竞争的。

## 技能的作用

技能为重复性任务给模型提供更好的指令，例如：

- 规划功能
- 审查代码
- 运行安全审计
- 编写 README
- 调试失败的测试套件

在实践中，技能改进助手在任务中的决策制定、结构和流程。

示例：

- `@brainstorming` 帮助模型在实施之前阐明需求。
- `@lint-and-validate` 帮助模型在声称成功之前运行正确的质量检查。

## MCP 工具的作用

MCP 工具为模型提供其原本不具备的能力，例如：

- 从数据库读取
- 调用 GitHub API
- 从服务获取文档
- 创建日历事件
- 查询外部系统

在实践中，MCP 工具扩展了助手在世界上可以做的事情。

## 最简单的心智模型

使用这个规则：

- **技能告诉助手如何工作。**
- **MCP 工具告诉助手它可以触及哪些系统。**

如果您只安装工具，助手可能有访问权限但仍然表现不一致。

如果您只安装技能，助手可能知道工作流但仍然缺乏到达所需外部系统的能力。

两者结合时，它们会更强大。

## 您应该从哪个开始？

从**技能**开始，如果：

- 您希望立即改进规划、编码、调试、测试或审查行为
- 您主要在本地文件和终端流程中工作
- 您在添加更多集成之前想要可重用的剧本

从 **MCP 工具**开始，如果：

- 您的主要障碍是访问外部系统
- 您需要模型调用 API、查询服务或与托管平台交互
- 您已经喜欢模型的工作流质量，但需要更多覆盖范围

使用**两者**，当：

- 您想要可靠的工作流加上外部能力
- 您正在构建代理系统、内部工具或多步骤操作流程

## 本仓库适合的位置

Antigravity Awesome Skills 主要是一个**技能库**：

- 可安装的 `SKILL.md` 剧本
- 基于角色的入门点的包
- 有序执行模式的工作流
- Claude Code、Cursor、Codex CLI、Gemini CLI 等的工具特定指南

这个仓库中的许多技能也解释了如何与 MCP、API 和其他集成一起工作，但仓库本身以可重用的工作流指导为中心，而不是作为 MCP 服务器。

## 推荐阅读

- [常见问题](faq.md)
- [捆绑包](bundles.md)
- [工作流](workflows.md)
- [AI 代理技能](ai-agent-skills.md)
- [Codex CLI 技能](codex-cli-skills.md)
- [Gemini CLI 技能](gemini-cli-skills.md)