bambu-3mf

Natural-language Bambu .3mf edits via Codex.
Best for same-plate parameter sweeps.

This skill inspects, validates, and edits Bambu Studio flavored .3mf files with schema-aware safeguards.

What it does

• Inspects .3mf archive layout and Bambu metadata.
• Extracts enum/default/legacy/substitution rules from local BambuStudio source.
• Validates Metadata/project_settings.config in warn-only mode.
• Applies object-level process overrides for sweep workflows.
• Re-packs .3mf archives deterministically.

Guardrails

• Validate before edits (warn-only by default).
• Use stored enum values, not display labels.
• Preserve unknown files and unknown keys unless explicitly asked to remove them.

Quickstart

From this repository root:

python3 scripts/inspect_3mf.py /path/model.3mf
python3 scripts/build_references.py --repo /path/to/BambuStudio
python3 scripts/validate_project_settings.py --input /path/model.3mf --repo /path/to/BambuStudio

Optional environment variables:

• BAMBUSTUDIO_REPO: default source path for extract/build commands.
• BAMBU_3MF_GEN_DIR: default generated reference output directory.

Parameter sweep workflow

1. Prepare a .3mf with all sweep objects on one plate.
2. Create overrides JSON keyed by object id.
3. Apply overrides with:

python3 scripts/apply_object_process_overrides.py \
  --input /path/in.3mf \
  --overrides /path/overrides.json \
  --output /path/out.3mf

4. Open in Bambu Studio and verify Process -> Objects.

Repository layout

• SKILL.md: Codex skill behavior and safety rules.
• scripts/: CLI tools.
• references/: static references + generated snapshot.
• agents/openai.yaml: skill interface metadata.

Testing

Unit checks (uses committed generated snapshot if present):

python3 scripts/test_generated_knowledge.py --mode unit

End-to-end check (requires a sample .3mf):

python3 scripts/test_generated_knowledge.py --mode e2e --cube /path/sample.3mf --repo /path/to/BambuStudio