Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

verify

/verify

Odczytuje raport brep dla części .brep.ts, ocenia zrzuty i prowadzi naprawę najmniejszej odpowiedzialnej sekcji.

Repozytorium
brepjs ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Odczytuje raport brep dla części .brep.ts, ocenia zrzuty i prowadzi naprawę najmniejszej odpowiedzialnej sekcji.

Oryginalny opis (EN)

Use when running brep on a `.brep.ts` part and interpreting the result — reading the JSON report (ok / checks / assertions / hints), verifying visually from snapshots, driving repair of the smallest responsible section, and using the brep CLI subcommands. This is the checking step that decides whether a part is done.

Jak działa

  1. Verify (type + geometry)
  2. Reading the report
  3. Verify visually
  4. Repair discipline
  5. Asserting expected codes (for fixtures / eval)
  6. CLI subcommands (the brep bin)
Sekcje z nagłówków SKILL.md, w oryginale · 80 linii, 587 słów
Podgląd SKILL.md
---
name: verify
description: Use when running brep on a `.brep.ts` part and interpreting the result — reading the JSON report (ok / checks / assertions / hints), verifying visually from snapshots, driving repair of the smallest responsible section, and using the brep CLI subcommands. This is the checking step that decides whether a part is done.
version: 0.1.0
---

# Verify a brepjs part

Run the part on the kernel and judge it by the **report**, not by how the code reads. The CLI ships
in the `brepjs-cad` package as `brep`.

## Verify (type + geometry)

```
brep verify part.brep.ts --check --json report.json
```

`--check` type-checks before running (catches wrong-API calls early); the JSON report is the source
of truth. Iterate fast with `brep watch part.brep.ts`.

## Reading the report

```jsonc
{
  "ok": false,                       // true only if valid AND every assertion passes
  "shapeType": "Solid",
  "checks": [{ "name": "isValidSolid", "passed": false }],
  "measurements": { "volume": …, "area": …, "bounds": {…} },
  "assertions": [{ "name": "volume", "expected": 24000, "actual": 31200, "passed": false }],
  "hints":  [{ "code": "FILLET_NO_EDGES", "fix": "…", "nextStep": "…" }],
  "errorInfos": [{ "code": "…", "message": "…" }]
}
```

- **`ok`** is the verdict. `false` → not done. With an `expected` block, `ok` also requires every
  assertion to pass.
- **`checks`** = kernel validity (manifold solid, positive volume). A failed check means the geometry
  is broken, not just wrong-sized.
- **`shapeType: 'Compound'` is normal for a single body.** A `cut`, a `fillet`, or a chain of cuts
  often reports the result as `Compound` even though it's one watertight solid — fine as long as
  `ok:true` and the validity checks pass. Only a _loose_ `Compound` from a failed `fuse` of
  merely-touching solids is a problem (`../implement/references/booleans.md`). Don't retry a valid
  part just because it isn't labelled `Solid`.
- **`assertions`** = declared intent vs reality. A failed assertion means valid-but-wrong.
- **`hints`** = actionable fix + next step keyed on the error code. Read these before guessing.
- **`errorInfos`** = raw structured failures (`code` + `message`) the hints derive from. Cite the
  `code` when repairing.
- Trust this JSON over the rendered image. The render confirms _shape_; the JSON confirms _correctness_.

## Verify visually

Add `--snapshot shots/` for iso/front/top/right PNGs; each has the bbox size (`W × D × H`) burned in,
so you can read scale from the image. Review against the brief. A visual concern is **not** a
conclusion: convert a _dimensional_ one to a measurement ("hole looks off-center → check `bounds`");
a _design-quality_ one ("looks lumpy / glued-from-primitives") goes to `brepjs:polish`. Don't declare
done without a snapshot.

## Repair discipline

- Change the **smallest responsible section**, re-verify, repeat. Don't rewrite the whole part on
  one failure.
- Let the `code`/`hints` localize the cause (`INVALID_FILLET_RADIUS` → reduce radius vs local edge
  length; `*_NOT_3D` → you passed a 2D shape to a 3D op; `BOOLEAN_HAS_ERRORS` → inputs
  overlap-degenerate).
- A part that _runs_ but reports `ok:false` is wrong, not done. Treat it like a crash.

## Asserting expected codes (for fixtures / eval)

`brep verify part.brep.ts --expect-code <CODE>` exits 0 only if the report emits `<CODE>`;
`--expect-invalid` exits 0 only if `ok:false`. Use these to assert that a known-bad part fails the
_right_ way.

## CLI subcommands (the `brep` bin)

- `verify <files...>` (default): report; flags `--check`, `--json [path|-]`, `--step`, `--glb`,
  `--snapshot <dir>`, `--serve`, `--no-open`, `--expect-code <CODE>`, `--expect-invalid`. One file →
  the full report (all flags). Multiple files or a quoted glob (`brep verify "parts/*.brep.ts"`) →
  a validity-only JSON array, exit 1 if any part is invalid (single-file artifact flags are ignored).
- `snapshot <file> [--label <tag>]`: render iso/front/top/right PNGs without re-verifying.
- `init <name>`: scaffold `<name>.brep.ts` + `tsconfig.json`.
- `watch <file>`: re-verify on every save.
- `export <file>`: batch STEP/GLB/STL behind a validity gate (`--step`/`--glb`/`--stl`/`--all`).
- `measure <a> [b]`: measurements for one part, or distance between two.
- `diff <a> <b>`: compare two parts' measurements.

Wersje

RepozytoriumWynikLicencja
Ta strona · andymai/brepjs100Apache-2.0
yonatangross/orchestkit100MIT
yonatangross/orchestkit100MIT
NolwennD/gabier100Apache-2.0
ericrisco/rsc-harness100MIT
sentimony/agentic-workflow100MIT
JoDi-27/JoDi-SDD100MIT
marcel-bich/marcel-bich-claude-marketplace100MIT
kdlbs/kandev100AGPL-3.0

Migawka bazy z 13.11.2026 · wersja paczki 2f2252c00704 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100brepjs-verify
    Sprawdza część brepjs przez raport JSON i zdjęcia, prowadzi naprawę najmniejszej odpowiedzialnej sekcji i decyduje, czy część jest gotowa.
  • 100implement
    Pomaga pisać i edytować części brepjs .brep.ts w funkcyjnym API: geometria, blok expected, reguły importu, a także budynki, BIM i IFC przez warstwę rodzin.
  • 100kernelcad-fields
    Tworzy pola odległości ze znakiem (SDF): kule, pudełka, walce, torusy, gładkie łączenia i materializację, do organicznych kształtów, do których nie sięga fillet BREP.
  • 100freecad
    Skryptuje FreeCAD 1.1.4 w Pythonie lub w trybie headless: modelowanie BREP w Part i PartDesign, ograniczenia Sketcher, Arch/BIM i IFC, TechDraw, CAM, FEM i eksport do STEP.
  • 100chili3d
    Pomaga budować przeglądarkowy parametryczny CAD na Chili3D: wiązania chili-wasm do Open CASCADE, wtyczki .chiliplugin, import i eksport STEP, IGES, BREP i STL oraz błędy ładowania WASM.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.