菜单
Use when a valid brepjs part should look designed rather than glued-from-primitives (products, toys, mechanisms, anything a human eyeballs), and when exporting/handing off the result — the polish pass plus STEP/GLB/STL export. Skip for purely functional or internal parts.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/andymai/brepjs --skill polish命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Use when authoring or editing a brepjs `.brep.ts` part — writing the geometry with the functional API (box, cylinder, fuse, cut, fillet, sketch→extrude…), declaring an `expected` block, and following the hard rules (import every function, unwrap Results, select edges, coordinate semantics). Also covers buildings/BIM/IFC via the declarative family layer (references/families-bim.md). This is the authoring step; pair it with brepjs:verify to check the result.
This skill should be used when adding, editing, or fixing an example in apps/playground — when a task says "add a playground example", "example fails check:examples", "playgroundExamples.test.ts is failing", "regenerate ambient types", "generate-types", "example thumbnail is missing", "run npm run thumbs", "example renders wrong / blank viewer", "example works in tests but breaks in the browser", or when a new example needs to pass its three gates (types, geometry, thumbnail) before merge.
This skill should be used when orienting in the brepjs monorepo's packages/ and apps/ directories — answering "what is brepjs-viewer / brepjs-cad / brepjs-voxel", "is package X published", "which workspace do I edit", "why does npm ci fail with ETARGET on a workspace version-range", "playground shows stale behavior from brepjs-bim/sheetmetal", "in what order do I build the packages", "Dependabot flags a workspace `*` dependency", "add a new workspace package", or deciding how a change in one package ripples into its consumers.
基于 SOC 职业分类
正在显示 SKILL.md
| name | polish |
| description | Use when a valid brepjs part should look designed rather than glued-from-primitives (products, toys, mechanisms, anything a human eyeballs), and when exporting/handing off the result — the polish pass plus STEP/GLB/STL export. Skip for purely functional or internal parts. |
| version | 0.1.0 |
A valid part is not always a designed part. A lumpy stack of overlapping primitives still reports
ok:true, so validity never catches it. Run this when the part should look manufactured; skip it
for purely functional/internal geometry. The CLI ships in the brepjs-cad package as brep.
Render iso + a detail view (brep snapshot part.brep.ts) and critique: manufactured, or
glued-from-primitives? Fix the worst offender:
Prefer additive detail — fins, gussets, lightening holes, grooves, a flush rounded end — over
the failure-prone fillet/chamfer ops. Re-verify (ok stays true), re-render, repeat on the next
worst offender. Detail and rationale: references/design-polish.md.
A no-op is a valid outcome. If the part already reads as manufactured, the worst remaining offender is minor, or the only available edit is marginal, make NO edit, report the part as already-designed, and proceed to export. A marginal addition usually ties or loses against the un-touched render (it reads as decoration noise) — do not edit just to satisfy the loop. Only edit when the offender is a clear primitive-blob, mismatched cap, raw rim, or missing functional feature a human would notice.
A polish edit must never break validity: if a round/blend pushes the part to ok:false, revert it
and choose an additive alternative.
brep verify part.brep.ts --step part.step
STEP is the validated primary deliverable; GLB/STL are derived. Batch behind a validity gate with
brep export part.brep.ts --all. --serve prints a clickable link to an interactive inspector
(view presets, solid/wire/x-ray, face picking, section plane, measurements) for the human to eyeball
— report that URL. Under agent/CI (non-TTY) auto-open is suppressed automatically. Report the STEP
path. Export formats and options: references/export.md.