新增cdsl

backend/agent/skills/cad-engine/references/part-skills/source/atomic/through-hole-cut.atomic.md

@@ -0,0 +1,89 @@
+# Through Hole Cut Atomic Skill
+
+## When to use
+
+- A part needs a clean circular hole or bore that passes fully through a plate, block, bracket wall, flange, washer, spacer, or boss.
+- The request mentions through hole, clearance hole, central hole, circular opening, bore through, or cut through all.
+
+## Do not use when
+
+- The hole is threaded, counterbored, countersunk, or a bearing seat requiring special geometry.
+- The circular feature is a blind pocket, groove, decorative recess, or non-through relief.
+- The hole is part of a patterned bolt circle; combine with the pattern skill for repeated holes.
+
+## Recognition features
+
+- Circular sketch on a planar face followed by Cut-Extrude or HoleWzd through all.
+- Cylindrical internal face runs through the full thickness.
+- Used for clearance, alignment, lightening, shaft passage, or central opening.
+
+## Core invariants
+
+- Hole axis should be normal to the face or coaxial with the main part axis.
+- Use through-all end condition when the hole must pass through the entire body.
+- Keep hole diameter and placement explicit.
+- For central holes, use the part axis or centerline as the placement reference.
+- For repeated holes, make one seed through hole and pattern it.
+
+## Parameter roles
+
+- `hole_diameter` defines opening size.
+- `placement_point` defines center on the start face.
+- `axis` defines coaxial central placement when needed.
+- `end_condition` is usually through all.
+- `face` defines the start plane.
+
+## Construction sequence
+
+1. Select the face or reference plane where the hole starts.
+2. Place a circle center from datums, centerlines, or the main axis.
+3. Sketch the circle with the required diameter.
+4. Cut through all material in the intended direction.
+5. Pattern or mirror the through-hole cut if repeated.
+6. Add hole edge chamfers only after the cut exists.
+
+## Common failures
+
+- Creating a shallow blind pocket when a through hole is required.
+- Leaving a sketch circle without cutting material.
+- Placing a central hole off-axis.
+- Treating threaded/counterbored/bearing holes as plain through holes.
+- Cutting through unintended bodies in an assembly-like model.
+
+## Evidence summary
+
+- Latest run evidence: 49 accepted atomic insights matched through-hole and circular-cut creation.
+- Strong repeated names include `create_through_hole`, `cut_circular_hole`, `cut_circle`, `cut_central_bore_through_plate`, and `create_through_holes_with_cut`.
+- Frequent operations in the latest run: Cut, HoleWzd, CircularPattern, LinearPattern, Chamfer.
+- Source model examples: 001563, 001942, 046907, 054633, 059866, 080145, 086131, 096474, 142955, 148675, 153729, 160077, 222192, 230562, 241179.
+- Source: CAD-SkillX offline review of SCAD58 descriptions, STEP summaries, and SolidWorks feature evidence.
+
+## Retrieval metadata
+
+Triggers:
+- `through hole`
+- `clearance hole`
+- `central hole`
+- `circular opening`
+- `cut through`
+- `bore through`
+
+Secondary triggers:
+- `shaft passage`
+- `alignment hole`
+- `lightening hole`
+- `hole through plate`
+- `hole through boss`
+
+Operation triggers:
+- `cut extrude through all`
+- `cut circle`
+- `hole wizard through hole`
+- `pattern through hole`
+
+Exclusions:
+- `threaded hole`
+- `counterbored hole`
+- `countersink`
+- `bearing seat`
+- `blind pocket`