使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/brentvatne/design-3d-prints --skill 3d-print-design开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
3D Print Design Skill
Gather requirements and create formal specifications for 3D printable objects before implementation.
📋 Use this skill first, then hand off tocadquery(preferred) oropenscadfor implementation.
Design Process Overview
┌──────────────────────────────────────────────────────────────────────────────┐
│ 1. REQUIREMENTS → 2. SPECIFICATION → 3. TEST PLAN → 4. IMPLEMENT │
│ (this skill) (this skill) (this skill) (cadquery) │
└──────────────────────────────────────────────────────────────────────────────┘Do not skip phases. Each phase must be completed and approved before proceeding.
Phase 1: Requirements Gathering (MANDATORY)
Before ANY design work, use the AskUserQuestion tool to gather requirements. Ask too many questions rather than making assumptions.
⚠️ DO NOT SKIP ROUNDS. Each round covers essential aspects of the design: - Rounds 1-2: Structure type and device fit - Round 3: Support configuration - Round 4: Construction (wall thickness AND corner style) ← Often skipped, causes poor edge finishing - Round 5: Printer constraints Skipping Round 4 leads to models with sharp edges that are uncomfortable to handle.
How to Prompt
Use AskUserQuestion with 2-4 focused questions per round. Group related questions together. Continue until all requirements are gathered.
For Stands/Holders/Cradles
Round 1 - Device & Orientation:
Question: "What device is this stand for?"
Options: [User describes device] → Follow up to get exact W × D × H dimensions
Question: "Should the device be tilted?"
Options: ["Flat (0°)", "Slight tilt (5-10°)", "Ergonomic tilt (12-15°)", "Steep (20°+)"]Round 2 - Stand Architecture:
Question: "What type of stand structure?"
Options: [
"Tray/Enclosure - box with hollow interior, device sits on top (Recommended for storage underneath)",
"Open Frame - legs or rails with device resting on shelves (lighter, device visible)",
"Platform - solid base slab with lip around edges (simple, heavy)"
]
→ If "Open Frame", proceed to leg style question below
→ If "Tray/Enclosure", skip to Round 3
→ If "Platform", skip to Round 4Round 2b - Leg Style (Open Frame only):
Visualize options with ASCII diagrams:
SIDE RAILS / SLED BASE CORNER POSTS
───────────────────────── ─────────────────────────
┌─────────────┐ ┌─────────────┐
│ device │ │ device │
────┴─────────────┴──── ────┴──┐ ┌──┴────
│▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ │▓▓│ │▓▓│
│▓▓▓ LEFT RAIL ▓▓▓│ │▓▓│ │▓▓│
════════════════════════ ════════════════════════
(continuous runners (4 discrete posts,
along each side) minimal material)
A-FRAME / EASEL PERIMETER FRAME
───────────────────────── ─────────────────────────
╱─────────╲ ┌─────────────┐
╱│ device │╲ │ device │
╱ └─────────┘ ╲ ────┴─────────────┴────
╱▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓╲ │▓▓│ │▓▓│
╱▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓╲ │▓▓└─────────────┘▓▓│
════════════════════════ ════════════════════════
(triangular profile, (thin rectangular frame,
good for displays) modern floating look)Question: "What leg/base style for the open frame?"
Options: [
"Side Rails - two continuous runners, device spans between (Recommended for two-piece printing)",
"Corner Posts - four discrete legs at corners (minimal, device visible from all sides)",
"A-Frame - triangular easel style (good for displays, tablets)",
"Perimeter Frame - rectangular base frame with corner posts (modern, floating look)"
]
→ If "Side Rails", follow up: "Should rails include crossbars for extra rigidity?"
→ If "Corner Posts", follow up: "Post style: straight, tapered, or splayed outward?"Round 3 - Support Configuration:
Question: "How should the device be held in place?"
Options: [
"Shelf on all sides with front lip (most secure)",
"Shelf on sides, open back for cables",
"Minimal - just corners",
"Let me specify each side"
]
→ If "specify each side", ask about front/back/left/right individuallyRound 3 - Interior & Features:
Question: "Does the stand need hollow interior storage?"
Options: ["No - solid base", "Yes - for batteries/cables", "Yes - for specific items"]
→ If yes, ask what goes inside with dimensions
Question: "What openings are needed?"
Options: ["Cable hole in back", "Ventilation slots", "USB/power access", "None", "Multiple"]Round 4 - Construction:
Question: "How sturdy should this be?"
Options: [
"Light duty (3mm walls) - decorative, light devices",
"Standard (5mm walls) - most devices (Recommended)",
"Heavy duty (8mm walls) - heavy equipment"
]
Question: "Corner style?"
Options: ["Rounded (8mm) - comfortable grip", "Subtle (3-5mm)", "Sharp - industrial look"]Round 5 - Printer:
Question: "What printer will you use?"
Options: ["Bambu P2S (256mm) (Recommended)", "Bambu P1S/A1 (256mm)", "Prusa MK4 (250×210mm)", "Ender 3 (220mm)", "Other"]For Boxes/Enclosures
Round 1: What needs to fit inside? (get dimensions) Round 2: Lid type? (none, removable, hinged, sliding) Round 3: Wall thickness and mounting method? Round 4: Which sides need openings?
For Brackets/Mounts
Round 1: What's being mounted? (dimensions, weight) Round 2: Mounting surface? (wall, desk, pole) + attachment method? Round 3: Load direction? (hanging, resting, cantilevered) Round 4: Fixed or adjustable?
For Cable Management
Round 1: Cable diameter(s) and quantity? Round 2: Entry/exit configuration? Round 3: Mounting method? (adhesive, screw, clip-on)
When Users Ask for Clarification
If a user asks to clarify options or doesn't understand a choice, visualize with ASCII side-view diagrams. This is especially helpful for:
- Tilt angle options
- Slope compensation choices
- Shelf vs lip configurations
- Interior hollow space options
Example - Visualizing tilt/slope options:
OPTION 1: Add tilt on top (stand tilt + device slope)
─────────────────────────────────────────────────────
___
___/ | ← device
___/▓▓▓▓▓▓▓|
___/▓▓▓▓▓▓▓▓▓▓▓|
|▓▓▓▓▓▓ STAND ▓▓▓|
════════════════════════════════════════════ ← desk
OPTION 2: Compensate to level
─────────────────────────────
_____________________
| device (level) |
|▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓|
\▓▓▓▓▓ STAND ▓▓▓▓▓▓▓/
════════════════════════════════════════════ ← deskExample - Visualizing shelf vs lip:
SHELF (supports from below) LIP (retains from side)
───────────────────────────── ─────────────────────────
┌─────────┐ ┌─────────┐
│ device │ │ device │▌← lip
└────┬────┘ └─────────┘
▓▓▓▓▓▓▓▓▓▓▓ ← shelf ▓▓▓▓▓▓▓▓▓▓▓Include a summary table after the diagrams showing key differences between options.
Phase 2: Formal Specification (MANDATORY)
After gathering requirements, present a formal spec for user approval. DO NOT proceed to implementation until the spec is approved.
Specification Template
# [Object Name] - Design Specification
## Overview
| Field | Value |
|-------|-------|
| Object | [Name] |
| Type | Stand / Box / Bracket / Mount / Other |
| Architecture | Tray/Enclosure / Open Frame / Platform |
| File | `[filename].py` |
## Device/Contents
| Parameter | Value |
|-----------|-------|
| Model | [Device name] |
| Width | ___ mm |
| Depth | ___ mm |
| Height | ___ mm |
| Weight | ___ kg |
| Clearance | ___ mm (default: 0.5) |
## Stand Geometry (if applicable)
| Parameter | Value | Derivation |
|-----------|-------|------------|
| Tilt angle | ___° | User specified |
| Front height | ___ mm | User specified |
| Back height | ___ mm | front_height + depth × tan(tilt) |
| Stand width | ___ mm | device_width + clearance×2 + wall×2 |
| Stand depth | ___ mm | device_depth + clearance×2 + wall×2 |
## Open Frame Structure (if Architecture = Open Frame)
| Parameter | Value |
|-----------|-------|
| Leg style | Side Rails / Corner Posts / A-Frame / Perimeter Frame |
| Leg/rail thickness | ___ mm |
| Crossbars | Y/N (if side rails) |
| Post shape | Straight / Tapered / Splayed (if corner posts) |
## Side Configuration
| Side | Shelf | Lip | Shelf Width | Lip Height |
|------|-------|-----|-------------|------------|
| Front | Y/N | Y/N | ___ mm | ___ mm |
| Back | Y/N | Y/N | ___ mm | ___ mm |
| Left | Y/N | Y/N | ___ mm | ___ mm |
| Right | Y/N | Y/N | ___ mm | ___ mm |
## Interior
| Parameter | Value |
|-----------|-------|
| Hollow | Y/N |
| Shape | [Description] |
| Contents | [What goes inside, with dimensions] |
## Features
| Feature | Enabled | Specification |
|---------|---------|---------------|
| Cable hole | Y/N | ___×___mm, location, corner radius |
| Ventilation | Y/N | [Description] |
| Mounting holes | Y/N | [Description] |
| Other | Y/N | [Description] |
## Construction
| Parameter | Value |
|-----------|-------|
| Wall thickness | ___ mm |
| Floor thickness | ___ mm |
| Corner radius | ___ mm |
| Bottom chamfer | 0.5 mm (elephant foot) |
| Pocket fillet | 3 mm (stress relief) |
## Printer
| Parameter | Value |
|-----------|-------|
| Target printer | [Name] |
| Bed size | ___ × ___ × ___ mm |
| Model footprint | ___ × ___ mm |
| Fit check | ✓/✗ |After presenting the spec, ask: "Does this specification match what you want? Please review each section."
Phase 3: Validate Spec Completeness
Before implementation, verify the spec is complete:
Checklist
- [ ] All dimensions specified (no "TBD" or blanks)
- [ ] Clearances defined for moving/fitted parts
- [ ] Wall thickness appropriate for load
- [ ] Corner radii specified
- [ ] All features listed with dimensions
- [ ] Printer fit verified
- [ ] Interior contents fit verified (if hollow)
Common Spec Gaps
| Missing | Impact | Resolution |
|---|---|---|
| Clearance not specified | Parts won't fit | Ask: "How tight should the fit be?" |
| No corner radius | Sharp edges uncomfortable | Default to 3-5mm |
| Wall thickness unclear | Strength unknown | Ask about load requirements |
| Cable hole unspecified | Cables can't route | Ask about cable access |
Manufacturing Constraints
Minimum Wall Thickness
| Application | Minimum | Recommended |
|---|---|---|
| Decorative | 0.8 mm | 1.2 mm |
| Functional | 1.2 mm | 2.0 mm |
| Structural | 1.6 mm | 2.4 mm |
| Load-bearing | 2.4 mm | 3.2 mm |
Tolerances
| Fit Type | Clearance | Use Case |
|---|---|---|
| Loose | 0.4-0.6 mm | Easy insertion, rattles OK |
| Free | 0.2-0.3 mm | Smooth sliding fit |
| Close | 0.1-0.15 mm | Snug fit, slight friction |
| Press | -0.05 mm | Interference fit |
Overhang Limits
- Maximum overhang without supports: 45°
- Bridging limit: ~50mm (printer dependent)
- Minimum hole diameter: 2mm (horizontal), 1mm (vertical)
Chamfers and Fillets
| Location | Type | Size | Purpose |
|---|---|---|---|
| Bottom edges | Chamfer | 0.5 mm | Elephant foot prevention |
| Top edges | Chamfer | 0.3-0.8 mm | Chip prevention |
| Inside corners | Fillet | 2-3 mm | Stress relief |
| Outside corners | Fillet | 3-8 mm | Grip comfort, aesthetics |
Phase 4: Test Plan (MANDATORY)
Before implementation, create a test plan that will validate the final model. Include this in the spec file.
Test Plan Template
## Test Plan
### Geometry Validation (run in code)
1. Overall dimensions match spec (width, depth, height ±0.1mm)
2. Device pocket dimensions correct
3. All specified features present (shelves, lips, holes, etc.)
4. Model is watertight (valid solid)
### Fit Tests (visual/measurement)
1. Device fits in pocket with specified clearance
2. Ghost object shows correct placement
3. No interference between device and stand geometry
### Printability Tests (in slicer)
1. Each part fits on print bed
2. No unsupported overhangs > 45°
3. No bridging spans > 50mm
4. Layer orientation appropriate for load direction
### Assembly Tests (if multi-part)
1. Parts align correctly when joined
2. Snap-fits / tabs engage properly
3. Seam is flush (no step or gap)
### Functional Tests (post-print)
1. Device sits at correct angle
2. Device doesn't slide or tip
3. Cables can route as designed
4. Stand is stable on desk (doesn't rock)Test Categories by Stand Type
Tray/Enclosure stands:
- Interior hollow space dimensions
- Contents fit inside without interference
- Shelf supports device at correct height
- Cable holes accessible
Open Frame stands:
- Rails/legs provide stable support
- No flex under device weight
- Open areas don't compromise rigidity
- Joints between parts are strong
Multi-piece designs:
- Each piece prints flat without supports
- Assembly method works (snap-fit, bolts, etc.)
- Assembled stand is rigid (no wobble at seams)
Handoff to Implementation
Once spec AND test plan are approved, hand off to implementation:
✅ Spec approved + Test plan defined → Use `cadquery` skill (PREFERRED)
or `openscad` skill (if explicitly requested)The implementation skill will receive the spec and generate code with validation functions that check the test plan items.