Communitygithub.com

k6 測試技能

當使用者想要使用 k6 進行 API 和網站的負載測試、壓力測試或效能測試時使用。也適用於使用者提及「k6」、「負載測試」、「效能測試」、「壓力測試」、「突增測試」、「浸泡測試」、「閾值」、「虛擬使用者」或「VU」等關鍵字時。若涉及瀏覽器測試,請參考 selenium。

k6 測試技能 是什麼?

這是一項專注於 k6 開源負載測試工具的 AI 助手技能,旨在協助開發者撰寫 JavaScript 測試腳本、設定虛擬使用者(VU)與測試時長、配置通過/失敗條件的閾值,並分析測試結果。此技能支援多種平台(如 CLI 和 GitHub Actions),能夠處理常見的測試類型,包括負載測試、壓力測試、突增測試、浸泡測試和煙霧測試。它透過結構化腳本、自訂指標(如 Trend、Counter、Rate)以及進階場景(如混合流量模式)來提供清晰的測試架構。此外,技能還涵蓋了 CI/CD 整合(例如 GitHub Actions)和環境變數覆蓋等功能,幫助使用者將負載測試無縫整合到開發工作流程中,確保 API 和服務的效能與可靠性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TerminalSkills/skills/tree/HEAD/skills/k6

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

k6

概述

您是 k6 的專家,k6 是專為開發者打造的開源負載測試工具,旨在提升開發者的幸福感。您協助使用者用 JavaScript 撰寫 k6 測試腳本、設定虛擬使用者與測試時長、配置通過/失敗條件的閾值,並分析結果。您了解 k6 的執行模型、生命週期鉤子,以及如何將 k6 整合到 CI/CD 管道中。

操作說明

初步評估

在撰寫負載測試之前,請先了解:

  1. 目標 — 您正在測試哪個端點或服務?
  2. 目的 — 測試類型為何?(負載、壓力、突增、浸泡、煙霧)
  3. 期望 — 可接受的回應時間與錯誤率是多少?
  4. 規模 — 測試應模擬多少並發使用者?

撰寫 k6 腳本

始終使用清晰的階段和閾值來結構化腳本:

// load-test.js — 使用漸增虛擬使用者和閾值的 k6 負載測試。
// 測試 /api/users 端點在不斷增加的負載下的表現。
import http from 'k6/http';
import { check, sleep } from 'k6';

export const options = {
  stages: [
    { duration: '1m', target: 50 },
    { duration: '3m', target: 50 },
    { duration: '1m', target: 0 },
  ],
  thresholds: {
    http_req_duration: ['p(95)<500'],
    http_req_failed: ['rate<0.01'],
  },
};

export default function () {
  const res = http.get('https://api.example.com/users');
  check(res, {
    '狀態碼為 200': (r) => r.status === 200,
    '回應時間 < 500ms': (r) => r.timings.duration < 500,
  });
  sleep(1);
}

測試類型

引導使用者選擇正確的測試類型:

  • 煙霧測試 — 最低負載 (1-2 個 VU) 以驗證腳本是否正常運作
  • 負載測試 — 預期的正常與峰值負載
  • 壓力測試 — 超出正常容量以找出崩潰點
  • 突增測試 — 突然的流量激增
  • 浸泡測試 — 長時間執行以發現記憶體洩漏與效能衰退

閾值

始終建議設定閾值,以便測試有明確的通過/失敗條件:

// thresholds.js — k6 的常見閾值模式。
// 結合多個指標以實現全面的通過/失敗判斷。
export const options = {
  thresholds: {
    http_req_duration: ['p(95)<500', 'p(99)<1000'],
    http_req_failed: ['rate<0.01'],
    http_reqs: ['rate>100'],
    checks: ['rate>0.99'],
    'http_req_duration{name:login}': ['p(95)<800'],
  },
};

自訂指標

// custom-metrics.js — 在 k6 中追蹤業務特定的指標。
// 對於衡量 HTTP 回應時間以外的項目非常有用。
import { Trend, Counter, Rate } from 'k6/metrics';

const loginDuration = new Trend('login_duration');
const successfulLogins = new Counter('successful_logins');
const loginSuccessRate = new Rate('login_success_rate');

export default function () {
  const start = Date.now();
  const res = http.post('https://api.example.com/login', JSON.stringify({
    username: 'testuser',
    password: 'testpass',
  }), { headers: { 'Content-Type': 'application/json' } });

  loginDuration.add(Date.now() - start);
  const success = res.status === 200;
  successfulLogins.add(success ? 1 : 0);
  loginSuccessRate.add(success);
}

CI 整合

# .github/workflows/load-test.yml — 在 GitHub Actions 中執行 k6 負載測試。
# 如果違反閾值,則管道會失敗。
name: 負載測試
on:
  push:
    branches: [main]
jobs:
  k6:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: grafana/[email protected]
        with:
          filename: tests/load-test.js

執行 k6

# run-k6.sh — 適用於不同場景的常見 k6 命令。
# 安裝並使用各種輸出選項執行。

# 安裝
brew install k6

# 基本執行
k6 run load-test.js

# 使用環境變數
k6 run -e BASE_URL=https://staging.example.com load-test.js

# 覆蓋虛擬使用者數和持續時間
k6 run --vus 100 --duration 5m load-test.js

# 輸出為 JSON 以便分析
k6 run --out json=results.json load-test.js

進階場景

// scenarios.js — 同時執行多種不同模式的多個場景。
// 模擬真實的混合流量模式。
export const options = {
  scenarios: {
    browse: {
      executor: 'constant-vus',
      vus: 20,
      duration: '5m',
      exec: 'browsePage',
    },
    checkout: {
      executor: 'ramping-arrival-rate',
      startRate: 1,
      timeUnit: '1s',
      preAllocatedVUs: 50,
      stages: [
        { duration: '2m', target: 10 },
        { duration: '2m', target: 0 },
      ],
      exec: 'checkout',
    },
  },
};

export function browsePage() {
  http.get('https://api.example.com/products');
  sleep(2);
}

export function checkout() {
  http.post('https://api.example.com/checkout', JSON.stringify({ item: 'widget' }));
}

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

TerminalSkills/skills

>- Run GitHub Actions locally with act. Use when a user asks to test GitHub Actions workflows locally, debug CI pipelines without pushing, or run workflows offline.

TerminalSkills/skills

>- You are an expert in AG2 (formerly AutoGen), the open-source multi-agent conversation framework. You help developers build systems where multiple AI agents collaborate through structured conversations — with tool use, human-in-the-loop, code execution, group chat orchestration, and nested conversations — for complex tasks like software development, research, and data analysis.

TerminalSkills/skills

>- Generate short-form videos with AI — script writing, text-to-speech narration, stock footage selection, subtitle generation, and video assembly. Use when: creating TikTok/YouTube Shorts/Reels content, automating video production, building content pipelines.

TerminalSkills/skills

>- Animate 3D objects and characters in Blender with Python. Use when the user wants to keyframe properties, create armatures and rigs, set up IK/FK chains, animate shape keys for facial animation, edit F-Curves, use the NLA editor to blend actions, add drivers for expression-based animation, or script any animation workflow in Blender.

TerminalSkills/skills

>- Automate motion capture and tracking workflows in Blender with Python. Use when the user wants to import BVH or FBX mocap data, retarget motion to armatures, track camera or object motion from video, solve camera motion, clean up motion capture data, or script any tracking pipeline in Blender.

TerminalSkills/skills

>- You are an expert in Bolt.new by StackBlitz, the AI-powered full-stack development environment that runs entirely in the browser. You help developers go from idea to deployed app in minutes using natural language prompts — Bolt generates complete applications with frontend, backend, database, and deployment, all running in a WebContainer without local setup.

TerminalSkills/skills

>- Assists with using Bun as an all-in-one JavaScript/TypeScript runtime, package manager, bundler, and test runner. Use when building HTTP servers, managing packages, running tests, or migrating from Node.js. Trigger words: bun, bun serve, bun install, bun test, bun build, javascript runtime, bun runtime.

TerminalSkills/skills

>- Self-host customer support with Chatwoot. Use when a user asks to set up open-source customer support, add live chat without SaaS costs, build a multi-channel inbox, or deploy a free Intercom alternative.

TerminalSkills/skills

>- You are an expert in Chi, the lightweight, idiomatic Go HTTP router built on `net/http`. You help developers build composable HTTP services using Chi's middleware stack, route groups, URL parameters, sub-routers, and context-based request scoping — providing Express-like ergonomics while staying 100% compatible with Go's standard library.

TerminalSkills/skills

When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes.

TerminalSkills/skills

>- Add live chat and customer support with Crisp. Use when a user asks to add a chat widget, implement live customer support, set up a help desk, create a knowledge base, or add a chatbot to a website.

TerminalSkills/skills

>- Assists with building custom interactive data visualizations using D3.js. Use when creating charts, graphs, maps, force layouts, or hierarchical diagrams that require fine-grained control beyond what charting libraries provide. Trigger words: d3, data visualization, chart, svg, scales, force graph, treemap, choropleth.

TerminalSkills/skills

dbt (data build tool) transforms data in your warehouse using SQL SELECT statements. Learn project setup, models, tests, documentation, incremental materializations, and integration with data warehouses like PostgreSQL, BigQuery, and Snowflake.

TerminalSkills/skills

>- You are an expert in dlt, the open-source Python library for building data pipelines. You help developers load data from any API, file, or database into warehouses and lakes using simple Python decorators — with automatic schema inference, incremental loading, and built-in data contracts. dlt is the "requests library for data pipelines.

TerminalSkills/skills

Data Version Control for ML projects. Track large datasets and models alongside Git, build reproducible ML pipelines, and run experiments with metric comparison. Works with any storage backend including S3, GCS, Azure, and local filesystems.

TerminalSkills/skills

>- You are an expert in E2B, the cloud platform for running AI-generated code in secure sandboxes. You help developers give AI agents the ability to execute code, install packages, read/write files, and run long processes in isolated cloud environments — each sandbox is a lightweight VM that boots in ~150ms with full Linux, filesystem, and networking.

TerminalSkills/skills

>- Transcode, convert, edit, and process audio and video with FFmpeg. Use when a user asks to convert video formats (webm to mp4, mkv to mp4), extract audio from video, compress video files, trim or cut clips, concatenate videos, add subtitles, create thumbnails, apply filters, change resolution or bitrate, re-encode media, create GIFs from video, add watermarks, normalize audio, stream media, or build automated media processing pipelines.

TerminalSkills/skills

>- Create advanced animations with GSAP. Use when building complex timelines, scroll-driven animations, SVG morphing, text animations, or high-performance web animations beyond CSS capabilities.

TerminalSkills/skills

>- Generate deterministic MP4 videos from HTML, CSS, media, and seekable animations using HeyGen's HyperFrames framework. Use when someone asks to "render HTML to video", "make a video with HyperFrames", "create a programmatic video", "turn an animation into MP4", "build a launch/product video from HTML", "render GSAP/Lottie/Three.js to video", or set up an agent-driven video pipeline. Covers init/preview/render/add/lint/inspect commands, data-* timing attributes, animation adapters, and the component catalog.

TerminalSkills/skills

>- Lovable (formerly GPT Engineer) is a browser-based AI app builder that turns a natural-language description into a working full-stack web app with a built-in backend, authentication, database and one-click publishing. Use when the user wants to prototype or ship a web app with Lovable, write effective Lovable prompts, connect Supabase or GitHub, review generated security rules, or move a Lovable project into their own editor.

相關技能