在 VS Code 中使用 Agent Skills - 官方文档

---
name: webapp-testing
description: Guide for testing web applications using Playwright. Use this when asked to create or run browser-based tests.
---

# Web Application Testing with Playwright

This skill helps you create and run browser-based tests for web applications using Playwright.

## When to use this skill

Use this skill when you need to:
- Create new Playwright tests for web applications
- Debug failing browser tests
- Set up test infrastructure for a new project

## Creating tests

1. Review the [test template](./test-template.js) for the standard test structure
2. Identify the user flow to test
3. Create a new test file in the `tests/` directory
4. Use Playwright's locators to find elements (prefer role-based selectors)
5. Add assertions to verify expected behavior

## Running tests

```bash
npx playwright test

npx playwright test --debug

## 使用 Skills 作为斜杠命令

Skills 在聊天中作为斜杠命令可用。输入 `/` 查看可用 skills 和 prompts 列表。

可以添加额外上下文，例如：
- `/webapp-testing for the login page`
- `/github-actions-debugging PR #42`

通过 `user-invokable` 和 `disable-model-invocation` 属性控制访问方式：

| 配置 | 斜杠命令 | Copilot 自动加载 | 使用场景 |
|------|---------|-----------------|---------|
| 默认（省略两者） | 是 | 是 | 通用 skills |
| `user-invokable: false` | 否 | 是 | 背景知识 skills |
| `disable-model-invocation: true` | 是 | 否 | 仅按需运行 |
| 两者都设置 | 否 | 否 | 禁用 skills |

## Copilot 如何使用 Skills

Skills 使用渐进式披露机制，仅在需要时加载内容，三级加载系统确保可安装多个 skills 而不消耗上下文：

**Level 1: Skill 发现**
Copilot 始终通过读取 YAML frontmatter 中的 `name` 和 `description` 了解可用 skills。这些元数据轻量，帮助 Copilot 决定哪些 skills 与请求相关。

**Level 2: 指令加载**
当请求匹配 skill 的描述时，Copilot 将 `SKILL.md` 文件主体加载到上下文中。也可通过 `/` 斜杠命令直接调用 skill。

**Level 3: 资源访问**
Copilot 仅在需要时访问 skill 目录中的其他文件（脚本、示例、文档）。这些资源直到 Copilot 引用它们时才会加载，保持上下文高效。

## 使用共享 Skills

可以使用他人创建的 skills 增强 Copilot 能力：

- [github/awesome-copilot](https://github.com/github/awesome-copilot) - 社区 skills 集合
- [anthropics/skills](https://github.com/anthropics/skills) - 参考 skills

**使用步骤：**
1. 浏览仓库中的可用 skills
2. 复制 skill 目录到 `.github/skills/` 文件夹
3. 根据需求审查和自定义 `SKILL.md`
4. 可选：修改或添加资源

> 提示：使用前务必审查共享 skills，确保符合需求和安全标准。

## 从扩展贡献 Skills

扩展可通过 `package.json` 中的 `chatSkills` 贡献点提供 skills：

```json
{
  "contributes": {
    "chatSkills": [
      {
        "path": "./skills/my-skill"
      }
    ]
  }
}

extension-root/
└── skills/
    └── my-skill/           # 目录名必须与 SKILL.md 中的 `name` 匹配
        └── SKILL.md        # 必需