version: "1.0.0" name: subd-spike description: SubD 자유곡면 애드인(Power Surfacing류) 프로젝트의 P0-a 검증 스파이크를 돌린다. all-quad 정규위상 SubD를 bicubic B-spline 패치로 변환→OCCT 봉합→워터타이트 STEP 출력→자체 무결성 검증(자유엣지 0·닫힌 솔리드). "subd 스파이크", "P0 테스트", "워터타이트 step 검증", "서브디비전 변환 테스트" 시 호출. /subd-spike 로 실행. triggers:

• "subd 스파이크"
• "subd spike"
• "P0 테스트"
• "P0-a"
• "워터타이트 step 검증"
• "서브디비전 변환 테스트"

args:

• name: n

description: 면당 제어점 격자 크기(>=4). 곡률 해상도. 기본 6 required: false

• name: bulge

description: 내부 제어점 외향 팽창량(곡률 세기). 기본 0.35 required: false

• name: half

description: 큐브 반변 길이[mm]. 기본 10 required: false

• name: tol

description: 봉합 tolerance[mm]. 기본 1e-4 required: false

subd-spike — SubD → 워터타이트 STEP 검증 스파이크 (P0-a)

SubD 자유곡면 애드인 프로젝트(설계: ~/subd-addin/docs/DESIGN.md)의 B기둥 하류 리스크를 검증한다. OpenSubdiv 포럼이 실패한 "패치 워터타이트 봉합"을, D2 all-quad 제약 하에서 정면 테스트.

전제

• cadquery-ocp(OCP, 풀 OpenCASCADE Python 바인딩)가 설치돼 있어야 함.
• 확인: python3 -c "import OCP; print('ok')"
• 없으면: pip install cadquery-ocp
• 정본 스크립트: ~/subd-addin/spike/subd_spike.py

실행 (Claude가 수행)

1. args가 있으면 플래그로 전달해 실행:

`` python3 ~/subd-addin/spike/subd_spike.py [--n N] [--bulge B] [--half H] [--tol T] [--out PATH] `` 기본값만이면 인자 없이 실행.

1. 출력의 C4-mac 판정 블록을 그대로 표로 정리해 보고:

• 자유엣지 0 / BRepCheck 유효 / 닫힌 솔리드 / STEP 출력 → 각 PASS·FAIL
• 종합 ✅/❌
• STEP 경로·크기

1. 반드시 명시(과대주장 금지): 이 스파이크는

• ✅ 증명: "엣지일치 bicubic 패치 → OCCT 워터타이트 봉합 → STEP" 하류 파이프라인.
• ❌ 미증명: ① 실제 SubD 케이지에서 엣지일치 패치를 뽑는 변환기(P1/P2) ② SW가 실제로 여는지(C4-full = Windows+SolidWorks 필요, P0-b).

1. FAIL 시: 자유엣지>0이면 tol을 키워(예 1e-3) 재시도하거나 패치 엣지일치 로직 점검 안내. 판정은 무손실로 보고(G12: 실제 출력 대조).

주의

• 이 스킬은 맥에서 도는 엔진검증이다. C4-full(SW 오픈)은 별도 윈도우 단계(P0-b).
• 판정 수치(자유엣지·엔티티수)는 실제 실행출력 그대로 — 날조 금지.