Agent skill

Cm QA Engineer

by kingxiaozhe in kingxiaozhe/cm-workflow

QA 工程师 Skill,执行功能测试、E2E 测试、可视化回归、验收标准核验,自动适配项目测试框架. An agent skill from kingxiaozhe/cm-workflow.

MITAuto-check passedTesting & QA

Install Cm QA Engineer

skills CLI
$ npx skills add kingxiaozhe/cm-workflow --skill cm-qa-engineer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kingxiaozhe/cm-workflow cm-qa-engineer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kingxiaozhe/cm-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cm-qa-engineer .claude/skills/cm-qa-engineer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cm-qa-engineer
GitHub stars
104
Token cost
~983 tokens
SKILL.md length
271 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

QA 工程师 Skill,执行功能测试、E2E 测试、可视化回归、验收标准核验,自动适配项目测试框架. An agent skill from kingxiaozhe/cm-workflow.

  • Works in 7 steps: 识别测试框架 → 读取上下文 → 补全测试(仅 implementation) → …
  • Tasks that involve QA and bug reports
  • SKILL.md covers 调用模式, 工作流程, 常见坑 and 输出
  • Calls npm and npx

What it does

Cm QA Engineer is an agent skill from kingxiaozhe/cm-workflow. QA 工程师 Skill,执行功能测试、E2E 测试、可视化回归、验收标准核验,自动适配项目测试框架

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering QA and bug reports and End-to-end testing. The repository describes itself as: Codex-native, spec-driven AI Agent workflow with Claude Code compatibility, independent review, QA, fixes, and refactors. The licence is MIT.

When your agent uses it

  • Tasks that involve QA and bug reports
  • Tasks that involve End-to-end testing

Example prompts

  • “/cm-qa-engineer”

Requirements

  • Node.js

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. 识别测试框架
  2. 读取上下文
  3. 补全测试(仅 implementation)
  4. 运行测试
  5. 可视化回归(如涉及 UI)
  6. 验收标准核验
  7. 处理失败

What it can do on your machine

Read from SKILL.md and the folder at commit 82d43f0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cm QA Engineer loads about 983 tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 271 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~983

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kingxiaozhe/cm-workflow at commit 82d43f0, republished under its MIT licence (© kingxiaozhe). 271 words, ~983 tokens.

Download SKILL.mdSave it as .claude/skills/cm-qa-engineer/SKILL.md (or your agent's skills folder).
name
cm-qa-engineer
description
QA 工程师 Skill,执行功能测试、E2E 测试、可视化回归、验收标准核验,自动适配项目测试框架

cm-qa-engineer — QA 工程师

在开发任务完成后执行整体质量验证。自动识别项目测试框架。

调用模式

模式调用方写入权限
implementation$cm-ai 的 N6可按既有规范补测试并回写 AC
readonly$cm-test只运行与取证;禁止改源码、测试、依赖、快照和 specs

未显式指定时,只有 $cm-ai 自动调用可默认 implementation;$cm-test 必须显式 传入 readonly,其只读边界优先于本 Skill 后续任何“补全/修复/回写”指令。

工作流程

1. 识别测试框架

自动检测,不做硬编码假设:

  • 单元/组件测试:Vitest / Jest / Mocha / pytest / Go testing / Rust cargo test
  • E2E 测试:Playwright / Cypress / Selenium / Puppeteer
  • 覆盖率工具:c8 / istanbul / coverage.py / go cover
  • implementation 模式如项目未配置测试框架,根据技术栈推荐并安装
  • readonly 模式缺少框架或依赖 → 记 BLOCKED,不得安装
2. 读取上下文
  • requirements.md 中的验收标准
  • design.md 了解功能模块和接口契约
  • test-cases.json(如存在)按 ../../runtime/test-contract.md 读取
  • .claude/rules/testing.md(如存在)
  • 扫描现有测试文件了解测试模式和覆盖情况
3. 补全测试(仅 implementation)

对开发阶段未写测试的代码补充:

  • 组件:渲染测试、交互测试、Props 边界
  • API/服务层:正常流、异常流、边界值
  • 工具函数:输入输出覆盖
  • 数据库层:migration 可执行、查询结果正确

遵循项目已有的测试文件命名和目录约定。

readonly 模式跳过本节,不得创建、修改或修复任何测试。

二开回归范围跟波及面走:design.md 存在「波及面」段时,回归测试范围 = 新功能 AC + 波及面清单上的存量功能逐项冒烟——新功能好不好是一半,老功能没坏才是另一半。

禁止前提共谋(硬规则):断言含具体数值时,测试输入必须多参数化(至少覆盖 2-3 组不同前提),禁止测试与被测代码共享同一默认前提——硬编码值在唯一被测前提下"恰好成立"是已实证的盲区模式(实跑教训:断言与配置都默认 A4,切 A5 即错位 39.9mm,参数化后现形)。

4. 运行测试

调用方 $cm-ai N6 或 $cm-test 负责 test_run/start 与 test_run/complete; 本 Skill 不重复写调用级边界。存在 AI 测试合同时,本 Skill 在每个 blocking case 实际执行前写 test_run/case_start,并以 case_complete 或 case_blocked 唯一 收口;每次真实重试携带递增 attempt。仅当本轮存在 CM specs 时才在关键阶段同步 更新 .cm-status.json,standalone $cm-test 不创建该文件,也不使用后台心跳。

bash
# 根据项目实际命令执行
npm run test              # 或 pnpm test / cargo test / pytest
npm run test -- --coverage  # 覆盖率
npx playwright test       # E2E

收集:通过数/失败数/覆盖率。

有 test-cases.json 时,正式命令证据与用例逐条关联;不能用静态 logic SUPPORTED 计入命令通过数。

5. 可视化回归(如涉及 UI)
  1. 识别交付形态并启动正式测试载体:Web 启动开发服务器;微信小程序执行正式构建并 打开微信开发者工具。小程序同时读取 ../cm-miniprogram-engineer/references/release-checklist.md,不得用 H5/Web target 冒充小程序运行结果。
  2. Web 选择浏览器驱动(按优先级):
    • 检查项目配置:如 .claude/rules/testing.md 中指定了 browser_driver,使用用户指定的方式
    • 默认:Playwright CDP(无头模式) — 不弹窗,适合截图对比、DOM 断言、样式回归等大多数场景
    • 自动升级:Chrome DevTools MCP — 当检测到以下场景时切换:需要登录态/Cookie 持久化、OAuth/第三方弹窗交互、需要观察真实动画/过渡效果、用户明确要求实时调试
    • 切换前输出:🔄 切换到 Chrome DevTools MCP — 原因: {原因},浏览器窗口将弹出 微信小程序不进入此浏览器驱动分支:基础交互走开发者工具模拟器,授权、设备差异和 平台 API 走预览/体验版真机;工具或账号不可用时对应 blocking case 为 BLOCKED。
  3. 截图保存
  4. 对比基准截图(如有)
  5. test-cases.json 中的 browser cases 逐条执行 steps、断言 expected,并记录 PASS | FAIL | BLOCKED;cleanup 失败时记 BLOCKED
  6. 临时 profile、进程、模型别名或 fixture 使用前写 resource/acquired,清理后 用同一 resource_id 写 resource/released;每次新获取生成新的 ID,释放后的 ID 不复用。写入 cleanup_failed 后保持 BLOCKED,不得把断言通过当作整个用例通过

用户覆盖:在 .claude/rules/testing.md 中添加 browser_driver: playwright | chrome-mcp | ask 可固定选择或设为每次询问。

6. 验收标准核验

逐条检查 requirements.md 中的验收标准:

markdown
- [x] [AC-001] 描述 → 已通过测试验证
- [ ] [AC-002] 描述 → ⚠️ 需手动验证

标注每条的验证方式(自动/手动/无法自动化)。

implementation 模式的核验结果必须回写 requirements.md 的验收标准 checkbox ([x] [AC-001] → 已通过测试验证)。readonly 模式只写测试报告,不改 requirements.md。

7. 处理失败
  • 测试失败 → 判断是代码 bug、测试问题还是环境阻塞
  • implementation:代码 bug 汇报主 agent,测试问题可修复后重跑,最多 3 轮
  • readonly:保留原始失败,只报告给 $cm-test;不得修测试或代码,不自动调用 $cm-fix

常见坑

问题处理
测试环境和开发环境不一致检查 test 配置中的环境变量和 mock 设置
异步测试超时增加 timeout,检查是否缺少 await
E2E 测试不稳定(flaky)用 waitFor 代替固定延时,重试机制
覆盖率统计不准检查 coverage 配置的 include/exclude

输出

text
📋 QA 报告

测试: {N} 通过 / {N} 失败 / 覆盖率 {N}%
E2E: {状态}
AI 测试合同: logic {N}/{N} 已核验 · browser {N}/{N} 已执行
验收标准: {N}/{total} 通过, {N} 需手动验证
安全扫描: {状态}
结论: {PASSED / FAILED / NEEDS_MANUAL}

© kingxiaozhe, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cm-qa-engineer of kingxiaozhe/cm-workflow.

Open the folder on GitHubat commit 82d43f0

Compare with similar skills

Cm QA Engineer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cm QA Engineer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cm QA Engineer this skillkingxiaozhe/cm-workflow104—~983Automated safety check: PassMIT
Moav E2EMotherofallVPNs/MoaV448—~1.9kAutomated safety check: NotesMIT
Validate Stylebotankit/stylebot1.6k—~780Automated safety check: PassMIT
Whole-App Health Sweepreticlehq/reticle1.2k—~1.1kAutomated safety check: PassApache-2.0
Stark Smoke TestScaffold-Stark/scaffold-stark-2109—~3kAutomated safety check: NotesNone
Vss E2E Smokeopen-edge-platform/edge-ai-libraries169—~1.5kAutomated safety check: PassApache-2.0

Similar skills

  • Moav E2E

    MotherofallVPNs/MoaV

    Run and debug MoaV's end-to-end tests — real protocol connectivity (client-test.sh) and the moav CLI smoke test — against a LIVE server, via the self-hosted e2e workflow or a local test VPS.

    448 GitHub stars~1.9k tokensUpdated yesterday
    Testing & QAAuto-check: notes
  • Validate Stylebot

    ankit/stylebot

    Launch Stylebot in a real, headed Chrome window (via yarn dev:chrome) so the user can manually eyeball a change — in whatever checkout the current session is in, worktree or main.

    1.6k GitHub stars~780 tokensUpdated today
    Testing & QAAuto-check passed
  • Whole-App Health Sweep

    reticlehq/reticle

    Sweeps a running web app by clicking every reachable control, then reports dead buttons, console errors, failed requests and mismatches between API data and the screen.

    1.2k GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Stark Smoke Test

    Scaffold-Stark/scaffold-stark-2

    Use after Phase 1 dependency updates are merged, before any Phase 2 propagation to sibling forks - runs the end-to-end devnet gate (up brings devnet/deploy/dev-server up, verify drives Chrome over…

    109 GitHub stars~3k tokensUpdated 2 mo ago
    Testing & QAAuto-check: notes
  • Vss E2E Smoke

    open-edge-platform/edge-ai-libraries

    Run this skill whenever the user asks to verify my VSS install works, smoke test VSS, check whether the deployment succeeded, or run an end-to-end test of summary/search for the…

    169 GitHub stars~1.5k tokensUpdated today
    Testing & QAAuto-check passed
  • Testing QA

    aiskillstore/marketplace

    Comprehensive testing and QA workflow covering unit testing, integration testing, E2E testing, browser automation, and quality assurance.

    430 GitHub starsUsed in 3 repos~1.2k tokens
    Testing & QAAuto-check passed

More from kingxiaozhe/cm-workflow

All 23 skills in this repo
  • Cm Fix

    kingxiaozhe/cm-workflow

    用户说“修复这个可复现 bug”或要求根据失败报告修代码时使用。执行红灯测试、根因定位、最小修复、独立审查和回归;尚未确认的问题先用 cm-test,新功能和架构重设计转交 cm-prd。

    104 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Cm Idea

    kingxiaozhe/cm-workflow

    用户说“我有个点子”“帮我梳理产品”或需要先聊清目标时使用。通过逐题访谈整理为可交给 cm-prd 的 PRD;已有明确需求文档时改用 cm-prd,不写代码、不拆开发任务。

    104 GitHub starsUsed in 1 repo~419 tokens
    Auto-check passed
  • Cm Refactor

    kingxiaozhe/cm-workflow

    用户明确要求“只整理结构,不改变行为”时使用。执行边界分流、行为判官、分批重构和独立审查;缺陷修复转交 cm-fix,新增或变化的业务行为转交 cm-prd。

    104 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Cm Security

    kingxiaozhe/cm-workflow

    用户运行 cm-security,或要求代码安全扫描、漏洞检查、密钥泄露排查、依赖漏洞检查时使用。默认检查当前分支相对主分支及已跟踪未提交修改,结合业务地图复核;--all 检查全部已跟踪文件。只报告问题,不自动修复、安装、升级或发布。安装自检用 cm-check,功能测试与覆盖率用 cm-test。

    104 GitHub starsUsed in 1 repo~744 tokens
    Auto-check passed
  • Cm AI

    kingxiaozhe/cm-workflow

    用户明确说“规格已确认,开始实现”或要求按已审批 CM specs 开发时使用。新任务默认由 JS workflow 驱动 N1-N8,完成开发、独立审查、QA 与文档同步;模糊点子、未审规格和单独一句“继续”不能触发编码批准。

    104 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Cm Check

    kingxiaozhe/cm-workflow

    用户说“检查工作流是否安装正确”“为什么找不到 cm 命令”时使用。默认查询 npm 稳定版,有新版自动升级已管理的 CM 安装,再检查插件、核心 Skills、兼容包装与模板引用;不测试或修改业务代码。

    104 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Cm QA Engineer

What does Cm QA Engineer do?

QA 工程师 Skill,执行功能测试、E2E 测试、可视化回归、验收标准核验,自动适配项目测试框架. An agent skill from kingxiaozhe/cm-workflow. Cm QA Engineer is an agent skill from kingxiaozhe/cm-workflow.

When should I use Cm QA Engineer?

Cm QA Engineer fits situations like: tasks that involve QA and bug reports; tasks that involve End-to-end testing.

How do I install Cm QA Engineer in Claude Code?

Run `npx skills add kingxiaozhe/cm-workflow --skill cm-qa-engineer -a claude-code`. Or copy the skill folder (skills/cm-qa-engineer in kingxiaozhe/cm-workflow) into .claude/skills/cm-qa-engineer in your project. Claude Code loads it when a task matches its description.

How do I install Cm QA Engineer in Codex?

Run `npx skills add kingxiaozhe/cm-workflow --skill cm-qa-engineer -a codex`. Or copy the skill folder (skills/cm-qa-engineer in kingxiaozhe/cm-workflow) into .agents/skills/cm-qa-engineer in your project. Codex loads it when a task matches its description.

Can I use Cm QA Engineer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kingxiaozhe/cm-workflow --skill cm-qa-engineer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cm-qa-engineer, .gemini/skills/cm-qa-engineer, .github/skills/cm-qa-engineer and .opencode/skills/cm-qa-engineer in your project.

What does Cm QA Engineer need to run?

Going by SKILL.md and its folder, Cm QA Engineer needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js.

Does Cm QA Engineer access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Cm QA Engineer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cm QA Engineer use?

Cm QA Engineer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cm QA Engineer use?

About 983 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cm QA Engineer?

Skills that share tags, products or a category with Cm QA Engineer: Moav E2E (MotherofallVPNs/MoaV, 448 stars), Validate Stylebot (ankit/stylebot, 1.6k stars), Whole-App Health Sweep (reticlehq/reticle, 1.2k stars) and Stark Smoke Test (Scaffold-Stark/scaffold-stark-2, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cm QA Engineer?

kingxiaozhe (a GitHub user) maintains it in kingxiaozhe/cm-workflow, which has 104 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 8, 2026.

Source: kingxiaozhe/cm-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.