阶段 13：工具与协议
AI 与真实世界之间的接口。
本阶段从函数调用和工具 schema 进入可互操作协议、Agent Skills、安全与生产治理。数字顺序适合浏览；下面的聚焦路径才是可靠的学习顺序。
在 GitHub 上开始本阶段
前置要求： 阶段 11 的 LLM 补全 API。若要学习 MCP 或 Agent Skills，请走下面的聚焦路径，不要假定课程编号就是学习顺序。
完整阶段的第一课： 工具接口
从仓库根目录运行：
python3 phases/13-tools-and-protocols/01-the-tool-interface/code/main.py记录命令、退出码、描述-决策-执行-观察轨迹、被拒绝输入的证据，以及一句解释回合上限的原因。
下一步： 继续学习函数调用深入剖析，或选择下方的 Model Context Protocol（MCP）或 Agent Skills 路径。
Model Context Protocol（MCP）路径
这条聚焦 MCP 路径有 17 课，约 23 小时 15 分钟。它遵循 MCP 2026-07-28，从一个可自描述的 JSON-RPC 请求走到可运行的合规闸门。
| 阶段 | 课程 | 你要证明什么 | 时间 |
|---|---|---|---|
| 核心 | 06、07、08、09、10 | 信封、发现、客户端与服务端行为、传输、资源和 prompts。 | 5 小时 50 分钟 |
| 双向 | 11、12、13、14 | MRTR 输入、显式范围、持久任务，以及不依赖服务端发起请求的应用边界。 | 5 小时 |
| 安全 | 15、16、18、17 | 投毒防御、授权、生产 token、网关路由和注册表接纳。 | 5 小时 15 分钟 |
| 进阶 | 28、29、30、31 | 契约保真度、取消竞态、供应链漂移和发布证据。 | 7 小时 10 分钟 |
确切顺序是 06、07、08、09、10、11、12、13、14、15、16、18、17、28、29、30、31，定义在learning-paths/model-context-protocol.json。导师会创建 MCP-LEARNING.md，每次调用讲一课，并记录每个检查点需要的请求、响应、命令、工作目录、退出码和脱敏后的边界证据。
用你的宿主支持的调用方式开始：
| 宿主 | 调用方式 |
|---|---|
| Codex | learn-mcp，或从 /skills 中选择 |
| Claude Code | /learn-mcp |
| 其他兼容宿主 | Use learn-mcp to start or resume the Model Context Protocol (MCP) path. |
前十分钟要做什么
从仓库根目录运行第 06 课的无状态轨迹：
python3 phases/13-tools-and-protocols/06-mcp-fundamentals/code/main.py在输出中找四样东西：重复的请求元数据、完整的 server/discover 结果、不支持版本时的 -32022 错误，以及不会创建或终止 MCP 协议会话的传输关闭。这段轨迹是第一个检查点，不只是演示。
如果仓库或 Python 3 不可用，阅读第 06 课，手动追踪一次请求和响应。将检查点标记为概念完成，并把运行时、传输、授权和部署证据保持为待完成。
在任何非 loopback 绑定、共享入口、托管端点或注册表发布之前，先完成第 15 课的可执行安全检查点。审查外部目标和请求的授权范围，然后明确确认部署操作。完成教程不等于获得部署权限。
旧版 initialize、Mcp-Session-Id、独立 SSE GET、会话 DELETE 和服务端发起请求的流程，只会出现在明确的兼容说明中。现代请求会在 params._meta 中声明协议版本和客户端能力，使用 server/discover，并携带足够的信息以独立完成验证、授权、路由和重试。
第 23 课是唯一可选的 MCP 路径综合项目。在开始之前，完成 17 节必修课以及第 19 课和第 20 课。
Agent Skills 快速路径
这条聚焦路径有五课，约 9 小时 30 分钟：
| 步骤 | 课程 | 结果 | 时间 |
|---|---|---|---|
| 1 | 22：可移植契约与运行时边界 | 创建、安装、调用、验证并移除完整的 skill bundle。 | 90 分钟 |
| 2 | 24：发现与渐进式披露 | 追踪发现、编目、激活与资源加载。 | 105 分钟 |
| 3 | 25：调用与路由 | 控制显式、隐式、人工、模型与放弃调用的路径。 | 105 分钟 |
| 4 | 26：权限、沙箱与信任 | 区分指令、权限、隔离与验证。 | 120 分钟 |
| 5 | 27：评估、打包与可移植性 | 构建发布闸门，并在真实宿主中证明行为。 | 150 分钟 |
用你的宿主支持的调用方式开始：
| 宿主 | 调用方式 |
|---|---|
| Codex | learn-agent-skills，或从 /skills 中选择 |
| Claude Code | /learn-agent-skills |
| 其他兼容宿主 | Use learn-agent-skills to start or resume the Agent Skills Engineering path. |
导师会创建或恢复 AGENT-SKILLS-LEARNING.md，每次调用讲一课，并记录每个检查点需要的证据。这条路径定义在learning-paths/agent-skills.json中。
如果想先阅读，从第 22 课开始。它的第一个实验约十分钟就能把一个 skill 安装进真实宿主。
前置要求快速通道
- 要完成真实实验，需要
node、npx、python3、一个选定的支持 skill 的宿主，以及对所选项目或用户 skill 范围的写入权限。安装前先用node --version、npx --version和python3 --version验证这三个命令。 - 如果预检条件不具备，请使用网站或手动阅读各课的
docs/zh.md。你可以完成概念部分，但发现、调用、脚本、更新和卸载的证据仍应标记为待完成。 - 若不熟悉工具契约，先浏览第 01 课和第 05 课。
- 在第 26 课前，确认你能解释工具投毒和不可信指令。第 15 课是此项预检的可选复习，不是这条路径的第六节必修课。
- 第 23 课是可选的系统综合项目，不是完成第 22 课后下一节 Agent Skills 课程。参加之前先完成第 06 至 20 课。
完整阶段
请查看ROADMAP.md了解完整课程计划。