Maven 编码质量闸口(编译 + 单测 + 静态分析 + 启动检测),只做验证不做修复,问题统一记录到 qa-pending.md。当编码完成后需要执行质量门禁时使用,也可单独触发。关键词:QA、质量验证、编译检查、单测、静态分析、启动检测、mvn verify、质量闸口。

Apache-2.0Auto-check passed

Install Maven QA

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill maven-qa -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins maven-qa --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/Colin4k1024/tsp/skills/maven-qa .claude/skills/maven-qa && 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
maven-qa
GitHub stars
1.3k
Token cost
~1.1k tokens
SKILL.md length
244 words
Files
5 (incl. scripts)
Skills in repo
714
Repo updated
First seen
Licence
Apache-2.0

At a glance

Maven 编码质量闸口(编译 + 单测 + 静态分析 + 启动检测),只做验证不做修复,问题统一记录到 qa-pending.md。当编码完成后需要执行质量门禁时使用,也可单独触发。关键词:QA、质量验证、编译检查、单测、静态分析、启动检测、mvn verify、质量闸口。

  • Works in 4 steps: :编译 → :单测 → :静态分析 → …
  • SKILL.md covers 职责, 执行合同, 参数 and Phase 1:编译, plus 6 more sections
  • Runs Python scripts from its folder; calls mvn, python3 and git

What it does

Maven QA is an agent skill from hashgraph-online/awesome-codex-plugins. Maven 编码质量闸口(编译 + 单测 + 静态分析 + 启动检测),只做验证不做修复,问题统一记录到 qa-pending.md。当编码完成后需要执行质量门禁时使用,也可单独触发。关键词:QA、质量验证、编译检查、单测、静态分析、启动检测、mvn verify、质量闸口。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `agents/openai.yaml`, `scripts/parse_static_analysis.py` and `scripts/parse_surefire.py`).

The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

Example prompts

  • “/maven-qa”

Requirements

  • Python 3

Workflow steps

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

  1. :编译
  2. :单测
  3. :静态分析
  4. :启动检测

What it can do on your machine

Read from SKILL.md and the folder at commit 9e7b281. 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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • mvn
    • python3
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Maven QA loads about 1.1k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 244 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 9e7b281, republished under its Apache-2.0 licence (© hashgraph-online). 244 words, ~1,068 tokens.

Download SKILL.mdSave it as .claude/skills/maven-qa/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
maven-qa
description
Maven 编码质量闸口(编译 + 单测 + 静态分析 + 启动检测),只做验证不做修复,问题统一记录到 qa-pending.md。当编码完成后需要执行质量门禁时使用,也可单独触发。关键词:QA、质量验证、编译检查、单测、静态分析、启动检测、mvn verify、质量闸口。

Maven QA 质量闸口

职责

编码完成后的四阶段质量验证:编译 → 单测 → 静态分析 → 启动检测。

只检查,不修复。 任何阶段失败,将问题记录到统一遗留文件后继续执行下一阶段,确保四个阶段的结果都能完整收集。

执行合同

适用前提
  • 已有可验证的代码或配置变更,需要统一收集编译、单测、静态分析和启动结果。
  • 若任务只是设计或 intake 阶段,没有可执行对象,不应提前运行本 skill。
任务变量
  • workspaceDir:当前工作区根目录。
  • projectName:目标项目名;未提供时取 workspaceDir 目录名。
  • projectDir:workspaceDir / projectName。
  • subModule:要执行 mvn test / 启动检查的子模块,默认 .。
  • subModuleDir:projectDir / subModule。
  • triggerMethod:此次 QA 对应的方法、模块或任务标识。
  • <skill_dir>:当前安装环境中的 maven-qa 技能目录,用于解析脚本路径。
变量来源
  • workspaceDir 默认取当前工作区。
  • projectName、subModule、triggerMethod 优先来自 /team-plan、/team-execute、上游 /handoff;未提供时按默认值执行并在输出中注明假设。
  • <skill_dir> 始终指向当前 skill 安装目录,不需要用户提供,也不能写死绝对路径。
  • 若多模块项目无法判断 subModule,应在开始前把候选模块写入 待确认项,而不是盲跑全仓。
执行入口
  1. 先确认是在正确的 projectDir / subModuleDir 执行。
  2. 若是某个具体实现任务触发,优先把 triggerMethod 写成 ClassName.methodName 或 module:task,便于后续追踪。
  3. 运行四阶段验证前不做修复;修复应回到对应编码 skill。
  4. 缺少 Maven、依赖或模块定位信息时,先在输出中显式记录,再决定是否继续。
输出回落
  • QA 失败时追加 docs/coding-issues/qa-pending.md,但这不是最终交付。
  • 最终摘要必须回落到 /team-review、/team-release 或 /handoff 的质量结论中。
  • 若本次 QA 是 company skill 执行链的一部分,还要同步写入 领域扩展约束核对结果。

参数

参数说明默认值
projectName项目名(可选,不填时使用当前仓库目录名)当前目录
branch切换分支(可选)不切换
workspaceDir工作区根目录当前工作区
subModule子模块名或相对路径(可选).
triggerMethod触发来源(编码场景填 ClassName.methodName)手动触发

派生路径:

  • projectDir = workspaceDir / projectName
  • subModuleDir = projectDir / subModule

可选切换分支:若提供 branch 且非空,先执行 git checkout <branch>,失败则终止所有阶段。

脚本示例中的 <skill_dir> 指当前安装环境里的 maven-qa 技能目录。


Phase 1:编译

bash
cd <projectDir>
mvn clean install -Dcheckstyle.skip=true -Dpmd.skip=true -Dspotbugs.skip=true
  • 超时:5 分钟
  • 成功(退出码 0):记录 compile: pass,进入 Phase 2
  • 失败:提取所有 [ERROR] 关键行,记录到 统一遗留文件,继续执行 Phase 2

Phase 2:单测

bash
cd <subModuleDir>
mvn test
  • 超时:10 分钟
  • 命令完成后(不论退出码)解析报告:
bash
python3 <skill_dir>/scripts/parse_surefire.py \
  --report-dir <subModuleDir>/target/surefire-reports
  • 通过(success=true,通过率 >95%):记录 test: pass,进入 Phase 3
  • 失败:将 failureDetails(类名、方法名、message)记录到 统一遗留文件,继续执行 Phase 3
  • 报告目录不存在(命令直接崩溃):记录"单测命令执行失败,无报告",继续

Phase 3:静态分析

bash
cd <projectDir>
mvn clean verify
  • 超时:5 分钟
  • 命令完成后解析报告:
bash
python3 <skill_dir>/scripts/parse_static_analysis.py \
  --report-dir <subModuleDir>/target/static-analysis
  • 通过(criticalIssues == 0):记录 static: pass,进入 Phase 4
  • 失败:将 criticalViolations(PMD)和 criticalBugs(SpotBugs)记录到 统一遗留文件,继续执行 Phase 4
  • 代码风格类(命名、注释格式)不属于 critical,不记录

Phase 4:启动检测

bash
cd <subModuleDir>
mvn spring-boot:run \
  -Dspring-boot.run.jvmArguments=-Dserver.port=<随机端口8081~9079> \
  -Dspring.profiles.active=test
  • 执行方式:异步,合并 stdout/stderr
  • 等待 30 秒判断结果:
    • 30 秒内进程退出且退出码非 0 → 启动失败,提取 APPLICATION FAILED TO START 或 BUILD FAILURE 段落(无则取末尾 60 行),记录到 统一遗留文件
    • 30 秒内进程退出且退出码 0 → 视为正常结束,记录 run: pass
    • 30 秒后进程仍运行 → 记录 run: pass,关闭该进程

统一遗留文件 qa-pending.md

路径:docs/coding-issues/qa-pending.md(相对于 projectDir)

  • 文件不存在时自动创建;已存在时末尾追加,禁止覆盖历史
markdown
## {yyyy-MM-dd HH:mm:ss} | QA 遗留 | {triggerMethod}

**编译**:{pass / 失败摘要}

{[ERROR] 关键行列表,无则省略此块}


**单测**:{pass / 失败 N 个}
  • {ClassName}.{methodName} — {message}

**静态分析**:{pass / critical N 个}
  • PMD {规则名} @ {文件}:{行} — {message}
  • SpotBugs {type} @ {类名}:{行} — {message}

**启动**:{pass / 失败摘要}

{失败日志摘要,无则省略此块}


---

四个阶段全部通过时,不写入此文件。


输出摘要

✅/❌ 编译   {pass / 失败 N 个错误}
✅/❌ 单测   {totalTests} 个,通过率 {passRate}%
✅/❌ 静态   总问题 {totalIssues},critical {criticalIssues}
✅/❌ 启动   {pass / 30s 内异常退出}

有遗留问题时补充:→ 已记录到 docs/coding-issues/qa-pending.md


Overview

执行编码完成后的四阶段 Maven 质量门禁验证:编译 → 单测 → 静态分析 → 启动检测,每阶段失败均记录到 qa-pending.md 后继续执行,确保四阶段结果完整收集。

本 skill 只检查,不修复。问题修复请回到对应编码 skill 处理。

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in plugins/Colin4k1024/tsp/skills/maven-qa of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • agents/openai.yaml
  • scripts/parse_static_analysis.py
  • scripts/parse_surefire.py
  • scripts/requirements.txt

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Maven QA 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.

Maven QA compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maven QA this skillhashgraph-online/awesome-codex-plugins1.3k—~1.1kAutomated safety check: PassApache-2.0
Mavenskjolber/3d-bin-container-packing569—~886Automated safety check: PassApache-2.0
Maven Dependency Auditdecebals/claude-code-java751—~1.7kAutomated safety check: PassMIT
113 Java Maven Documentationjabrena/plinth447—~908Automated safety check: PassApache-2.0
114 Java Maven Searchjabrena/plinth447—~1.6kAutomated safety check: PassApache-2.0
111 Java Maven Dependenciesjabrena/plinth447—~1.5kAutomated safety check: PassApache-2.0

Similar skills

  • Maven

    skjolber/3d-bin-container-packing

    Maven build expertise for this multi-module Java project. An agent skill from skjolber/3d-bin-container-packing.

    569 GitHub stars~886 tokensUpdated today
    SecurityAuto-check passed
  • Maven Dependency Audit

    decebals/claude-code-java

    Audit Maven dependencies for outdated versions, security vulnerabilities, and conflicts.

    751 GitHub stars~1.7k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • A skill your agent uses when you need to create a DEVELOPER.md file for a Maven project — combining a fixed base template with dynamic sections derived from allowlisted Maven POM structure…

    447 GitHub stars~908 tokensUpdated yesterday
    Auto-check passed
  • 114 Java Maven Search

    jabrena/plinth

    Routes Maven version questions to the right workflow by choosing project-local update report interpretation for a user’s own pom.xml, or Maven artifact discovery from maintainer-approved structured…

    447 GitHub stars~1.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • A skill your agent uses when you need to add or evaluate Maven dependencies that improve code quality or domain modeling — including nullness annotations (JSpecify), static analysis (Error Prone +…

    447 GitHub stars~1.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • A skill your agent uses when you need to add or configure Maven plugins in your pom.xml — including quality tools (enforcer, surefire, failsafe, jacoco, pitest, spotbugs, pmd), security scanning…

    447 GitHub stars~3.2k tokensUpdated yesterday
    SecurityAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 714 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

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

Questions about Maven QA

What does Maven QA do?

Maven 编码质量闸口(编译 + 单测 + 静态分析 + 启动检测),只做验证不做修复,问题统一记录到 qa-pending.md。当编码完成后需要执行质量门禁时使用,也可单独触发。关键词:QA、质量验证、编译检查、单测、静态分析、启动检测、mvn verify、质量闸口。. Maven QA is an agent skill from hashgraph-online/awesome-codex-plugins.

How do I install Maven QA in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill maven-qa -a claude-code`. Or copy the skill folder (plugins/Colin4k1024/tsp/skills/maven-qa in hashgraph-online/awesome-codex-plugins) into .claude/skills/maven-qa in your project. Claude Code loads it when a task matches its description.

How do I install Maven QA in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill maven-qa -a codex`. Or copy the skill folder (plugins/Colin4k1024/tsp/skills/maven-qa in hashgraph-online/awesome-codex-plugins) into .agents/skills/maven-qa in your project. Codex loads it when a task matches its description.

Can I use Maven QA 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 hashgraph-online/awesome-codex-plugins --skill maven-qa -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maven-qa, .gemini/skills/maven-qa, .github/skills/maven-qa and .opencode/skills/maven-qa in your project.

What does Maven QA need to run?

Going by SKILL.md and its folder, Maven QA needs Python for the scripts in its folder and the command-line tools its instructions call (mvn, python3 and git). Our summary lists: Python 3.

Does Maven QA access the network?

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

Is Maven QA 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Maven QA use?

Maven QA is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Maven QA use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Maven QA?

Skills that share tags, products or a category with Maven QA: Maven (skjolber/3d-bin-container-packing, 569 stars), Maven Dependency Audit (decebals/claude-code-java, 751 stars), 113 Java Maven Documentation (jabrena/plinth, 447 stars) and 114 Java Maven Search (jabrena/plinth, 447 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maven QA?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,255 GitHub stars. The repository holds 714 skills in this directory. The repository was last updated on October 9, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.