agentleFS
SrltasSrltas/claude-skills/hhh-dialect-verify-report/SKILL.md

hhh-dialect-verify-report

Skill0 starsChanged 13 days agoMITView on GitHub

Run the Hibernate ORM test suite against one or all CUBRID versions, compare pass/fail with a baseline, and always write a Korean Word comparison report. Combines hhh-dialect-verify and report in one run.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Run the hibernate-core suite against CUBRID (one version or the full matrix), diff vs a baseline, and always generate the Word 비교 분석 report.

    line 14
  2. Very specific:

    After each version the script tears the CUBRID container down with its anonymous data volume (down -v) before the next version, so the disk …

    line 36
  3. Very specific:

    Follow the report skill's schema + 작성 원칙 (간결, 표/차트 우선).

    line 52

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

CUBRID dialect verify → report (one-shot)

Run the hibernate-core suite against CUBRID (one version or the full matrix), diff vs a baseline, and always generate the Word 비교 분석 report. This orchestrates two installed skills: hhh-dialect-verify (parse_results.py, measurement) and report (build_report.js, document).

⚠️ Long-running: the full suite is ~30 min per version (≈2.5 h for --all-versions). Use --tests '<filter>' for a quick smoke check first.

Step 0: Prereqs

  • Installed skills: hhh-dialect-verify and report (both installed next to this skill).
  • Hibernate repo (default ~/Devel/hibernate), Docker, python3, and for the report: node + global docx, plus the report venv (matplotlib). See the report skill's Step 0.
  • Optional: the Understand-Anything plugin (/understand-* commands). If installed, Step 3 can add a change-impact (영향 범위) note; the pipeline runs fine without it.

Step 1: Run the orchestrator (verify across versions)

bash ${CLAUDE_SKILL_DIR}/assets/run_verify.sh \
  --baseline ~/Devel/cubrid-fullsuite-10.2-2026-06-13.tgz \
  --all-versions                      # or: --versions 10.2,11.4   (add --tests '<filter>' for a fast run)

Per version it starts CUBRID (CUBRID_IMAGE=...:<v> ./db.sh cubrid), runs :hibernate-core:test -Pdb=cubrid, parses results, and diffs vs the baseline. Writes verify-out/summary.json (+ per-version <v>.json, run-<v>.log) and prints a table: version · total · failed · +recovered · −regressed · net.

The baseline may be a .tgz, a test-results/test dir, or a *.json from a prior parse. For accurate per-version deltas the baseline should correspond to the version(s) compared.

After each version the script tears the CUBRID container down with its anonymous data volume (down -v) before the next version, so the disk doesn't fill up across the matrix (each version's volume is ~2.7 GB). Pass --no-cleanup to keep the DB running for debugging.

Step 2: Read the summary

Read verify-out/summary.json → { baseline_failed, versions: [{version, total, passed, failed, skipped, recovered, regressed, net, families, recovered_by_family, regressed_by_family}] }.

Step 3: Author the report spec (MANDATORY: the pipeline always reports)

Turn summary.json into a report JSON spec (a 비교 분석), using the real numbers: do not skip this:

  • conclusion: headline net change + recovered/regressed, **…** on key numbers.
  • 결과 section: a table of version × (failed, +recovered, −regressed, net) with row status colors, plus a bar/hbar chart (failed-per-version for --all-versions, or before→after with a -N badge for a single version).
  • 실패 분류 section: an hbar of recovered-by-family (and/or top remaining families).
  • 회귀 section: if any regressed, a note (warn) + the regressed test list; else state "회귀 ~0".
  • 영향 범위 (선택: only if the Understand-Anything plugin is installed): to complement the quantitative +N/−N deltas with the change's blast radius, run /understand-diff (for uncommitted changes) or /understand-explain on the dialect files, and fold the result into a short note or an "영향" subsection. If the plugin is not installed, skip this: the rest of the report is unchanged.

Follow the report skill's schema + 작성 원칙 (간결, 표/차트 우선). Default meta = CUBRID Dev1 · 작성일 <date> (author = CUBRID Dev1 unless the user names another).

Step 4: Generate, validate, visually verify (MANDATORY)

bash ${CLAUDE_SKILL_DIR}/../report/assets/build.sh   <spec>.json <out>.docx
bash ${CLAUDE_SKILL_DIR}/../report/assets/preview.sh <out>.docx

build.sh handles the toolchain; preview.sh checks the file's structure and renders every page to PNG. Read those page images before handing off (report skill Step 4). Hand the user the .docx path and verify-out/summary.json.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.