Metal 教程 Skill

专门用于处理 Metal 渲染相关的教程文档和参考资料。所有文档都是提炼好的 Markdown 格式，专注于 Metal 渲染管线相关技术。

工作流程

当用户询问关于 Metal 相关技术问题时：

•
自动识别 Metal 相关文档
- •优先查找 references/ 文件夹中的所有 .md 文件
- •如果 references/ 文件夹不存在或为空，再查找项目根目录中的 .md 文件
- •优先查找文件名包含 "metal"、"Metal"、"tutorial"、"教程" 等关键词的文件
- •支持多个 Markdown 文件，可以跨文件搜索相关内容
- •
  常见文件示例（位于 references/ 文件夹）：
  - •references/Metal.by.Tutorials.4th.2023.12.md
  - •references/metal-rendering-guide.md
  - •references/metal-api-reference.md
  - •references/metal-best-practices.md
  - •其他 Metal 相关的 .md 文件
•
处理文档内容
- •直接读取 Markdown 文件内容（所有文档都是提炼好的 .md 格式）
- •对于大型文档，可以分段处理或按章节搜索
- •支持跨多个文档搜索相关内容
- •根据问题关键词智能选择最相关的文档
•
基于文档内容回答问题（重要：必须明确标注来源）
- •
  必须明确说明答案来源：
  - •如果答案来自 references/ 文件夹中的文档，必须明确标注：
    
    •📚 来源文档：references/文件名.md
    
    •📖 具体章节：如 "Chapter 3: The Rendering Pipeline"
    
    •📄 代码位置：如果引用了代码，说明代码所在的章节或位置
  - •如果多个文档都有相关内容，列出所有来源
- •仔细阅读相关文档内容
- •从文档中查找准确答案
- •引用具体的章节标题、代码示例或 API 说明
- •如果多个文档都有相关内容，可以综合引用
- •
  如果文档中没有相关信息：
  - •❌ 明确告知用户：在 references/ 文件夹中没有找到相关信息
  - •❓ 询问用户：是否希望我：
    
    •
    
    •通过网络搜索查找相关信息
    
    •
    
    •基于大模型的通用知识来回答
    
    •
    
    •或者等待用户提供更多信息
  - •不要在没有明确说明来源的情况下，直接使用网络或大模型的知识回答

回答格式要求

当找到参考文档时

回答格式示例：

code

📚 **来源**：`references/Metal.by.Tutorials.4th.2023.12.md`
📖 **章节**：Chapter 3: The Rendering Pipeline

[答案内容]

**代码示例**（来自 Chapter 1）：
```swift
[代码内容]

code

### 当找不到参考文档时

回答格式示例：

❌ 未找到参考

在 references/ 文件夹中没有找到关于 [问题主题] 的相关信息。

❓ 请选择：

•通过网络搜索查找相关信息
•基于大模型的通用知识来回答（可能不够准确）
•等待您提供更多信息或添加相关文档

请告诉我您希望使用哪种方式？

code

## 文档存放位置

**所有 Metal 相关的 Markdown 文档应该放在 `references/` 文件夹中**：

project-root/ ├── references/ # Metal 文档存放文件夹 │ ├── Metal.by.Tutorials.4th.2023.12.md │ ├── metal-rendering-guide.md │ ├── metal-api-reference.md │ └── [其他 Metal 相关的 .md 文件] ├── .cursor/ │ └── skills/ │ └── metal-tutorials/ └── ...

code

## 支持的文档类型

此 skill 专门处理以下类型的 Metal 相关文档：

- **教程文档**：如 Metal by Tutorials 等系统教程
- **API 参考**：Metal API 使用说明和示例
- **最佳实践**：Metal 性能优化和最佳实践指南
- **代码示例**：Metal 代码示例和实现细节
- **概念解释**：Metal 渲染管线、着色器等核心概念

所有文档都应该是提炼好的 Markdown 格式（.md 文件），存放在 `references/` 文件夹中。

## 使用方法

### 直接提问

用户可以直接提问，skill 会自动识别并使用 `references/` 文件夹中的相关文档：

- "Metal 的渲染管线是什么？"
- "如何创建 MTLDevice？"
- "Command Buffer 和 Command Queue 有什么区别？"
- "第 3 章的主要内容是什么？"
- "Metal 中如何处理纹理？"
- "延迟渲染的实现方式？"

### 多文档支持

如果 `references/` 文件夹中有多个 Metal 相关的 Markdown 文件，skill 会：
- 自动搜索所有相关文档
- 根据问题选择最相关的文档
- 可以跨文档综合回答
- **列出所有相关文档的来源**

## 针对 Metal 技术的特殊处理

当处理 Metal 相关问题时：

- **API 识别**：自动识别 Metal API（如 MTLDevice、MTLCommandBuffer、MTLRenderPipelineDescriptor 等）
- **概念理解**：理解 Metal 核心概念（渲染管线、着色器、资源管理等）
- **代码示例**：优先查找和引用代码示例
- **章节定位**：能够定位到具体的章节（如 "Chapter 3: The Rendering Pipeline"）
- **跨文档搜索**：如果问题涉及多个主题，可以搜索多个文档
- **来源标注**：必须明确标注每个答案的来源文档和章节

## 触发关键词

Skill 会在以下情况下自动触发：

- Metal 相关技术问题
- 渲染管线、着色器、GPU 编程
- Metal API 使用问题
- 代码示例请求
- 章节内容查询
- 概念解释请求
- 性能优化问题

**注意**：即使没有明确提到文档名称，只要问题涉及 Metal 技术内容，skill 也会自动检查 `references/` 文件夹中的相关文档。

## 重要原则

### 必须遵守的规则

1. **明确标注来源**：每个答案都必须明确说明是否来自 `references/` 文件夹中的文档
2. **具体出处**：如果来自参考文档，必须说明：
   - 文档文件名（如 `references/Metal.by.Tutorials.4th.2023.12.md`）
   - 具体章节（如 "Chapter 3: The Rendering Pipeline"）
   - 代码位置（如果引用了代码）
3. **找不到时询问**：如果在 `references/` 文件夹中找不到相关信息，必须：
   - 明确告知用户未找到参考
   - 询问用户是否要使用网络搜索或大模型知识
   - **不要**直接使用网络或大模型知识而不说明
4. **诚实回答**：如果答案是基于大模型知识而非参考文档，必须明确说明

## 注意事项

- **文档位置**：所有 Metal 相关文档应该放在 `references/` 文件夹中
- **文档格式**：所有文档都应该是提炼好的 Markdown 格式（.md 文件）
- **文件命名**：建议文件名包含 "metal" 或相关关键词，便于自动识别
- **多文档支持**：支持处理多个 Markdown 文件，可以跨文件搜索
- **准确性**：始终基于文档的实际内容回答，不要猜测
- **版本信息**：注意区分不同版本或不同文档的内容差异
- **来源透明**：必须明确标注答案来源，提高可信度

## 参考资源

- 详细使用说明：参见 [.cursor/skills/metal-tutorials/references/usage.md](.cursor/skills/metal-tutorials/references/usage.md)