kukucaicndy/embedded_ai_skills/easyeda-draw

Name: easyeda-draw
Author: kukucaicndy

Claude Code and agent skill by kukucaicndy/embedded_ai_skills

Trust tier 3

community

Source check pending

Checking that the SKILL.md file is still in the repository.

Draw and layout schematics in EasyEDA Pro. Invoke when user asks to draw circuit schematics, place components, adjust layout, fix overlapping parts, or create schematic pages in EasyEDA.

Install

npx vskill@latest install kukucaicndy/embedded_ai_skills/easyeda-draw

SKILL.md

EasyEDA 原理图绘制

在 EasyEDA Pro 中通过 API 绘制原理图。本 skill 为入口，详细子 skill 见下方目录。

使用方式

本 skill 支持两种使用模式：

完整流程模式——从头到尾绘制一张完整原理图。必须采用多 Agent 编排方式：主 Agent 做任务规划 → 每个模块召唤绘制子 Agent → 每个模块召唤检查子 Agent → 整改闭环。完整编排流程见 orchestration/；绘制细节按 SOP 标准绘制步骤逐模块推进。
任务模式——选取合适的子技能完成单个特定任务（如"放一个器件""画一根导线""跑一次 DRC"）。直接用 CLI 命令或查阅对应子 skill 文档即可，无需走完整 SOP。

判断依据：用户说"画原理图"/"绘制电路"→ 完整流程模式（必读 orchestration）；用户说"放个电阻"/"检查 DRC"/"画根线"→ 任务模式。

多 Agent 编排：网络标签传递

每个模块完成后，主 Agent 必须执行 `net-summary` 收集当前网络标签快照，并传递给下一个子 Agent。
这样下一个子 Agent 知道：
- 哪些网络已存在（如 ROW0、COL0、VCC、GND）
- 这些网络在什么坐标
- 应该在哪些位置对接同名网络标签
避免子 Agent 盲目创建重复标签或放错坐标。

第一步：环境准备（必须先做）

⚠️ 在执行任何绘制命令之前，必须先完成以下两步，确认 Bridge Server 运行且 EDA 已连接。

1. 启动 Bridge Server

Bridge Server 是 AI 与 EasyEDA 之间的通信桥梁，由 easyeda-api skill 提供。

bash

# 检查 bridge 是否已在运行 (扫描端口 49620-49629)
for port in $(seq 49620 49629); do
  resp=$(curl -s http://localhost:$port/health 2>/dev/null)
  if echo "$resp" | grep -q '"easyeda-bridge"'; then
    echo "Bridge already running on port $port"
    break
  fi
done
 
# 若未运行，则启动 (后台运行，不阻塞)
node ../../easyeda-api/scripts/bridge-server.mjs &
sleep 2

同时确保 EasyEDA Pro 中已安装并加载 run-api-gateway.eext 扩展（下载：https://ext.lceda.cn/item/oshwhub/run-api-gateway ）。

2. 检查连通性

bash

# 一键检查 bridge + EDA 连通性 (CLI 自动扫描端口 49620-49629)
./scripts/draw_cli.py health

期望输出：

json

{"ok": true, "summary": "Bridge OK (port 49620), EDA connected", "bridge": true, "port": 49620, "edaConnected": true}

bridge: false → Bridge 未启动，回到第 1 步
edaConnected: false → EasyEDA 扩展未加载，检查 run-api-gateway.eext
多窗口场景：输出中 windows 列出所有已连接的 EDA 窗口，activeWindow 为当前活动窗口

端口也可通过环境变量强制指定：EDA_BRIDGE_PORT=49622 ./scripts/draw_cli.py health

子 Skill 目录

子 Skill	路径	用途
多 Agent 编排	orchestration/	完整流程模式必读：任务规划 → 绘制子 Agent → 检查子 Agent → 整改闭环
绘制规范	rules/	原理图设计规范、信号流向、布局约定、命名标准
标准绘制步骤	sop/	从主控到外围的标准绘制流程，含 NC 标记和检查 SOP
模块子流程	sop/subflow.md	每个外围模块的详细绘制子流程（P0 布局规划→P8 策略检查）
器件摆放	placement/	元器件放置、位号分配、旋转镜像、间距控制
自定义符号	symbol/	创建自定义符号/器件，系统库找不到时使用
连线	wiring/	导线绘制、网络标签、NC 标记、电源/地符号
检查	checking/	布局验证、DRC、重复标签、导线网络名、未连接引脚检查
绘制后优化策略	strategies/	同名合并、NetFlag对齐、冗余合并、NC标注、信号规范、网络名、重复标签、DRC

核心规则（MUST FOLLOW）

0. 完整流程模式必须多 Agent 编排

⚠️ 当用户要求"画完整原理图"时，禁止主 Agent 亲自下场逐个 `place`/`wire`。
正确方式：
1. 主 Agent 做 Phase A 任务规划（拆模块 + 写任务卡 + Zone Plan + 用户确认）
2. 每个模块召唤《绘制子 Agent》按任务卡绘制
3. 每个模块召唤《检查子 Agent》独立验收
4. 不通过则整改闭环，直到 PASS
5. 用户人工确认后进入下一模块
详见 orchestration/。

1. 必须使用语义化 CLI 命令

⚠️ 三条禁令：
1. 禁止使用 curl 调用 `/execute` 端点——无论是绘制操作还是只读查询。所有操作（包括获取库 UUID、查询引脚、搜索器件）都必须通过 CLI 命令完成。如果 CLI 缺少所需命令，应先补充 CLI 命令而非退回 curl。
2. 禁止使用 `exec` 命令——本 CLI 已移除 exec，强制使用语义化命令。
3. 禁止为单次操作编写脚本（如 *.mjs / *.py / *.js）——所有操作直接用 CLI 命令完成。
所有放置、连线、验证操作必须通过：
```bash
./scripts/draw_cli.py <command> [options]
# 或
python3 scripts/draw_cli.py <command> [options]
```
输出格式：默认完整数据单行 JSON；-v 缩进 (调试)；-q 只输出 id (管道)。

2. 逐模块绘制，不能一次性摆完全部

禁止「先摆完全部器件，再统一连线」。
正确方式：模块A: 摆放→验证→连线→验证→人工确认 → 模块B

3. 每个模块完成后必须人工确认

停下来等用户说"继续"才能进入下一个模块。

4. 批量操作粒度由 AI 自主判断

单次操作的器件数量不设硬性上限，由 AI 根据模块复杂度和置信度自主决策。
简单重复操作（如放 6 个相同开关 + 6 个二极管）可一次完成；复杂或高风险操作应分批并逐步确认。

5. 模块间禁止连接导线（MUST FOLLOW）

⚠️ 模块到模块也使用网络标签，禁止连接导线。
| 场景 | 连接方式 | 示例 |
|------|----------|------|
| 模块内部 | 导线直连 | 按键 SW1 → 二极管 D1 → 行线 |
| 模块到模块 | 网络标签，禁止导线 | 矩阵模块 ROW0 ← NetPort → 主控模块 U1.D7 |
| 模块到主控 | 网络标签，禁止导线 | U1.D7 → NetPort(ROW0) |
| 电源/地 | NetFlag | VCC / GND |
判定标准：如果导线的两端分别在两个不同功能模块的器件上，就是跨模块连接导线，必须改用网络标签。
为什么：跨模块导线会导致原理图交叉凌乱、难以审阅、难以维护。网络标签让模块边界清晰，每个模块自包含。

脚本工具

本 skill 提供两个脚本文件，位于 scripts/ 目录：

1. CLI 工具 (`scripts/draw_cli.py`, Python)

命令行直接执行常用操作，无需编写代码。已移除 exec 命令，强制使用语义化命令。

bash

# 检查 bridge + EDA 连通性 (第一步必做)
./scripts/draw_cli.py health
 
# 查看项目信息
./scripts/draw_cli.py project-info
 
# 符号创建
./scripts/draw_cli.py create-symbol "nice!nano v2"          # 创建空符号到个人库
./scripts/draw_cli.py open-symbol <symbolUuid> <libUuid>    # 在编辑器中打开符号
./scripts/draw_cli.py create-device <name> <symUuid> <libUuid>  # 从符号创建器件
./scripts/draw_cli.py build-symbol <name> <pinCount>        # 一键构建符号骨架（创建+添加矩形+引脚）
 
# 符号编辑（只能在符号编辑器标签页中使用）
./scripts/draw_cli.py list-primitives       # 列出当前文档所有图元（符号/原理图通用）
 
# 搜索器件（默认系统库，--personal/--project 自动获取库 UUID）
./scripts/draw_cli.py search "nice!nano v2" 5
./scripts/draw_cli.py search "nice!nano v2" 5 --personal
./scripts/draw_cli.py search "nice!nano v2" 5 --project
./scripts/draw_cli.py search "nice!nano v2" 5 --lib <libraryUuid>
 
# 获取库 UUID（无需 curl）
./scripts/draw_cli.py lib-personal          # 个人库 UUID
./scripts/draw_cli.py lib-project           # 工程库 UUID
./scripts/draw_cli.py lib-list              # 列出所有库
 
# 清理页面（保留指定器件）
./scripts/draw_cli.py clear --keep id1,id2
 
# 放置器件 (推荐加 --name 标识型号/规格)
./scripts/draw_cli.py place <libUuid> <uuid> <x> <y> [designator] [rotation] [mirror]
./scripts/draw_cli.py place <libUuid> <uuid> <x> <y> R1 --name "10kΩ"
./scripts/draw_cli.py place <libUuid> <uuid> <x> <y> C1 --name "100nF"
./scripts/draw_cli.py place <libUuid> <uuid> <x> <y> U1 --name "nice!nano v2"
 
# 查询器件完整信息 (含 name/spec)
./scripts/draw_cli.py get-component <primitiveId>
./scripts/draw_cli.py get-component --designator U1
 
# 修改器件规格 (对已放置的器件补设 name)
./scripts/draw_cli.py modify-component <id> --name "10kΩ"
./scripts/draw_cli.py modify-component <id> --name "nRF52840"
 
# 添加文本
./scripts/draw_cli.py text <x> <y> "文本内容" [fontSize]
 
# 添加矩形
./scripts/draw_cli.py rect <x> <y> <w> <h> [color]
 
# 添加网络标签
./scripts/draw_cli.py netflag Power VCC 100 100
 
# 添加网络标��（延伸导线）

⚠️ NetPort 已不推荐。信号引脚仅用延伸导线（导线已含网络名）

Power/Ground 仍用 NetFlag

✅ 信号引脚：仅延伸导线

./scripts/draw_cli.py wire "620,290,520,290" I2C_SDA

✅ 电源/地：导线 + NetFlag

./scripts/draw_cli.py wire "780,270,880,270" VCC && ./scripts/draw_cli.py netflag Power VCC 890 270

✅ 或一键替换已有 NetPort

./scripts/draw_cli.py replace-netports

 
# 绘制导线 (必须指定网络名, 防止跨网络合并)
./scripts/draw_cli.py wire "100,100,150,100" NET_NAME
./scripts/draw_cli.py wire "100,100,150,100" NET_NAME --safe    # 安全模式: 先查冲突再创建 (推荐)
 
# 批量创建导线 (逐条安全检查, 防止跨网络合并)
./scripts/draw_cli.py wire-batch --json '[{"points":[100,100,150,100],"net":"ROW0"},{"points":[200,100,250,100],"net":"ROW1"}]'
 
# 绘制导线（指定线型/颜色/线宽）
./scripts/draw_cli.py wire "100,100,200,100" NET --dashed
./scripts/draw_cli.py wire "100,100,200,100" NET --color "#ff0000" --width 5
# 线型选项: --dashed(短划线) --dotted(点线) --dot-dashed(点划线) 默认实线
 
# 查看导线详细信息
./scripts/draw_cli.py get-wire <primitiveId>
 
# 修改已有导线（网络名/坐标/线宽/线型）
./scripts/draw_cli.py modify-wire <id> --net "NEW_NET"
./scripts/draw_cli.py modify-wire <id> --line "100,200,150,200"
 
# 创建总线（多位信号线分组标识）
./scripts/draw_cli.py bus "DATA[7:0]" "100,200,300,200,300,500"
./scripts/draw_cli.py list-buses
./scripts/draw_cli.py delete-buses id1 id2
 
# 创建多边形/折线（装饰框，无电气属性）
./scripts/draw_cli.py polygon "100,100,300,100,300,300,100,300"
./scripts/draw_cli.py polygon "100,100,300,300" --dashed --fill "#f0f0f0"
./scripts/draw_cli.py list-polygons
./scripts/draw_cli.py delete-polygons id1 id2
 
# 搜索器件
./scripts/draw_cli.py search "电阻" 10
 
# 检查重叠
./scripts/draw_cli.py check-overlap
 
# 寻找空白区域放置器件（避免与已有器件重叠）
./scripts/draw_cli.py find-space 200 150 100 100 1200 900
 
# 获取器件引脚实际坐标（旋转/镜像后的真实位置）
./scripts/draw_cli.py get-pins <primitiveId>
./scripts/draw_cli.py get-pins --designator U1
 
# 删除器件（含周边导线/标签清理）
./scripts/draw_cli.py delete-component --designator J2
./scripts/draw_cli.py delete-component --designator J2 --margin 80 --clean-text
 
# 一站式放置器件 + 自动打标签（应用 U1 连线/标签心得）
# 引脚密集时，标签分散到不同方向（左/右/下交替），避免重叠
./scripts/draw_cli.py place-with-labels <libUuid> <uuid> <x> <y> <des> <rotation> \
  --pins "1:net=D1,type=port,side=right" "2:net=D0,type=port,side=bottom" "3:net=GND,type=ground,side=left" \
  --label "UART Debug"
# 可选 --find-space <w>,<h> 自动寻找空白区域
 
# 列出所有器件
./scripts/draw_cli.py list-components
 
# 收集网络标签快照 (按网络名分组, 含坐标)
./scripts/draw_cli.py collect-nets
 
# 生成网络摘要文本 (供下一个子 Agent 使用)
./scripts/draw_cli.py net-summary
 
# 缩放到所有图元
./scripts/draw_cli.py zoom-all
 
# 恢复标题块
./scripts/draw_cli.py restore-titleblock
 
# === 绘制中验证（每完成一个模块执行）===
./scripts/draw_cli.py verify-placement        # 验证摆放质量（重叠/间距/旋转）
./scripts/draw_cli.py verify-wiring            # 验证连线质量（网络名/标签重复/孤立标签）
 
# === 绘制后检查（每次提交前必须执行）===
./scripts/draw_cli.py drc                    # DRC 检查（聚合统计）
./scripts/draw_cli.py drc --show-ui           # 打开 DRC 面板查看逐项详细错误
./scripts/draw_cli.py check-duplicates       # 检测重复标签
./scripts/draw_cli.py check-duplicates --clean  # 检测并自动清理
./scripts/draw_cli.py check-wire-nets        # 检测无网络名的导线
./scripts/draw_cli.py check-wire-conflicts   # 检测导线网络冲突 (触碰不同网络的导线)
./scripts/draw_cli.py check-wire-through     # 检测导线穿过元器件本体
./scripts/draw_cli.py check-unconnected      # 检测未连接引脚 (4PIN开关感知+NC标记感知)
./scripts/draw_cli.py check-shorts           # 检测短路 (不同网络名导线连接在一起)
./scripts/draw_cli.py check-redundant-wires  # 检测冗余导线 (同两点间多条导线)
./scripts/draw_cli.py check-all              # 一键全量检查（7步，推荐）

⚠️ 已移除 `exec` 命令——禁止执行任意 JS 代码字符串。所有操作必须使用上面的语义化命令。

2. 底层 API 参考（Bridge Server `/execute` 直调）

⚠️ JS 脚本已全部删除：draw-utils.js 和 draw-cli.mjs 已于 Python 迁移完成后清理。以下代码示例仅作底层 EDA API 参考，展示每个语义命令对应的 JS 实现。新操作必须使用 `draw_cli.py` 的语义化命令，禁止再编写 JS 脚本。
如需查询某 API 的具体实现，请阅读 scripts/draw_cli.py 中对应函数的 code 字符串（即发送到 bridge server /execute 的 JS 代码）。

以下示例展示底层 API 调用方式（仅供理解，不要复制使用）：

javascript

import utils from './scripts/draw-utils.js';
// 清理页面
await utils.clearPage(['keepId1', 'keepId2']);
// 放置器件
const id = await utils.placeComponent({
  libraryUuid: '0819f05c4eef4c71ace90d822a990e87',
  uuid: '839559ae8f084f08bc76562033e67b08',
  x: 100, y: 150,
  designator: 'SW1',
});
// 批量放置
await utils.placeComponents([
  { libraryUuid, uuid, x: 100, y: 150, designator: 'SW1' },
  { libraryUuid, uuid, x: 250, y: 150, designator: 'SW2' },
]);
// 添加文本
await utils.addText({ x: 100, y: 120, text: 'Key Matrix', fontSize: 8 });
// 添加网络标签
await utils.addNetFlag({ type: 'Power', net: 'VCC', x: 100, y: 100 });
// 绘制导线（指定线型/颜色/线宽）
await utils.addWire([100, 100, 200, 100], 'NET_NAME', { color: '#ff0000', lineWidth: 3 });
await utils.addWire([100, 100, 200, 100], null, { lineType: 1 }); // 1=短划线
// 查看导线详细信息
const info = await utils.getWireInfo(wirePrimitiveId);
// { id, net, line, lineWidth, lineType, color }
// 修改已有导线
await utils.modifyWire(wireId, { net: 'NEW_NET', lineType: 0 }); // 0=实线
// 创建总线
await utils.addBus('DATA[7:0]', [100, 200, 300, 200, 300, 500]);
// 查询/删除总线
const buses = await utils.getAllBuses();
await utils.deleteBuses(busId);
// 创建多边形（装饰框）
await utils.addPolygon([100, 100, 300, 100, 300, 300, 100, 300], { fillColor: 'none' });
await utils.addPolygon([100, 100, 300, 100, 300, 300, 100, 300], { lineType: 1, fillColor: '#f0f0f0' });
// 查询/删除多边形
const polys = await utils.getAllPolygons();
await utils.deletePolygons(polyId);
// 检查重叠
const { overlaps } = await utils.checkOverlaps();
// 寻找空白区域（避免与已有器件重叠）
const pos = await utils.findFreeSpace({ width: 200, height: 150 });
if (pos) { /* pos.x, pos.y */ }
// 获取器件引脚实际坐标（旋转后的真实位置）
const pins = await utils.getComponentPins(primitiveId);
// 按位号查找器件 ID
const id = await utils.findComponentByDesignator('U1');
// 删除器件（含周边导线/标签清理，替代手写 cleanup 脚本）
await utils.deleteComponent({ designator: 'J2', margin: 80, cleanText: true });

This is the start of the file. Read the full SKILL.md on GitHub.

Security

Security scanPassed, 95 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingtools/easyeda-draw/SKILL.md

Popularity

Repository stars: 55
Repository forks: 12
7-day trend score: 20

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kukucaicndy/embedded_ai_skills/easyeda-draw/badge)](https://verified-skill.com/skills/kukucaicndy/embedded_ai_skills/easyeda-draw)

Something wrong with this skill or its page? Tell us.

Install

SKILL.md

EasyEDA 原理图绘制

使用方式

多 Agent 编排：网络标签传递

第一步：环境准备（必须先做）

1. 启动 Bridge Server

2. 检查连通性

子 Skill 目录

核心规则（MUST FOLLOW）

0. 完整流程模式必须多 Agent 编排

1. 必须使用语义化 CLI 命令

2. 逐模块绘制，不能一次性摆完全部

3. 每个模块完成后必须人工确认

4. 批量操作粒度由 AI 自主判断

5. 模块间禁止连接导线（MUST FOLLOW）

脚本工具

1. CLI 工具 (scripts/draw_cli.py, Python)

⚠️ NetPort 已不推荐。信号引脚仅用延伸导线（导线已含网络名）

Power/Ground 仍用 NetFlag

✅ 信号引脚：仅延伸导线

✅ 电源/地：导线 + NetFlag

✅ 或一键替换已有 NetPort

2. 底层 API 参考（Bridge Server /execute 直调）

Security

Quality evaluation

Source

Popularity

Works with

1. CLI 工具 (`scripts/draw_cli.py`, Python)

2. 底层 API 参考（Bridge Server `/execute` 直调）