---
title: 第一步：安装 Remotion Best Practice Skill
source_url: https://mp.weixin.qq.com/s/PG-rXJllhrtynAfNZn5asg
publish_date: 2026-04-30
tags: [wechat, article, claude, agent]
review_value: 7
review_confidence: 7
review_recommendation: neutral
sha256: 14f2a67c74c6d62c73dd20405f244abacebc8be43e24e415b85956ded88d651a
---
在 AI 原生工作流加速普及的今天，掌握 Skill 已不再是开发者的专属能力，而是产品、运营、设计乃至技术管理者提升人机协同效能的核心职业素养。它直接决定你能否把模糊需求转化为稳定、可复用、可协作的 AI 执行单元，从而在项目交付中显著提升质量一致性、降低沟通成本、规避重复试错。
一、理解 Skill 的本质：菜单与菜谱的比喻
没有菜单的餐馆，会发生什么？
想象你走进一家餐馆，直接对厨师说："帮我做一道红烧肉。"
结果——厨师按自己的理解自由发挥。你收到的可能是完全不合口味的东西。
这正是我们每天在用 AI 时遇到的问题。
你向 AI 传达了需求，AI 却按自己的理解执行，导致你不得不反复修正输出，持续"调教"——高成本、低确定性、难以复现。
有了菜谱，一切就不同了
Skill 就是 AI 世界里的菜谱（Recipe）。
当 AI 有了一份清晰的菜谱，它就知道：
这道菜的标准做法是什么
哪些步骤是必须的
用哪些食材、什么火候、什么顺序
你作为顾客（用户）只需点菜，AI（厨师）就能按菜谱稳定交付。
整个 AI 工具生态的类比映射
餐馆场景 AI 工具 说明
菜谱 / 菜单 Skill 告诉 AI 怎么做、按什么标准做
厨师 Agent / 模型 执行者
食材 + 专业厨具 MCP 连接外部服务，提供"食材"
今天的固定套餐 Slash Command（/指令） 一次性快捷指令
厨房基本规则 Rules 全局约束，始终生效
副厨、帮厨 Sub-agent 专项协作角色
MCP 提供专业厨房——让 AI 能访问你的工具、数据和外部服务。
Skill 提供菜谱——告诉 AI 如何将这些工具用好、按什么工作流执行。
两者结合，才能让用户无需每次从头解释，AI 也能稳定交付高质量结果。
二、Skill 是什么？结构与工作原理
Skill 的本质定义
Skill 是一个开放标准的文件夹，包含一套告诉 AI 如何处理特定任务或工作流的指令。它是目前最强大的 AI 定制方式之一：教 AI 一次，永久受益——不再需要在每次对话中重新解释你的偏好、流程和领域知识。
Skill 的文件结构
your-skill-name/
├── SKILL.md              ← 必须有，且必须是这个大小写
├── scripts/              ← 可选：Python、Shell 等可执行脚本
│   ├── process_data.py
│   └── validate.sh
├── references/           ← 可选：按需加载的参考文档
│   ├── api-guide.md
│   └── examples/
└── assets/               ← 可选：模板、字体、图标等资源
    └── report-template.md
⚠️ 三个命名硬规则：
三级渐进式披露机制（Progressive Disclosure）
这是 Skill 最核心的工作原理，决定了它既节省上下文，又能承载复杂知识：
第一级：YAML Frontmatter（元数据头部）
→ 始终加载在 AI 的系统提示词中
→ 只包含 name 和 description
→ 作用：让 AI 知道"我有哪些技能、分别在什么时候用"
→ 类比：图书馆的目录卡片
第二级：SKILL.md 正文
→ 当 AI 判断当前任务与该 Skill 相关时，才加载完整正文
→ 包含具体执行步骤、示例、注意事项
→ 类比：从书架上取出那本书，深度阅读
第三级：scripts/ references/ assets/ 中的文件
→ 只在 Skill 执行过程中需要时才按需读取
→ 类比：书中引用的附录和参考资料
这个机制的三大优势：
优势 说明
省上下文 大量 Skill 并存时，AI 只加载目录信息，不会撑爆上下文窗口
省推理成本 步骤清晰，AI 减少"想怎么做"的推理次数，降低 token 消耗
结果确定 固定步骤 + 可脚本化执行，输出稳定，关键细节不遗漏
Skill 的跨平台兼容性
Skill 是开放标准，在以下环境中完全兼容：
✅ Qoder（Quest 模式、AIDE 模式、CLI）
✅ Claude.ai 网页端
✅ Claude Code CLI
✅ JetBrains 插件（即将支持）
✅ Claude API（通过 container.skills 参数）
三、三个关键问题：Skill vs Slash Command vs MCP vs Rules
维度 Skill Slash Command MCP Rules
触发方式 AI 自主判断 + 可主动 / 调用 用户主动输入 /xxx 工具调用时自动触发 始终在上下文中生效
内容复杂度 高：多步骤、脚本、资源、引用文件 低：固定短提示词 中：工具接口定义 低：全局约束规则
上下文占用 极低（只加载 meta data） 中（加载固定提示词） 高（一次性加载所有工具定义） 低（始终存在）
可分发性 ✅ 天然适合团队共享和生态传播 ❌ 难以共享 ✅ 通过服务端共享 ❌ 通常个人配置
适合场景 重复性工作流、跨项目规范、领域最佳实践 一次性快捷动作 调用外部系统数据 全局行为约束
简单判断法则：
需要调用外部系统（数据库、邮件、日历、Notion）？→ MCP
只是一条全局约束（语言、格式）？→ Rules
一次性快捷操作，不需要复用？→ Slash Command
可复用的标准化工作流，需要团队共享？→ Skill ✅
💡 实践结论：Slash Command 能做的，Skill 都能做（Skill 也可以通过 / 调用）。但 Skill 还能引用脚本、内嵌资源、模块化分发。对新用户来说，直接学 Skill 即可，无需纠结 Slash Command。
四、什么任务最适合写成 Skill？三大使用场景
场景一：文档与资产创建（Document & Asset Creation）
适合人群：运营、产品、设计、所有人
核心特征：需要生成符合特定风格、规范或品牌标准的输出物
典型案例：
给产品制作宣传视频（Remotion Best Practice Skill）
生成高质量前端界面（frontend-design Skill）
按公司模板生成 Word/PPT/Excel 文档
制作符合设计规范的海报或社交媒体图文
场景二：工作流自动化（Workflow Automation）
适合人群：开发、技术管理者、任何有重复性工作的人
核心特征：多步骤流程，期望每次输出结果一致
典型案例：
每次新增 API 后自动同步文档 + 兼容性检查 + 单元测试框架
代码提交前自动执行 Code Review 规范
按固定模板生成项目进展报告
场景三：MCP 能力增强（MCP Enhancement）
适合人群：已经连接了 MCP 的开发者、技术团队
核心特征：有了工具访问权限，但缺乏"怎么用好"的工作流知识
典型案例：
连接了 Linear MCP，但每次都要解释 Sprint 规划流程 → 写一个 Skill 固化这套流程
连接了 GitHub MCP，但代码审查没有标准 → 写一个 Skill 定义审查步骤
五、安装你的第一个开源 Skill（5 分钟上手）
找到 Skill 的两个主要入口：
https://skills.sh — 当前最流行的开放 Skill 市场，含 Remotion（视频）、from-design（前端）等热门 Skill
Qoder 官方 Skill 门户（即将上线，中英双语，按角色分类：开发 / 运营 / 产品 / AI 技术）
三种安装方式：
方式 A：命令行安装（推荐，最快）
npx skills add <skill-name>
执行后，按交互提示：
1. 选择目标 Agent → 选 Qoder
2. 选择安装级别：
   Global（用户级）→ 安装到 ~/.qoder/skills/，适合个人长期使用
   Project（项目级）→ 安装到 <项目根>/.qoder/skills/，适合团队规范
3. 选择 copy 模式，无需额外依赖
方式 B：手动放置文件
直接，将 Skill 文件夹复制到以下目录：
~/.qoder/skills/  （用户级，全局生效）
<项目根目录>/.qoder/skills/  （项目级，推荐团队规范）
方式 C：在 Qoder Quest 模式中用内置 Skill 生成
直接对话：帮我创建一个 Skill，用于 [描述你的需求]
AI 会引导你完成所有步骤，并自动放置到正确目录。
六、三大实战场景演示
场景 A：用 Skill 制作产品宣传视频（适合运营/产品）
# 第一步：安装 Remotion Best Practice Skill
npx skills add remotion-best-practice
# 第二步：在 Qoder Quest 模式中输入
帮我为 [产品名] 制作一个中文宣传视频，请先访问官网了解产品特性。
AI 执行流程：
1. 自动识别并加载 Remotion Skill
2. 访问官网，了解产品背景
3. 按 Skill 的最佳实践搭建 Remotion 工程（自动处理 npm 环境）
4. 生成分页视频脚本，渲染成视频文件
场景 B：有 Skill 与无 Skill 的前端设计对比（适合所有人）
安装 from-design Skill：
npx skills add from-design
同样的需求，有 Skill 后 AI 会：
1. 首先确认设计方向（这是无 Skill 时根本不会问的环节）
2. 选择独特字体搭配、非常规色彩方案、有格调的布局
3. 输出具有审美一致性的完整设计
核心洞察：Skill 填补了你的"知识盲区"。你不知道怎么提设计需求，但 Skill 知道——它把设计领域的最佳实践打包进来，让 AI 按专家标准执行。
场景 C：规范化 Java 工程的 API 开发（适合开发/技术管理）
Step 1：在 Quest 模式中生成 Skill
帮我创建一个 Skill，要求：
在创建、修改、删除 API 接口时，必须完成：
1. 同步更新 OpenAPI 格式的 API 文档
2. 检查新接口不破坏现有接口的兼容性
3. 生成对应的单元测试框架
4. 以 change log 格式记录本次变更
Step 2：强化 Skill——加入确定性脚本
在 scripts/check_api_docs.py 中生成脚本，并在 SKILL.md 中引用，以后直接本地运行，不消耗 AI token。
Step 3：放入项目目录，团队共享
git add .qoder/skills/
git commit -m "feat: add api-standard skill v1.0"
git push
七、动手编写你自己的 Skill（含官方规范）
完整文件格式示例：
--- name: your-skill-name
description: |
  [说明这个 Skill 做什么] + [说明什么时候使用它，含触发词]
  例如：当用户需要新增、修改或删除 API 接口时，
  或说到 "接口文档"、"兼容性检查"、"单元测试"时，使用本 Skill。
license: MIT
metadata:
  author: 你的名字或团队
  version: 1.0.0
---
## 目标
[一句话描述这个 Skill 要实现什么]
## 执行步骤
### 第一步：[具体行动]
[清晰说明做什么，怎么做]
期望输出：[描述成功时看到什么]
### 第二步：[具体行动]
[继续...]
示例
示例 1：[常见场景]
用户说："新增一个用户登录接口"
AI 执行步骤：
1. 创建接口代码
2. 在 OpenAPI 文档中添加对应条目
3. 检查是否与现有认证接口兼容
4. 生成 JUnit 测试框架
错误处理
错误：[常见错误信息]
● 原因：[为什么发生]
● 解决：[怎么修复]
### YAML Frontmatter 详解（最重要的部分）
Frontmatter 是 AI 决定"是否调用这个 Skill"的唯一依据。
**必填字段**：
--- name: api-standard-check
description: |
  当开发者新增、修改或删除 API 接口时，自动执行本 Skill，
  完成 API 文档同步、向后兼容性检查和单元测试框架生成。
  触发词：接口文档、API 规范、兼容性、单元测试、接口变更。
---
**可选字段（完整版）**：
--- name: api-standard-check
license: MIT
metadata:
  author: 栗子团队
  version: 1.0.0
  mcp-server: github   # 如果配合某个 MCP 使用，注明名称
  category: development
  tags: [api, documentation, testing]
  documentation: https://your-docs-url.com
---
禁止事项：
# ❌ 禁止在 frontmatter 中使用 XML 尖括号
description: Use for <important> cases  # 错误！
# ❌ 禁止 name 中含 "claude" 或 "anthropic"（保留词）
name: claude-helper  # 错误！
# ❌ 禁止 name 有空格或大写
name: My Cool Skill  # 错误！
name: my-cool-skill  # ✅ 正确
写好 Description 的三个黄金原则：
原则一：同时说明"做什么"和"什么时候用"
原则二：包含用户实际会说的话（触发词）
原则三：控制长度，不超过 1024 字符
正文写作的四个技巧：
1. 用第三人称描述步骤
2. 步骤编号化：每步只做一件事
3. 关键验证前置
4. 引用胜过嵌入
八、五大进阶模式：让 Skill 处理复杂工作流
模式一：顺序工作流编排
适用：需要严格按顺序执行的多步流程
模式二：跨 MCP 协调
适用：工作流跨越多个外部服务
（例如：Figma 导出 → Drive 存储 → Linear 任务创建 → Slack 通知）
模式三：迭代优化循环
适用：需要多轮优化才能达到质量标准的输出
模式四：上下文感知的工具选择
适用：同一个目标，根据文件类型或场景选择不同工具
模式五：领域专业知识内嵌
适用：需要将复杂的合规规则、行业知识内嵌到工作流中
九、测试与迭代：让 Skill 越来越准
测试一：触发测试（最关键）
目标：确保 Skill 在正确的时机加载，不该加载时不加载。
✅ 应该触发的测试用例（至少 10 个）
❌ 不应该触发的测试用例
测试二：功能测试
运行同一个请求 3-5 次，检查：输出结果是否一致、API 调用是否成功（0 错误为目标）、关键步骤是否都完成
测试三：与无 Skill 基线对比
指标 无 Skill 有 Skill 改善
用户需要提供的说明 每次都要解释 无需解释 ✅
来回对话轮次 15 轮 2 轮 ✅
API 调用失败次数 3 次 0 次 ✅
Token 消耗 12,000 6,000 ✅
动态优化：用自然语言修改 Skill
"你刚才的输出中，[具体描述问题]。请把这个改进固化到 [skill-name] 这个 Skill 文件中。"
十、团队协作与 Skill 治理
两级安装策略：
用户级（全局）：~/.qoder/skills/ — 个人偏好、跨项目通用
项目级：<项目根>/.qoder/skills/ — 团队规范、项目特定流程（推荐提交到 Git）
Git 协作最佳实践：
git add .qoder/skills/
git commit -m "feat: add api-standard skill v1.0"
git push
团队成员 git pull 后立即生效，无需额外操作
组织级 Skill 部署：
如果你的公司使用 Claude 企业版，管理员可以在工作区级别统一部署 Skill，所有成员自动获得，并可集中管理版本更新。
十一、常见问题排查 FAQ
Q：Skill 上传失败，提示 "Could not find SKILL.md"
→ 检查文件名是否严格为 SKILL.md（区分大小写）
Q：上传失败，提示 "Invalid frontmatter"
→ 最常见的 YAML 格式错误：缺少 --- 分隔符，或引号未关闭
Q：AI 没有自动调用我装好的 Skill
→ 两步排查：输入 / 检查 Skill 是否出现 + 询问 AI"你什么时候会用这个 Skill"
Q：Skill 触发太频繁，影响不相关任务
→ 在 description 中加入负向说明："Do NOT use for simple data queries"
Q：Skill 加载了但 AI 没有按步骤执行
→ 可能原因：指令过于冗长、语言描述模糊
→ 修复：用脚本替代语言描述（代码是确定的，语言存在解读偏差）
Q：Skill 有多少数量限制？
→ 产品层面没有数量限制。实际上限由上下文窗口决定，但由于 Skill 只加载 meta data，通常可以同时携带大量 Skill（建议不超过 20-50 个同时启用）
Q：一个 Skill 能不能调用另一个 Skill？
→ 可以。由于所有 Skill 的 meta data 都在 Agent 的上下文中，一个 Skill 执行过程中可以自然地触发另一个。
Q：Skill 里的 reference 文件越大越好吗？
→ 不是。建议 SKILL.md 控制在 5000 词以内，大型文档放 references/ 并在正文中引用路径。
十二、最小闭环实践路径：现在就开始
第 1 步（5 分钟）：安装一个开源 Skill
→ npx skills add from-design → 选择 Qoder，选择 Global，选择 copy 模式
第 2 步（5 分钟）：测试是否生效
→ 在 Qoder Quest 模式中，输入一个前端设计需求，观察 AI 是否自动调用 from-design Skill
第 3 步（10 分钟）：修改这个 Skill 的 description
→ 打开 ~/.qoder/skills/from-design/SKILL.md，在 description 中加一句符合你实际场景的触发词，重启会话再次测试
第 4 步（10 分钟）：为你的团队写第一个 Skill
→ mkdir -p .qoder/skills/my-first-skill && touch .qoder/skills/my-first-skill/SKILL.md
→ 填写 name、description 和执行步骤，git commit 提交
十三、附录：YAML Frontmatter 速查表 + 完整 Checklist
Frontmatter 完整速查：
--- # ✅ 必填
name: skill-name-in-kebab-case
description: | [做什么] + [什么时候用，含触发词] 不超过 1024 字符，不含 XML 尖括号
# 🔧 可选
license: MIT
allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch"
metadata:
  author: Your Name / Team
  version: 1.0.0
  mcp-server: server-name
  category: productivity
  tags: [tag1, tag2]
  documentation: https://your-docs.com
  support: support@company.com
---
资源链接：
开放 Skill 市场：https://skills.sh
Anthropic 官方 Skill 示例库：github.com/anthropics/skills
Qoder 官方文档：Qoder 官网 → 文档 → 扩展能力
本文参考 Anthropic 官方《The Complete Guide to Building Skills for Claude》