<一句话说清『这个 skill 做什么 + 何时调用』。把最关键的触发场景放最前面。结尾给 2-3 个用户会说的关键词。>
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
FreePublished on GitHub
bb-invoke-qrouter
调用 QRouter 1.4 对 placed DEF 执行 detail routing，产出 routed.def。触发场景：(1) bba-guru-pd 在 placement 完成后做布线；(2) 显式 /bb-invoke-qrouter。
The English summary is being prepared. Showing the original description.
See how to installFiles included (6)
- SKILL.md2.7 KB
- Gotcha/qrouter_pitfalls.md2.0 KB
- references/asap7_lef.md2.0 KB
- scripts/parse_qrouter.py2.3 KB
- scripts/render_qrouter_cfg.py2.9 KB
- scripts/run_qrouter.py3.1 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
bb-invoke-qrouter
职责
对 placed DEF + tech/cell LEF 跑详细布线，输出 routed DEF。布线失败需 bba-guru-pd 调整 floorplan utilization 后重试。
- 调用者：
bba-guru-pd - 上游：
bb-invoke-magic(action=place) - 下游：
bb-invoke-magic(action=drc) - 禁止使用：Task / Agent / Skill
Input Args
| arg | type | required | 默认 | 说明 |
|---|---|---|---|---|
| placed_def | path | true | — | designs/<name>/pd/placed.def |
| tech_lef | path | true | — | ASAP7 tech LEF |
| cell_lef | path | true | — | ASAP7 standard cell LEF |
| design_name | string | true | — | — |
| strategy | enum | false | default | default | high_effort |
| stamp | string | false | <auto> | — |
Output Contract
| field | 值 |
|---|---|
artifact_path | designs/<name>/pd/routed.def |
cfg_path | designs/<name>/pd/qrouter_<stamp>.cfg |
log_path | designs/<name>/pd/qrouter_<stamp>.log |
failed_nets | int |
valid | bool |
error | string|null |
4-Phase 执行
Phase 1 — render_qrouter_cfg
scripts/render_qrouter_cfg.py 渲染：
lef <tech_lef>
lef <cell_lef>
read <placed_def>
route
writeback
write <name>_routed.def designs/<name>/pd/routed.def
quit
strategy=high_effort 追加 set rip_limit 50 等积极参数。
Phase 2 — run_qrouter
scripts/run_qrouter.py：
source ~/wrk/eda_opensources/eda_env.shqrouter -v 2>&1 | grep "1.4"否则VERSION_MISMATCHtimeout 3600 qrouter -noclockdiff -c <cfg> > <log> 2>&1- log 末尾追加
exit:<rc>
Phase 3 — parse_qrouter
scripts/parse_qrouter.py：
routed.def存在 →valid=true- log 含
routing failed/Unable to route→ 计数failed_nets
写 qrouter_<stamp>.json。
Phase 4 — return
返回 JSON。bba-guru-pd：
failed_nets==0→ 调bb-invoke-magic(action=drc)failed_nets>0→ 增加 utilization margin（-0.05）重 floorplan，≤5 iter
收敛 / 失败
| 状态 | 行动 |
|---|---|
| failed_nets==0 | 进 DRC |
| failed_nets>0 | 调 floorplan 重试 |
VERSION_MISMATCH | 修 eda_env.sh |
| Phase 2 timeout（3600s） | error="ROUTE_TIMEOUT"，提高 utilization |
| iter > 5 | retreat 到 synth-needs-fix |
资源索引
scripts/render_qrouter_cfg.py、scripts/run_qrouter.py、scripts/parse_qrouter.pyreferences/asap7_lef.md— tech/cell LEF 位置Gotcha/qrouter_pitfalls.md— congestion / pitch / via stack
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
bb-arch
Free从粗略 idea 设计芯片或功能模块架构，输出专业架构文档到 spec_arch 目录。Trigger: 芯片架构设计, IC架构, 电路模块设计, 硬件架构. Generate IC/Chip architecture specification from rough ideas.
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-check-cdc
Free基于 AST 检查 CDC/RDC 违例：对比 MAS clock_domains 找跨域信号，检查是否被 2ff-sync CBB 保护。触发场景：(1) bba-guru-synthesis 综合前；(2) 显式 /bb-check-cdc。
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-check-lint
Free调用 babel-lsp / verible-verilog-lint 检查 SV 源码。src 必须可综合（零 syntax error），tb 允许 verification constructs。发现 src error 时自动修复重检（max 3 iter）。触发：(1) bba-guru-rtl 生成后；(2) RTL 修复重检；(3) 显式 /bb-check-lint。
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-close-issue
FreeBabel internal issue protocol — close a handoff after downstream agent picked it up or user signed off. Moves designs/<name>/.handoff/<label>.md to .handoff/closed/ (using mv per CLAUDE.md), appends to handoff_log.jsonl.
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-code-review
Free对抗性代码评审：代码质量 / 可维护性 / 时序风险 / 综合友好度 / MAS 对齐度。默认 ruthless 模式，找 EVERY flaw。触发场景：(1) RTL lint 后；(2) 显式 /bb-code-review。
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026