Files
likang 678058c940
CI / Select checks (push) Has been cancelled
CI / Format and repository checks (push) Has been cancelled
CI / Compile RISC-V (manual) (push) Has been cancelled
Docker / image (push) Has been cancelled
Generated files / Regenerate and commit (push) Has been cancelled
Kernel rig / Select the rig areas (push) Has been cancelled
Lists / Design format changes merge cleanly (push) Has been cancelled
Lists / Lists are sorted one item per line (push) Has been cancelled
Packaging lint / lint (push) Has been cancelled
Pages / build (push) Has been cancelled
CI / Dependency advisories (push) Has been cancelled
CI / Quick compile (push) Has been cancelled
CI / Native Linux Clippy (push) Has been cancelled
CI / Build tests (push) Has been cancelled
CI / Native Linux tests (push) Has been cancelled
CI / GPU path tests (1/4) (push) Has been cancelled
CI / GPU path tests (2/4) (push) Has been cancelled
CI / GPU path tests (3/4) (push) Has been cancelled
CI / GPU path tests (4/4) (push) Has been cancelled
CI / Action matrix (1/16) (push) Has been cancelled
CI / Action matrix (10/16) (push) Has been cancelled
CI / Action matrix (11/16) (push) Has been cancelled
CI / Action matrix (12/16) (push) Has been cancelled
CI / Action matrix (13/16) (push) Has been cancelled
CI / Action matrix (14/16) (push) Has been cancelled
CI / Action matrix (15/16) (push) Has been cancelled
CI / Action matrix (16/16) (push) Has been cancelled
CI / Action matrix (2/16) (push) Has been cancelled
CI / Action matrix (3/16) (push) Has been cancelled
CI / Action matrix (4/16) (push) Has been cancelled
CI / Action matrix (5/16) (push) Has been cancelled
CI / Action matrix (6/16) (push) Has been cancelled
CI / Action matrix (7/16) (push) Has been cancelled
CI / Action matrix (8/16) (push) Has been cancelled
CI / Action matrix (9/16) (push) Has been cancelled
CI / Action matrix determinism (push) Has been cancelled
CI / Property tests (many cases) (push) Has been cancelled
CI / Doc tests (push) Has been cancelled
CI / Reference tests (push) Has been cancelled
CI / Windows D3D12 FXC shaders (push) Has been cancelled
CI / Windows app startup (push) Has been cancelled
CI / ci (push) Has been cancelled
CI / Compile WebAssembly (push) Has been cancelled
CI / Nightly alert (push) Has been cancelled
Kernel rig / Build the CLI (push) Has been cancelled
Kernel rig / Kernel rig (${{ matrix.shard }}) (push) Has been cancelled
Kernel rig / kernel-rig (push) Has been cancelled
Pages / deploy (push) Has been cancelled
优化skill
2026-11-16 11:32:34 +08:00

3.3 KiB

name, description
name description
makecad-agent-tools Use when running makeCAD to see a change working, driving it through the control channel or CLI, or adding or changing an MCP tool, control method or bundled agent skill.

Running the app, the control channel and MCP tools

Run it and look at it

  • cargo run --release -p solidcraft -- --sample --control PORT starts the sample design with the control channel. Pick a free port. With no display, run it under Xvfb :99 with DISPLAY=:99.
  • Talk JSON lines to 127.0.0.1:PORT (docs/control-protocol.md). The first request on a connection carries the launch token as "token": read it from ~/.local/share/solidcraft/control/PORT.token, or start the app with SOLIDCRAFT_CONTROL_TOKEN=$(openssl rand -hex 32) and send that. Never paste the token into a PR or issue.
    • {"id":1,"method":"engine.execute","params":{"command":"solid.extrude","params":{"distance":20}}}
    • {"id":2,"method":"ui.start","params":{"command":"sketch.create"}}, then ui.click {x, y}
    • {"id":3,"method":"ui.screenshot","params":{"path":"/tmp/shot.png"}}, then read the PNG
  • For UI work, look at the result. Without a window use ui.render or solidcraft-cli snapshot.
  • Headless: solidcraft-cli run script.json --out part.step, solidcraft-cli eval design.sc, solidcraft-cli snapshot script.json --out shot.png, solidcraft-cli commands.
  • Build with CARGO_TARGET_DIR=<repo>/target.

MCP tools

The server is solidcraft-cli mcp (crates/mcp/src/, docs/mcp.md). Tools are defined in crates/mcp/src/tools.rs; keep docs/mcp.md in step, and keep tool annotations (read-only, destructive) honest.

  • Anything the user can do is a command; add a command, not a new tool, unless the tool is about the session itself (open, save, screenshot, batch).
  • Files: tools reach only the allowed folders (the design's folder, the recovery folder, the scratch folder, --allow-path). Do not widen this casually; paths are resolved before comparing, so .. and links leaving the allowed set are refused, and on Windows UNC and device paths are refused.
  • Replies stay small: verbose: false, no unfiltered command catalogue or topology dumps.
  • The control channel is a local-only interface with a token. A new method needs an entry in docs/control-protocol.md; long work follows skills/makecad-performance/SKILL.md.

Bundled agent skills

All 17 skills and their text resources are embedded at build time by crates/mcp/build.rs for the read-only skill_reference tool. skills/agent-workflow.md is the shared generation workflow for MCP, the desktop assistant and the hosted Java gateway. Repository-only instructions do not grant the browser filesystem or shell capabilities.

  • When a command, parameter name or behaviour those skills describe changes, update them in the same PR. skills_name_only_real_tools_and_commands in crates/mcp/src/tests.rs fails when a skill names a tool or command that is gone.
  • Adding a skill or text resource embeds it automatically. Run node scripts/sync-cad-ai-skills.mjs <community-root> to update the Java package and rerun with --check to detect drift; rebuild WASM and Java together.
  • skills/README.md explains the layout and the other tests; cargo xtask skills checks that AGENTS.md and every SKILL.md cite real paths, commands and skills.