本文へ移動
cccskills
無料GitHub で公開

stryker-mutation

Configures StrykerJS for mutation testing of JavaScript / TypeScript / React / Vue / Svelte / Node - picks the test-runner plugin (`@stryker-mutator/jest-runner`, `mocha-runner`, `vitest-runner`, `karma-runner`), authors `stryker.conf.json` with mutate globs + thresholds, runs incremental mode for PRs (only mutate changed files), and reports the mutation score. Use when a JS/TS test suite has ≥80% line coverage and the team wants to verify the tests actually catch bugs (not just touch lines).

日本語の概要は準備中です。原文の説明を表示しています。

testland/qaスター 13(GitHub 13 + cccskills 0)

実行スコア 未検証

インストール方法を見る

含まれるファイル(12)

  • SKILL.md6.7 KB
  • .tessl-plugin/plugin.json632 B
  • evals/eleven-packages-mandated-at-an-80-gate-by-quarter-end/criteria.json5.9 KB
  • evals/eleven-packages-mandated-at-an-80-gate-by-quarter-end/task.md9.7 KB
  • evals/generated-client-dragged-the-score-under-the-gate/criteria.json5.4 KB
  • evals/generated-client-dragged-the-score-under-the-gate/task.md11.3 KB
  • evals/green-for-six-months-while-the-score-fell-to-52/criteria.json5.1 KB
  • evals/green-for-six-months-while-the-score-fell-to-52/task.md7.0 KB
  • evals/pr-job-outlasts-the-review-and-two-teams-want-it-gone/criteria.json5.7 KB
  • evals/pr-job-outlasts-the-review-and-two-teams-want-it-gone/task.md7.6 KB
  • evals/score-jumped-27-points-the-fortnight-nobody-wrote-tests/criteria.json5.5 KB
  • evals/score-jumped-27-points-the-fortnight-nobody-wrote-tests/task.md9.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

stryker-mutation

Overview

Per stryker-intro:

"Stryker started as a pure JavaScript mutation testing framework" and now "supports most JavaScript projects, including TypeScript, React, Angular, VueJS, Svelte, and NodeJS."

Mutation testing introduces small bugs (mutants) into the production code; if tests still pass, the test suite is too weak. A green suite with high mutation-survival rate is the bug coverage hides.

When to use

  • A JS/TS suite has ≥80% line/branch coverage and the team wants to verify assertions actually catch bugs.
  • Code review keeps surfacing weak assertions in tests (.toBeTruthy() etc); mutation testing makes the cost visible.
  • A critical module needs a higher quality bar than coverage alone proves.

Step 1 - Install

npm install --save-dev \
  @stryker-mutator/core \
  @stryker-mutator/jest-runner   # or mocha-runner / vitest-runner / etc.

Per stryker-intro, supported runners include Jest, Mocha, Karma, Vitest, Jasmine, Cucumber, Tap.

Step 2 - Initialize

npx stryker init

Generates stryker.conf.json:

{
  "$schema": "./node_modules/@stryker-mutator/core/schema/stryker-schema.json",
  "packageManager": "npm",
  "reporters": ["progress", "clear-text", "html"],
  "testRunner": "jest",
  "coverageAnalysis": "perTest",
  "mutate": ["src/**/*.ts", "!src/**/*.test.ts"],
  "thresholds": { "high": 80, "low": 60, "break": 50 }
}

Key fields:

FieldUse
mutateGlob patterns: which files to mutate; exclude tests + types.
testRunnerjest / mocha / vitest / karma / etc.
coverageAnalysisperTest (fastest - only re-run tests that touched the mutated line).
thresholds.breakMutation score below this → npx stryker run exits non-zero (CI gate).
incrementaltrue to only mutate files changed since last run.
concurrencyWorker count (default = CPU count).

Step 3 - Run

npx stryker run

Per-mutant output:

[Survived] Conditional Boundary
src/cart.ts:42:5
- if (item.qty < 0) throw new Error(...);
+ if (item.qty <= 0) throw new Error(...);
Tests run: 12 (all passed - mutant survived).

Survived mutant = tests passed despite the introduced bug = the tests don't actually catch this regression. Add a test for qty = 0.

Step 4 - Report + threshold

Ran 142 tests.
Mutants killed:    198
Mutants survived:   24
Mutants timed out:   3
Mutants no coverage: 12

Mutation score: 84.7%

Per stryker-intro: thresholds via the thresholds object gate the build:

  • >= high (80) → green.
  • >= low (60) → yellow.
  • < break (50) → red, exit code != 0.

The HTML report shows per-file mutation breakdown - drill in to see which mutants survived and where to add tests.

Step 5 - Incremental mode for PR runs

Full mutation runs are slow (5-30 min on medium codebases). For PRs, incremental mode only mutates changed files:

npx stryker run --incremental

This stores state in .stryker-tmp/ (commit to git so subsequent runs benefit). Per-PR runs typically complete in <2 min.

Step 6 - CI integration

- name: Mutation testing (changed files only)
  if: github.event_name == 'pull_request'
  run: npx stryker run --incremental

- name: Full mutation run
  if: github.ref == 'refs/heads/main' && github.event.schedule == '0 2 * * 0'
  run: npx stryker run

- uses: actions/upload-artifact@v4
  if: always()
  with:
    name: stryker-report
    path: reports/mutation/

Pattern: incremental on PRs (fast feedback) + full weekly run on main (catches drift in unchanged code).

Anti-patterns

Anti-patternWhy it failsFix
Setting break: 100Impossible bar; team disables.Start at 50-60; ratchet up over time.
Running on every PR without --incremental30-min PR feedback loop; team disables.--incremental for PRs (Step 5).
Mutating test filesMutants in test code don't reflect production quality.Exclude in mutate glob (Step 2).
Ignoring "no coverage" mutantsFiles in mutate glob without any test coverage; mutation testing wastes effort.Either add tests OR exclude those files from mutate.
Using coverageAnalysis: offRe-runs entire suite per mutant; very slow.perTest (the default; Step 2).
Hard-coding break threshold without team agreementFails surprise PRs; team disables.Land threshold via PR with team review.

Limitations

  • Slow for large codebases. Even with incremental + perTest, mutation testing scales worse than test execution.
  • Surviving mutants don't always indicate weak tests - some are equivalent mutants (semantically identical to the original); flag and exclude these.
  • TypeScript checking adds time. Disable type-check (tsconfig.tsbuildinfo) for mutation runs if not needed.
  • Per-runner integration quality varies. Jest is the most mature; Vitest / Karma have known edges.

References

  • si - StrykerJS overview, supported test runners, supported frameworks (TS / React / Angular / Vue / Svelte / Node).
  • stryker-net-mutation - .NET sibling.
  • pitest-mutation - Java sibling.
  • mutmut-mutation - Python sibling.
  • mull-mutation - C/C++ sibling.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

Builds a CI gate that fails the build on **new** WCAG / a11y violations introduced by a PR while grandfathering pre-existing violations on a per-rule / per-page baseline. Aggregates verdicts from axe-core / pa11y / Lighthouse a11y / WAVE / IBM Equal Access scans. Use when a project has accumulated a11y debt and a strict "zero violations" gate would block every PR - the ratchet pattern lets the team ship while preventing regressions.

日本語の概要は準備中です。原文の説明を表示しています。

testland/qa132026年10月20日 更新

Workflow skill that builds an A/B-test validity checklist from an experiment proposal, walking the canonical design-correctness gates - pre-registered OEC/power/guardrails, randomization unit + SRM check, assignment integrity, telemetry, peeking discipline, novelty/primacy, post-experiment SRM re-check - into a per-experiment checklist + sign-off form. Use when launching, auditing, or governing an experiment. For pitfall mechanics (guardrails, peeking) see experiment-results-interpreter's references; to read an already-valid result use experiment-results-interpreter; for per-SDK harness tests use experiment-sdk-testing - this gates DESIGN, not SDK code.

日本語の概要は準備中です。原文の説明を表示しています。

testland/qa132026年10月20日 更新

The single install-flow skill: the reference contract for the PWA install flow (installability gate fields, `beforeinstallprompt` handshake, per-platform paths - Android WebAPK / iOS Share menu / Firefox no-op - and the `display-mode` post-install signal, in references/install-flow-reference.md) plus the build-an-X workflow that emits the Add-to-Home-Screen suite. Walks the four-stage timeline, emitting one test per gate cell per [web.dev/articles/install-criteria][install-criteria], the deferred-prompt → `prompt()` → `userChoice` chain per [web.dev/articles/customize-install][customize-install], the iOS Safari manual-metadata branch (`apple-touch-icon`) per [web.dev/learn/pwa/installation][learn-pwa], and the post-install `(display-mode: standalone)` MQ assertion. Output: a Playwright spec with per-stage cells plus a coverage matrix. Use when a PWA's manifest, icons, or install handler change, when install conversion drops at an unknown stage, or when triaging a flaky install assertion.

日本語の概要は準備中です。原文の説明を表示しています。

testland/qa132026年10月20日 更新

Build-an-X workflow that uses an LLM to map existing tests to spec sections - given a spec doc + the test suite, the LLM identifies which tests cover which sections, surfaces uncovered sections (gap), and recommends specific tests to add. Output is a coverage matrix per spec ID. Scope is mapping tests that already exist and naming the gaps, not authoring tests for new acceptance criteria. Use when a spec doc and a test suite both exist but nobody can say which requirements are actually covered - before a release sign-off, an audit, or a decision about where to spend the next round of test effort.

日本語の概要は準備中です。原文の説明を表示しています。

testland/qa132026年10月20日 更新

Generates tests from natural-language specs (acceptance criteria, user stories, requirements) using an LLM, with confidence scoring per test case (LLM self-assessment plus heuristics: assertion quality, naming, completeness), batching uncertain cases for human review, and integration with the team's existing test framework. Use when the user asks to generate unit tests from acceptance criteria, convert user stories to test cases, automate test creation from requirements, or augment a spec-driven test suite with AI-generated stubs that are then curated before merge.

日本語の概要は準備中です。原文の説明を表示しています。

testland/qa132026年10月20日 更新

Configures Allure Report (test-runner adapter install, `allure-results` directory wiring, `categories.json` for failure classification, `history-trend.json` retention via the copy-history-between-runs pattern), runs the Allure CLI to convert `allure-results` to a static HTML site, and uploads the report as a CI artifact. Use when the team needs richer test reporting than JUnit XML - step-level attachments, per-test history, retry tracking, and severity / epic / feature labeling across framework-agnostic adapters (pytest, Jest, JUnit, TestNG, NUnit, Mocha). As a rich static HTML report generator, it is the open-source alternative to the sunset ExtentReports (JVM/.NET per-test HTML narrative); for hosted cross-run flakiness analytics rather than a static per-run report use currents-integration.

日本語の概要は準備中です。原文の説明を表示しています。

testland/qa132026年10月20日 更新

testland のスキルをすべて見る

このスキルの問題を報告する