00 / 00
Skills + MCP：流程与工具的组合
用 Skill 组织任务，通过已连接的 MCP 工具执行外部操作。
Skill 说明怎样处理任务；MCP 是 AI 工具连接外部服务的一种协议。它们可以配合，CLI 和 API 脚本也可以承担外部操作。
先分清各自负责什么
| 部分 | 负责什么 | 需要检查 |
|---|---|---|
| Skill | 流程、专业知识、输出标准、失败处理。 | 任务适用，步骤能执行，结果可检查。 |
| MCP | 把外部服务的工具或资源提供给客户端。 | 服务可用，认证完成，权限满足任务。 |
| 客户端 | 决定怎样加载、调用和执行。 | 支持所需能力，允许相应操作。 |
写一句“读取飞书文档”不会自动取得账户权限。客户端已经有飞书 MCP、CLI 或应用连接时，Skill 才能指导它使用相应能力。
组合案例 1：内容适配
- 用已授权的飞书连接读取完整稿件。
- 按文章适配 Skill 的规则生成公众号和小红书版本。
- 检查事实、引文和排版，保存可查看的文件。
产物是平台版本文件。是否上传草稿或正式发布，另按当前任务处理，不能把改写完成当作发布完成。
组合案例 2：代码与项目协作
- 按项目规则完成改动和相关检查。
- 通过 GitHub MCP 或
gh创建 PR，填写变更与验证结果。 - 读取返回的 PR 链接，确认内容和目标分支。
需要 Git 命令拦截时，使用当前客户端支持的 Hook 或权限机制。git-guardrails-claude-code 是配置 Claude Code Hook 的 Skill，必须完成配置和验证；下载后不会自动在所有客户端生效。详见 开发者页。
组合案例 3：数据报告
- 通过已连接的数据库工具读取所需数据。
- 用脚本完成汇总与计算。
- 按报告模板输出结果，核对字段、总量和图表。
报告中的数字应能追溯到查询或计算。无法访问数据时，说明未完成部分，不编造业务结果。
配置方式
先按客户端的官方入口连接 MCP，再安装需要的 Skill。认证、工具发现和 Skill 发现分别检查。
| 客户端 | 配置参考 |
|---|---|
| Claude Code | 项目共享 MCP 配置使用 .mcp.json；安装和认证见 GitHub 官方接入说明。 |
| Codex | 使用当前客户端的 MCP 设置或配置入口，见 Codex MCP 文档。 |
| 其他客户端 | 使用它自身的 MCP 设置，不能照搬其他工具的配置文件。 |
GitHub 的当前实现见 github/github-mcp-server。它提供远程和本地运行方式，按自己的客户端选择。
Skill 的目录与调用方式见 快速入门。
上下文和权限
工具定义、Skill 描述、调用结果都可能占用上下文。客户端支持工具搜索或延迟加载时，不需要一次载入全部定义；实际成本取决于当前加载和返回的内容。
只连接任务需要的服务，并明确需要读什么、写什么。已有连接不代表所有操作都属于当前任务。
常见误区
- 需要外部服务就必须用 MCP：也可以通过 CLI、API 脚本或客户端已有的应用连接。
- Skill 只是正文，不能执行工具：它可以携带脚本并指导工具调用，执行能力和权限由客户端提供。
- 装好 Skill 就连接完成：账户认证、工具权限和依赖可能仍未配置。
- 工具返回成功就全部完成：还要检查文件、远程对象或业务状态是否符合任务。
下一步
- 通过终端操作 → CLI + Skill
- 自己组织流程 → 创建 Skill
- 排查权限与调用 → FAQ