circuit-json-analysis
Analyzes Circuit JSON files for structural component relationships, domain mappings (source, schematic, pcb, cad), and geometric layout DRC violations (courtyard overlaps, solder paste misalignments, pad clearances). Trigger this skill whenever analyzing a circuit.json file, inspecting PCB placement, or performing design rule checks on Circuit JSON data.
- License 许可
- GPL-2.0
- 最近更新
- 2026-08-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- circuit-json-analysis
- description
- Analyzes Circuit JSON files for structural component relationships, domain mappings (source, schematic, pcb, cad), and geometric layout DRC violations (courtyard overlaps, solder paste misalignments, pad clearances). Trigger this skill whenever analyzing a circuit.json file, inspecting PCB placement, or performing design rule checks on Circuit JSON data.
02 资源文件 3
- 参考文档manifest.json112 B
- 参考文档references/circuit_json_schema.md2.7 KB
- 脚本tools/analyze_circuit.py4.7 KB
03 SKILL.md 正文
Circuit JSON Analysis Skill
This skill provides step-by-step guidance and deterministic tooling for inspecting, validating, and performing Design Rule Checks (DRC) on circuit.json files.
1. Operational Knowledge
The core diagnostic executable for this capability is bundled in the tools/ directory.
Running Analysis & DRC
Execute the automated analysis tool against a target circuit.json file:
python3 tools/analyze_circuit.py path/to/circuit.json
The tool produces a diagnostic report containing:
- Summary: Element counts by domain prefix (
source_,schematic_,pcb_,cad_). - Component Mapping: Inter-domain structural links between
source_componentandpcb_component. - Overlap Issues: Precise bounding-box overlaps in courtyards (
pcb_courtyard_rect) and solder paste stencil layers (pcb_solder_paste). - DRC Warnings & Errors: Built-in warning/error objects contained within the Circuit JSON.
2. Reasoning Guidance
When inspecting or diagnosing Circuit JSON layout artifacts:
Deep Domain Knowledge Reference
Refer to references/circuit_json_schema.md for in-depth structural models, domain prefix definitions (source_, schematic_, pcb_, cad_), and foreign key hierarchies.
Structural Integrity Rules
- Source Domain: Every logical component MUST have a unique
source_component_id. Associatedsource_portitems referencesource_component_id. - PCB Domain: Every physical footprint (
pcb_component) MUST link tosource_component_id. Sub-geometries (pcb_smtpad,pcb_solder_paste,pcb_silkscreen_*,pcb_courtyard_*) MUST link to their parentpcb_component_id. - CAD Domain: 3D models (
cad_component) MUST reference bothpcb_component_idandsource_component_id.
Diagnostic Decision Flow
- Courtyard Overlaps: Indicates physical collisions between components on the board layout.
- Solder Paste Overlaps at Origin
(0,0): Indicates unapplied coordinate transformation matrices (child elements remain at local origin instead of world coordinates). - Unconnected Pins: Search for
source_pin_missing_trace_warningobjects in the JSON payload.
3. Workflow Instructions
Follow this standard procedure when working with Circuit JSON:
- Step 1: Automated DRC Run
Runpython3 tools/analyze_circuit.py <path_to_circuit.json>to capture immediate layout issues. - Step 2: Relational Hierarchy Validation
If errors are reported, consultreferences/circuit_json_schema.mdto verify missing foreign key references or unlinked components. - Step 3: Geometry & Clearance Inspection
Check generated DRC warnings for courtyard overlaps, pad clearance errors, or unmappedpcb_componentinstances.
4. Verification
An agent must verify the following criteria to confirm successful execution and validity of a circuit.json file:
- Zero Courtyard Overlaps: Confirm
overlap_issuessection in the output oftools/analyze_circuit.pycontains 0courtyard_overlaperrors. - Zero Solder Paste Misalignments: Confirm no
solder_paste_overlaperrors exist at(0, 0). - Valid Domain Mappings: Ensure all
source_componentobjects have correspondingpcb_componentobjects assigned. - Clean DRC Log: Verify
drc_warnings_errorslist contains no unresolved critical errors.
04 同仓库更多 Skills
cypress-tuning
Systematically diagnoses, tunes, and executes Cypress GPU-accelerated PCB placement optimization runs. Trigger when running DREAMPlace/Cypress component placement, diagnosing placement divergence or clumping, or tuning wirelength, density, rotation, and net crossing parameters.
circuitjson-bookshelf-converter
Converts Circuit JSON PCB and schematic designs into Bookshelf physical design format (.nodes, .nets, .pl, .scl, .aux) with courtyard keep-out boundary modeling, and back-annotates Cypress placement optimization results back into Circuit JSON. Trigger this skill whenever converting circuit.json files to Bookshelf format or back-annotating .pl / .gp.pl placement outputs into Circuit JSON.
vhl-concepts
Architectural foundation for Virtual Hardware Laboratory (VHL). Explains the four fundamental VHL concepts (Module vs Assembly, Interface Boundary, Git Worktree Workspace Isolation, and Shared Circuit Understanding Document), why VHL uses them, their core invariants, and when an agent must reason about them. Trigger this skill whenever reasoning about VHL architecture, defining boundaries, identifying module/assembly scope, or referencing SCUD artifacts.
SCUD
暂无简介
Module_Synthesis
暂无简介
Boundary_Reconciliation
暂无简介