Qoder Skills 上手与实战：把 AI 从“会聊”变成“按标准做事”

开发技术
1

这篇文章讲清了 Qoder Skills 的原理、写法和实战，核心是把 AI 使用经验沉淀成可复用流程。

原文标题：Qoder Skills 完全指南：从零开始，让 AI 按你的标准执行

原文作者：阿里云开发者

冷月清谈：

文章围绕 Qoder Skills 的概念、结构、适用场景和落地方法，系统说明如何把 AI 能力沉淀为可复用的标准化工作流。核心观点是：Skill 本质上像“菜谱”，用于告诉 AI 在什么场景下、按什么步骤完成任务；MCP 更像“工具和食材”，Rules 是全局约束，Slash Command 则偏一次性快捷操作。

文章重点解释了 Skill 的文件结构与三级渐进式加载机制：前置的 YAML 元数据用于判断是否触发，SKILL.md 提供完整执行流程，scripts、references、assets 等资源按需读取。这种设计既节省上下文和推理成本，也提高了结果稳定性。

在能力边界上，文章对比了 Skill、MCP、Rules、Slash Command 的差异，并给出简单判断法则：需要外部系统就用 MCP，需要长期复用的标准流程优先写成 Skill。适合写成 Skill 的任务主要包括文档/资产生成、重复性工作流自动化，以及为 MCP 增加更具体的执行规范。

实操部分涵盖 Skill 的安装方式、验证方法、常见报错、测试思路和团队协作建议，还给出视频生成、前端设计优化、API 开发规范化等案例。文章尤其强调 description 的写法，它直接影响 Skill 的触发准确率；同时建议通过脚本、版本管理和项目级目录，把个人经验沉淀为团队可共享的 AI 工程资产。

怜星夜思：

1、问题1：如果团队已经有一堆提示词模板和 Slash Command 了，还有必要再投入时间做 Skill 吗？值不值？
2、问题2：文章里一直强调 description 是触发关键，你觉得一个 Skill 触发不准，究竟是 AI 的问题，还是设计者的问题更多？
3、问题3：Skill 把经验流程固化下来，确实能提效，但会不会也带来“过度标准化”，反而限制创新？
4、问题4：你觉得 Skill 这种做法，未来会主要是开发者在用，还是会扩展到产品、运营、设计这些非技术岗位？

原文内容

阿里妹导读


文章内容基于作者个人技术实践与独立思考，旨在分享经验，仅代表个人观点。

在 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/           ← 文件夹名用 kebab-case（小写+短横线）
├── 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？三大使用场景

根据 Anthropic 官方总结，Skill 最适合以下三类场景：

场景一：文档与资产创建（Document & Asset Creation）

适合人群：运营、产品、设计、所有人

核心特征：需要生成符合特定风格、规范或品牌标准的输出物

典型案例：

  • 给产品制作宣传视频（Remotion Best Practice Skill）

  • 生成高质量前端界面（frontend-design Skill）

  • 按公司模板生成 Word/PPT/Excel 文档

  • 制作符合设计规范的海报或社交媒体图文

为什么用 Skill：你不熟悉该领域，无法指导 AI 达到专业标准。Skill 携带了该领域的最佳实践，让 AI 直接按专家标准执行。

场景二：工作流自动化（Workflow Automation）

适合人群：开发、技术管理者、任何有重复性工作的人

核心特征：多步骤流程，期望每次输出结果一致

典型案例：

  • 每次新增 API 后自动同步文档 + 兼容性检查 + 单元测试框架

  • 代码提交前自动执行 Code Review 规范

  • 按固定模板生成项目进展报告

为什么用 Skill：

  • 重复动作脚本化 → 不遗漏任何步骤

  • 不依赖 AI 每次"想起来"提醒 → 结果确定

  • 将步骤固化到文件 → 减少 token 消耗，降低成本

场景三：MCP 能力增强（MCP Enhancement）

适合人群：已经连接了 MCP 的开发者、技术团队

核心特征：有了工具访问权限，但缺乏"怎么用好"的工作流知识

典型案例：

  • 连接了 Linear MCP，但每次都要解释 Sprint 规划流程 → 写一个 Skill 固化这套流程

  • 连接了 GitHub MCP，但代码审查没有标准 → 写一个 Skill 定义审查步骤

为什么用 Skill：

  • MCP 解决"AI 能做什么"（工具访问）

  • Skill 解决"AI 应该怎么做"（工作流知识）

  • 两者结合，用户无需每次从头解释，AI 自动按最佳实践执行

五、安装你的第一个开源 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 模式，无需额外依赖

💡 这个命令还有一个隐藏优势：它会为不同的 Agent 创建软链接，让多个工具共用同一份 Skill 文件，避免重复维护。

方式 B：手动放置文件

直接将 Skill 文件夹复制到以下目录：

# 用户级（全局生效）
~/.qoder/skills/

项目级（项目内生效，推荐团队规范）


<项目根目录>/.qoder/skills/

方式 C：在 Qoder Quest 模式中用内置 Skill 生成

Qoder Quest 模式内置了一个 create skill 元技能。直接对话：

帮我创建一个 Skill，用于 [描述你的需求]

AI 会引导你完成所有步骤，并自动放置到正确目录。

验证安装是否成功

在 Qoder 对话框输入 /，如果安装的 Skill 出现在联想列表中，说明安装成功。

或者直接在 Quest 模式中输入与该 Skill 匹配的任务，观察 AI 是否自动识别并调用。

⚠️ 注意：目前 Qoder Skills 不支持热更新，安装或修改 Skill 后，需要重启会话才能生效。

六、三大实战场景演示

场景 A：用 Skill 制作产品宣传视频（适合运营/产品）

背景：不懂视频制作，想为产品生成一个可下载的宣传视频文件。

无 Skill 时的困境：AI 给你三个不满意的方案——用 Python 库、纯 HTML 动画、或只生成素材，都不是你想要的。

操作步骤：

# 第一步：安装 Remotion Best Practice Skill
npx skills add remotion-best-practice
# 选择 Qoder，选择 Global，选择 copy 模式

第二步：在 Qoder Quest 模式中输入


帮我为 [产品名] 制作一个中文宣传视频，请先访问官网了解产品特性。

AI 执行流程：

1.自动识别并加载 Remotion Skill

2.访问官网，了解产品背景

3.按 Skill 的最佳实践搭建 Remotion 工程（自动处理 npm 环境）

4.生成分页视频脚本，渲染成视频文件

后续可继续提需求：更换配色匹配官网、替换为官网 Logo、增加 3D 效果……

场景 B：有 Skill 与无 Skill 的前端设计对比（适合所有人）

背景：用 AI 做了一个 Todo 网站，输出是典型的"AI 味"——蓝白配色、Inter 字体、毫无设计感。

无 Skill 时：你想改善但不知道怎么提需求，反复说"再好看一点"毫无效果。

安装 from-design Skill：

npx skills add from-design

同样的需求，有 Skill 后 AI 会：

1.首先确认设计方向（这是无 Skill 时根本不会问的环节）

2.选择独特字体搭配、非常规色彩方案、有格调的布局

3.输出具有审美一致性的完整设计

核心洞察：Skill 填补了你的"知识盲区"。你不知道怎么提设计需求，但 Skill 知道——它把设计领域的最佳实践打包进来，让 AI 按专家标准执行。

场景 C：规范化 Java 工程的 API 开发（适合开发/技术管理）

背景：团队规定新增 API 必须同步文档、做兼容性检查、写单元测试，但 AI 默认只写代码，经常遗漏。

Step 1：在 Quest 模式中生成 Skill

帮我创建一个 Skill，要求：
在创建、修改、删除 API 接口时，必须完成：
1. 同步更新 OpenAPI 格式的 API 文档
2. 检查新接口不破坏现有接口的兼容性
3. 生成对应的单元测试框架
4. 以 change log 格式记录本次变更

Step 2：强化 Skill——加入确定性脚本

在这个 Skill 中，添加一个 Python 脚本，
用于扫描项目内所有 API 接口，
检查是否每个接口都有对应的文档。
结果以报告形式输出。

AI 会在 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
# 团队成员 git pull 后立即生效

七、动手编写你自己的 Skill（含官方规范）

完整文件格式

---
name: your-skill-name
description: |
  [说明这个 Skill 做什么] + [说明什么时候使用它，含触发词]
  例如：当用户需要新增、修改或删除 API 接口时，
  或说到"接口文档"、"兼容性检查"、"单元测试"时，使用本 Skill。
license: MIT
metadata:
  author: 你的名字或团队
  version: 1.0.0
---

目标


[一句话描述这个 Skill 要实现什么]


执行步骤


第一步：[具体行动]


[清晰说明做什么，怎么做]


# 如需执行脚本，明确给出命令
python scripts/check_api_docs.py --project-id PROJECT_ID
期望输出：[描述成功时看到什么]

### 第二步：[具体行动]
[继续...]
示例
示例 1：[常见场景]
用户说："新增一个用户登录接口"
AI 执行步骤：
1. 创建接口代码
2. 在 OpenAPI 文档中添加对应条目
3. 检查是否与现有认证接口兼容
4. 生成 JUnit 测试框架
错误处理
错误：[常见错误信息]
● 原因：[为什么发生]
● 解决：[怎么修复]

</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>参考资料</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>详见&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>references/api-guide.md</span></span></span></code><span data-wct-cr-37></span></p></li>
 </ul>
 <div>
  <pre><code>---

### YAML Frontmatter 详解（最重要的部分）

Frontmatter 是 AI 决定"是否调用这个 Skill"的唯一依据。

**必填字段**

```yaml
---
name: api-standard-check &nbsp; &nbsp; # 必须是 kebab-case，小写+短横线
description: | &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; # 必须同时包含"做什么"和"何时用"
&nbsp; 当开发者新增、修改或删除 API 接口时，自动执行本 Skill，
&nbsp; 完成 API 文档同步、向后兼容性检查和单元测试框架生成。
&nbsp; 触发词：接口文档、API 规范、兼容性、单元测试、接口变更。
---
</code></pre>
 </div>
 <h5><span><span data-wct-cr-42><span>可选字段（完整版）</span></span></span></h5>
 <div>
  <pre><code>---
name: api-standard-check
description: |
&nbsp; [必填，1024字以内，无 XML 尖括号]
license: MIT
metadata:
&nbsp; author: 栗子团队
&nbsp; version: 1.0.0
&nbsp; mcp-server: github &nbsp; &nbsp; &nbsp; &nbsp;# 如果配合某个 MCP 使用，注明名称
&nbsp; category: development
&nbsp; tags: [api, documentation, testing]
&nbsp; documentation: https://your-docs-url.com
---
</code></pre>
 </div>
 <h5><span><span data-wct-cr-42><span data-wct-cr-42><span>禁止事项</span></span></span></span></h5>
 <div>
  <pre><code># ❌ 禁止在 frontmatter 中使用 XML 尖括号
description: Use&nbsp;for&nbsp;&lt;important&gt; cases &nbsp;# 错误！

# ❌ 禁止 name 中含 "claude" 或 "anthropic"（保留词）
name: claude-helper &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;# 错误！

# ❌ 禁止 name 有空格或大写
name: My Cool Skill &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;# 错误！
name:&nbsp;my-cool-skill &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;# ✅ 正确
</code></pre>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>写好 Description 的三个黄金原则</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Description 是 Skill 的"触发器"，决定 AI 在什么时候调用它。</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>原则一：同时说明"做什么"和"什么时候用"</span></span></span></p>
 <div>
  <pre><code># ❌ 太模糊
description: 帮助处理项目。

# ❌ 只说做什么，没有触发条件
description: 创建复杂的多页面文档系统。

# ✅ 好的示例
description: |
&nbsp; 分析 Figma 设计文件并生成开发交付文档。
&nbsp; 当用户上传 .fig 文件、说到"设计规范"、
&nbsp;&nbsp;"组件文档"或"设计转代码"时使用。
</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>原则二：包含用户实际会说的话（触发词）</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>用户一般不会说专业术语，要预测他们的自然语言：</span></span></span></p>
 <div>
  <pre><code>description: |
&nbsp; 管理 Linear 项目工作流，包括 Sprint 规划、任务创建和状态跟踪。
&nbsp; 当用户提到"冲刺"、"Linear 任务"、"项目计划"，
&nbsp; 或要求"创建工单"时触发。
</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>原则三：控制长度，不超过 1024 字符</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Frontmatter 会被加载到系统提示词中，过长会占用上下文。2-4 句话即可，核心信息优先。</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>正文写作的四个技巧</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>1.</span><span data-wct-cr-33>用第三人称描述步骤</span></span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>"当被触发时，AI 需要先……"</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;而非&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>"你要……"</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>，便于阅读和修改</span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>2.</span><span data-wct-cr-33>步骤编号化</span></span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>每步只做一件事，AI 不会跳过或混淆顺序</span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>3.</span><span data-wct-cr-33>关键验证前置</span></span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>把最重要的检查放在最前面，用&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>## 重要</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;或&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>CRITICAL:</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;标注</span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>4.</span><span data-wct-cr-33>引用胜过嵌入</span></span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>复杂文档放在&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>references/</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;中，主文件只写引用路径，保持 SKILL.md 在 5000 词以内</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-23>
   <div data-wct-cr-24>
    <p data-wct-cr-25><span>八、五大进阶模式：让 Skill 处理复杂工作流</span></p>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>以下五种模式来自 Anthropic 官方总结的实践经验，适合需要处理更复杂场景的用户。</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>模式一：顺序工作流编排</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>适用</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>需要严格按顺序执行的多步流程</span></span></span></p>
 <div>
  <pre><code>## 工作流：新客户接入

### 第一步：创建账户
调用 MCP 工具：`create_customer`
参数：姓名、邮箱、公司名

### 第二步：设置支付方式
调用 MCP 工具：`setup_payment`
等待：支付方式验证完成

### 第三步：创建订阅
调用 MCP 工具：`create_subscription`
依赖参数：来自第一步的 customer_id

### 第四步：发送欢迎邮件
调用 MCP 工具：`send_email`
模板：welcome_email_template

</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>关键技巧</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>明确步骤依赖关系、在每步加验证、提供失败时的回滚指令。</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>模式二：跨 MCP 协调</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>适用</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>工作流跨越多个外部服务</span></span></span></p>
 <div>
  <pre><code>## 设计转开发交付流程

### 阶段一：Figma 导出（Figma MCP）
1.&nbsp;导出设计资产
2.&nbsp;生成设计规范文档
3.&nbsp;创建资产清单

### 阶段二：文件存储（Drive MCP）
1.&nbsp;创建项目文件夹
2.&nbsp;上传所有资产
3.&nbsp;生成分享链接

### 阶段三：任务创建（Linear MCP）
1.&nbsp;创建开发任务
2.&nbsp;将资产链接附到任务
3.&nbsp;分配给工程团队

### 阶段四：通知（Slack MCP）
1.&nbsp;在 #engineering 频道发布交付摘要
2.&nbsp;包含资产链接和任务引用

</code></pre>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>模式三：迭代优化循环</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>适用</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>需要多轮优化才能达到质量标准的输出</span></span></span></p>
 <div>
  <pre><code>## 报告生成流程

### 初稿生成
1.&nbsp;通过 MCP 获取数据
2.&nbsp;生成第一版报告
3.&nbsp;保存到临时文件

### 质量检查
1.&nbsp;运行验证脚本：`scripts/check_report.py`
2.&nbsp;检查项：缺失章节 / 格式不一致 / 数据错误

### 优化循环
1.&nbsp;逐项修复检查出的问题
2.&nbsp;重新生成受影响的章节
3.&nbsp;再次验证
4.&nbsp;重复直到通过质量标准

### 最终输出
1.&nbsp;应用最终格式
2.&nbsp;生成摘要
3.&nbsp;保存正式版本
</code></pre>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>模式四：上下文感知的工具选择</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>适用</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>同一个目标，根据文件类型或场景选择不同工具</span></span></span></p>
 <div>
  <pre><code>## 智能文件存储

### 决策树
1. 检查文件类型和大小
2. 选择最佳存储位置：
&nbsp; &nbsp;- 大文件（&gt;10MB）→ 云存储 MCP
&nbsp; &nbsp;- 协作文档 → Notion/Google Docs MCP
&nbsp; &nbsp;- 代码文件 → GitHub MCP
&nbsp; &nbsp;- 临时文件 → 本地存储

### 执行存储
根据决策调用对应 MCP 工具，
并向用户说明选择该存储方式的原因。
</code></pre>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>模式五：领域专业知识内嵌</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>适用</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>需要将复杂的合规规则、行业知识内嵌到工作流中</span></span></span></p>
 <div>
  <pre><code>## 支付处理合规流程

### 处理前（合规检查）
1.&nbsp;获取交易详情（MCP）
2.&nbsp;应用合规规则：
&nbsp; &nbsp;- 检查制裁名单
&nbsp; &nbsp;- 验证司法管辖权
&nbsp; &nbsp;- 评估风险等级
3.&nbsp;记录合规决策

### 执行处理
IF 合规通过：
&nbsp; - 调用支付处理 MCP
&nbsp; - 执行欺诈检测
&nbsp; - 完成交易
ELSE：
&nbsp; - 标记待人工审核
&nbsp; - 创建合规案例

### 审计记录
-&nbsp;记录所有合规检查过程
-&nbsp;生成审计报告
</code></pre>
 </div>
 <p data-wct-cr-19><span data-wct-cr-20><br></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-23>
   <div data-wct-cr-24>
    <p data-wct-cr-25><span>九、测试与迭代：让 Skill 越来越准</span></p>
   </div>
  </div>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>三类测试，覆盖 Skill 生命周期</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>测试一：触发测试（最关键）</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>目标：确保 Skill 在正确的时机加载，不该加载时不加载。</span></span></span></p>
 <div>
  <pre><code>✅ 应该触发的测试用例（至少&nbsp;10&nbsp;个）：
-&nbsp;"帮我新增一个用户登录接口"
-&nbsp;"这个 API 和现有接口会不会冲突"
-&nbsp;"帮我写接口文档"

❌ 不应该触发的测试用例：
-&nbsp;"帮我写一首诗"
-&nbsp;"旧金山的天气怎么样"
-&nbsp;"帮我做个 PPT"

</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>快速诊断法</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>：</span><span data-wct-cr-21>直接问 AI：</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>"你什么时候会用 [skill-name] 这个 Skill？"</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;AI 会复述你的 description，根据复述结果判断是否需要调整描述。</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>测试二：功能测试</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>运行同一个请求 3-5 次，检查：</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>输出结果是否一致</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>API 调用是否成功（0 错误为目标）</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>关键步骤是否都完成（无遗漏）</span></span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>测试三：与无 Skill 基线对比</span></span></span></p>
 <table>
  <tbody>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>指标</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>无 Skill</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>有 Skill</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>改善</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>用户需要提供的说明</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>每次都要解释</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>无需解释</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>✅</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>来回对话轮次</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>15 轮</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>2 轮</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>✅</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>API 调用失败次数</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>3 次</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>0 次</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>✅</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Token 消耗</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>12,000</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>6,000</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>✅</span></span></span></p></td>
   </tr>
  </tbody>
 </table>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>根据反馈信号迭代</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>信号：Skill 没有自动调用（触发不足）</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>问题：description 太模糊，或缺少用户实际会说的触发词</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>修复：在 description 中添加更多具体触发短语，包括技术术语和口语表达</span></span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>信号：Skill 总是莫名被调用（过度触发）</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>问题：description 太宽泛</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>修复：加入负向说明，例如：</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>"Do NOT use for simple data queries (use data-viz skill instead)"</span></span></span></code><span data-wct-cr-37></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>信号：Skill 被调用了但 AI 没按步骤执行</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>问题：指令太冗长或模糊</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>修复：缩短正文，关键步骤前置，考虑用脚本替代语言描述（脚本是确定的，语言描述存在解读偏差）</span></span></span></span></p></li>
 </ul>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>动态优化：用自然语言修改 Skill</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <div>
  <pre><code>你刚才的输出中，[具体描述问题]。
请把这个改进固化到&nbsp;[skill-name]&nbsp;这个 Skill 文件中，
下次遇到同样情况时直接按新方式处理。
</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>这是 Skill 区别于 Slash Command 的核心优势：</span></span></span><span><span data-wct-cr-20><span data-wct-cr-33>Skill 是活文档，每次修正都可以沉淀，减少下次犯同样错误的概率。</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-23>
   <div data-wct-cr-24>
    <p data-wct-cr-25><span>十、团队协作与 Skill 治理</span></p>
   </div>
  </div>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>两级安装策略</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <table>
  <tbody>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>级别</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>路径</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>适用场景</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>用户级（全局）</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span data-wct-cr-37></span><code><span><span data-wct-cr-20><span data-wct-cr-38>~/.qoder/skills/</span></span></span></code><span data-wct-cr-37></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>个人偏好、跨项目通用（如个人设计风格偏好）</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>项目级</span></span></span></p></td>
    <td>
     <p data-wct-cr-39><span data-wct-cr-37></span><code><span><span data-wct-cr-20><span data-wct-cr-38>&lt;项目根&gt;/.qoder/skills/</span></span></span></code><span data-wct-cr-37></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>团队规范、项目特定流程（推荐提交到 Git）</span></span></span></p></td>
   </tr>
  </tbody>
 </table>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>Git 协作最佳实践</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <div>
  <pre><code># 1. 将项目级 Skill 纳入版本控制
git add .qoder/skills/
git commit -m&nbsp;"feat: add api-standard skill v1.0"
git push

# 2. 团队成员拉取后立即生效，无需额外操作
git pull

# 3. 更新 Skill 时写清楚变更内容
git commit -m&nbsp;"fix(skill/api-standard): 增加对 DELETE 接口的兼容性检查"
</code></pre>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>Skill 版本管理建议</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>在&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>metadata</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;中维护版本号，重大变更在&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>references/CHANGELOG.md</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;中记录：</span></span></span></p>
 <div>
  <pre><code>metadata:
&nbsp;&nbsp;version:&nbsp;1.2.0
&nbsp;&nbsp;author: 栗子团队
</code></pre>
 </div>
 <p data-wct-cr-19><span data-wct-cr-20><span data-wct-cr-21>对于 breaking change（会改变 AI 行为的变更），在 description 中注明，并在团队群里发布通知。</span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>组织级 Skill 部署</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>如果你的公司使用 Claude 企业版，管理员可以在工作区级别统一部署 Skill，所有成员自动获得，并可集中管理版本更新（2025 年 12 月已上线此功能）。</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-23>
   <div data-wct-cr-24>
    <p data-wct-cr-25><span>十一、常见问题排查 FAQ</span></p>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：Skill 上传失败，提示 "Could not find SKILL.md"</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>检查文件名是否严格为&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>SKILL.md</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>（区分大小写）。</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>skill.md</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>、</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>SKILL.MD</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;都不行。</span></span></span></p>
 <div>
  <pre><code>ls&nbsp;-la your-skill-folder/ &nbsp;&nbsp;
# 应该看到 SKILL.md
</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：上传失败，提示 "Invalid frontmatter"</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>最常见的 YAML 格式错误：</span></span></span></p>
 <div>
  <pre><code># ❌ 缺少 --- 分隔符
name: my-skill
description: Does things

# ❌ 引号未关闭
description: "Does things

# ✅ 正确格式
---
name: my-skill
description: Does things
---
</code></pre>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：AI 没有自动调用我装好的 Skill</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>两步排查：</span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>1.输入&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>/</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;检查 Skill 是否出现在联想列表（确认安装成功）</span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>2.询问 AI：</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>"你什么时候会用 [skill-name] 这个 Skill？"</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;根据回答判断 description 是否需要调整</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>临时解决：输入&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>/skill-name</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;手动调用，或在提示词中明确说"请使用 xxx Skill"。</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：Skill 触发太频繁，影响不相关任务</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>在 description 中加入负向说明：</span></span></span></p>
 <div>
  <pre><code>description: |
&nbsp; 用于 CSV 文件的高级数据分析（统计建模、回归分析、聚类）。
&nbsp; 不适用于简单数据查询（请使用 data-viz Skill）。
</code></pre>
 </div>
 <p data-wct-cr-19><span data-wct-cr-20><span data-wct-cr-41>Q：Skill 加载了但 AI 没有按步骤执行</span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>可能原因：</span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>1.指令过于冗长 → 精简正文，关键步骤前置</span></span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>2.语言描述模糊 → 用脚本替代语言描述（代码是确定的，语言存在解读偏差）</span></span></span></span></p>
 <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>3.添加明确提醒：在关键步骤前加&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>CRITICAL:</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;或&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>## 重要</span></span></span></code><span data-wct-cr-37></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：Skill 有多少数量限制？</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>产品层面没有数量限制。实际上限由上下文窗口决定，但由于 Skill 只加载 meta data，通常可以同时携带大量 Skill（建议不超过 20-50 个同时启用），远比 MCP 节省资源。</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：一个 Skill 能不能调用另一个 Skill？</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>可以。由于所有 Skill 的 meta data 都在 Agent 的上下文中，一个 Skill 执行过程中可以自然地触发另一个。如有明确依赖，在 description 中注明（如"使用前请确保已安装 xxx Skill"）。</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：Skill 里的 reference 文件越大越好吗？</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>不是。建议：</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-38>SKILL.md</span></span></span></span><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;控制在 5000 词以内</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>大型文档放&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>references/</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;并在正文中引用路径</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>核心步骤优先放在主文件，细节文档按需引用</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>可以引用外部网站链接，但要注意 token 消耗</span></span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>Q：我用 Slash Command 习惯了，切到 Skill 有什么优势？</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Slash Command 能做的，Skill 都能做（Skill 也可以&nbsp;</span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>/</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;调用）。但 Skill 还支持：引用脚本文件、内嵌资源、模块化分发、Git 版本管理、跨团队共享。对于任何超过 3-4 行的重复性指令，Skill 都是更好的选择。</span></span></span></p>
 <div data-wct-cr-22>
  <div data-wct-cr-23>
   <div data-wct-cr-24>
    <p data-wct-cr-25><span>十二、最小闭环实践路径：现在就开始</span></p>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>不要等"完全准备好"再行动。按以下四步，30 分钟内完成你的第一个 Skill 实践：</span></span></span></p>
 <div>
  <pre><code>第&nbsp;1&nbsp;步（5&nbsp;分钟）：安装一个开源 Skill
→ 打开终端，运行：
&nbsp; &nbsp; npx skills&nbsp;add&nbsp;from-design
→ 选择 Qoder，选择&nbsp;Global，选择&nbsp;copy&nbsp;模式

第&nbsp;2&nbsp;步（5&nbsp;分钟）：测试是否生效
→ 在 Qoder Quest 模式中，输入一个前端设计需求
→ 观察 AI 是否自动调用&nbsp;from-design Skill
→ 如果没有，输入 "/from-design" 手动调用

第&nbsp;3&nbsp;步（10&nbsp;分钟）：修改这个 Skill 的 description
→ 打开&nbsp;~/.qoder/skills/from-design/SKILL.md
→ 在 description 中加一句符合你实际场景的触发词
→ 重启会话，再次测试

第&nbsp;4&nbsp;步（10&nbsp;分钟）：为你的团队写第一个 Skill
→ 在项目目录下：
&nbsp; &nbsp; mkdir&nbsp;-p .qoder/skills/my-first-skill
&nbsp; &nbsp; touch .qoder/skills/my-first-skill/SKILL.md
→ 填写 name、description 和执行步骤
→ git&nbsp;commit&nbsp;提交，通知团队成员拉取
</code></pre>
 </div>
 <blockquote>
  <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-34>别等完美，先让第一个 Skill 在你本地跑起来。你的 AI 工程化能力，就从这一次点击真正启程。</span></span></span></p>
 </blockquote>
 <div data-wct-cr-22>
  <div data-wct-cr-23>
   <div data-wct-cr-24>
    <p data-wct-cr-25><span>十三、附录：YAML Frontmatter 速查表 + 完整 Checklist</span></p>
   </div>
  </div>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>Frontmatter 完整速查</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <div>
  <pre><code>---
# ✅ 必填
name: skill-name-in-kebab-case
description: |
&nbsp; [做什么] + [什么时候用，含触发词]
&nbsp; 不超过 1024 字符，不含 XML 尖括号

# 🔧 可选
license: MIT
allowed-tools: "Bash(python:*) Bash(npm:*) WebFetch"
metadata:
&nbsp; author: Your Name / Team
&nbsp; version: 1.0.0
&nbsp; mcp-server: server-name &nbsp; &nbsp; &nbsp; &nbsp;# 配合哪个 MCP 使用
&nbsp; category: productivity
&nbsp; tags: [tag1, tag2]
&nbsp; documentation: https://your-docs.com
&nbsp; support: support@company.com
---
</code></pre>
 </div>
 <div data-wct-cr-22>
  <div data-wct-cr-26>
   <div data-wct-cr-27>
    <div data-wct-cr-28>
     <div data-wct-cr-29>
     </div>
    </div>
   </div>
   <div data-wct-cr-30>
    <div data-wct-cr-31>
     <p data-wct-cr-12><span data-wct-cr-32><strong><span>上线前完整 Checklist</span></strong></span></p>
    </div>
   </div>
  </div>
 </div>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>开始之前</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 确定了 2-3 个具体使用场景</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 明确了需要用到哪些工具（内置 or MCP）</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 规划了文件夹结构</span></span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>开发过程中</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 文件夹名是 kebab-case（无空格、无大写）</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 主文件名是&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>SKILL.md</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>（大小写完全正确）</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] YAML frontmatter 有&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>---</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;开头和结尾</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ]&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>name</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;字段：kebab-case，无空格，无大写</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ]&nbsp;</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>description</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>&nbsp;包含"做什么"和"何时用"两部分</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] description 不含 XML 尖括号（</span></span></span></span><code><span><span data-wct-cr-20><span data-wct-cr-38>&lt; &gt;</span></span></span></code><span><span data-wct-cr-20><span data-wct-cr-21>）</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 正文步骤清晰，每步只做一件事</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 关键步骤有错误处理说明</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 包含 1-2 个示例场景</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] References 已清晰链接（不要内联大段文档）</span></span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>测试阶段</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 用 10 个相关请求测试触发（目标：90% 自动触发）</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 用 5 个不相关请求测试（不应触发）</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 功能测试：重复运行同一任务，结果一致</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] MCP 集成测试（如适用）：API 调用 0 失败</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 与无 Skill 基线对比，记录改善数据</span></span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-41>发布之后</span></span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 收集用户反馈</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 监控触发率（过多/过少）</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 定期迭代更新 description 和步骤</span></span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span><span data-wct-cr-20><span data-wct-cr-21>[ ] 更新 metadata 中的 version 字段</span></span></span></span></p></li>
 </ul>
 <h4><span><span data-wct-cr-20><span data-wct-cr-21>资源链接</span></span></span></h4>
 <table>
  <tbody>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>资源</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>地址</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>说明</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>开放 Skill 市场</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>https://skills.sh</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>当前最流行的开放 Skill 市场</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Anthropic 官方 Skill 示例库</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>github.com/anthropics/skills</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>官方示例，可直接 fork 修改</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Qoder 官方文档</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Qoder 官网 → 文档 → 扩展能力</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Skills 安装指南</span></span></span></p></td>
   </tr>
   <tr>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>Qoder 中文 Skill 社区</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>即将上线</span></span></span></p></td>
    <td>
     <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>中英双语，按角色分类</span></span></span></p></td>
   </tr>
  </tbody>
 </table>
 <p data-wct-cr-39><span><span data-wct-cr-20><span data-wct-cr-21>本文参考 Anthropic 官方《The Complete Guide to Building Skills for Claude》</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>关于作者</span></span></span></p>
 <p data-wct-cr-43><span><span data-wct-cr-20><span data-wct-cr-44>Heaven</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-45>阿里国际 AI 业务运营专家 &nbsp;</span></span></span><span></span></p>
 <ul>
  <li>
   <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>10年+海外业务经验，熟悉海外流量生态</span></span></span></p></li>
  <li>
   <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>阿里国际AI产品增长负责人，从 0 到 1 操盘 Pic Copilot（出海 AI 电商设计产品，100w+ 电商用户）的GTM和用户增长——Product Hunt 冷启动、SEO / SEM、社媒营销，探索&amp;跑通AI时代增长新范式</span></span></span></p></li>
 </ul>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-33>🔭 当前在做</span></span></span></p>
 <p data-wct-cr-19><span><span data-wct-cr-20><span data-wct-cr-21>正在深入探索 AI 海外内容营销系统的搭建与落地 （Claude ， QoderWork， Openclaw），通过内容+AI杠杆撬动业务流量增长 。非常欢迎同在这个方向上探索的朋友一起交流。</span></span></span></p>
 <p data-wct-cr-46></p>
</div>
    </div>
</div>
2

【回答问题1】我觉得值不值，关键看任务是不是“重复且容易漏步骤”。如果只是偶尔用一下的短提示词，Slash Command 就够了；但只要涉及文档同步、检查、测试、审查这种多步骤流程，Skill 的收益会越来越明显。它不是单纯把提示词变长，而是把流程、脚本、引用资料都变成长期资产。前期多花一点时间，后面能少很多口头对齐成本。

3

【回答问题3】我反而觉得，很多团队不是“过度标准化”，而是“连能复用的标准都没有”，大家都在重复踩坑。先把容易出错、容易遗漏的部分收进 Skill，省下来的脑力再去搞创新，这才比较划算。别一上来就担心被框死，现实通常是还没框，已经先乱了。

4

【回答问题3】这是个很真实的问题。任何标准化工具都可能在提升效率的同时压缩探索空间。我的看法是，Skill 更适合用于“底线要求明确”的环节，比如合规检查、接口文档同步、测试框架生成；而在创意探索、方案发散、产品策略讨论这类任务上，不应该把 Skill 设计得过于刚性。标准化和创新并不冲突，关键在于边界划分。