SuperAPI AI 工具集

soc-build

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:通过已注册的 soc-build MCP 服务器创建并运行规范的 SoC 项目/模块脚手架,覆盖 filelist、lint、编译、仿真、回归、覆盖率与综合等环节。不得直接导入其 FastMCP 对象,也不要用 shell 命令替代 EDA 工具调用。

主要能力:提供 soc_init 初始化项目、soc_add_chip 添加芯片模块、soc_add_ip 添加数字/第三方 IP、soc_flist 生成 Verilog/SystemVerilog 文件列表、soc_lint 基于项目 filelist 用 Verilator 或 SpyGlass 做 lint、soc_cdc 执行 SpyGlass CDC 检查、soc_comp 编译、soc_sim 编译后仿真、soc_regress 测试/种子矩阵回归、soc_coverage 单次或回归覆盖率、soc_syn 基于项目 filelist 综合(syn_tool 可选 yosys 或 dc)、soc_verdi 打开 Verdi(scope=de 加载 RTL/源码,scope=dv 加载仿真数据库/波形)。

规范布局与用法:每个芯片模块和 IP 使用统一目录结构,包含 docs/、de/rtl/、de/lint/、de/cdc/、de/formal/、de/run/、de/syn/、dv/tb/、dv/verif/、dv/tests/、dv/sim/、dv/cov/ 和 Makefile。流水线产物限于 docs/、de/rtl/、de/run/、de/syn/、dv/tb/、dv/sim/,其余目录留给专用流程配置与材料。项目 .codex/config.toml 注册 MCP 服务器;若启动器报告缺少 Python 模块,运行 .agents/scripts/setup_mcp_env.sh,运行时装在 ${XDG_CACHE_HOME:-$HOME/.cache}/silicon-crew/venv,不要打包 .venv。不得创建旧式根目录 rtl/、sim/、syn/ 或 constraints/。

各阶段调用:RTL 代理调用 soc_lint,仅允许 Verilator 或 SpyGlass,无直接回退;验证代理调用 soc_sim 或 soc_regress,无直接 Make/仿真器回退;综合代理调用 soc_syn,dc 为 Design Compiler,yosys 为结构检查,Yosys 输出不作为 STA 证据;商业仿真器/许可证工作须留在注册的 MCP 进程内。SpyGlass lint 默认无 GUI 模式。成功响应以 LOOP_EVIDENCE=<json> 行结束,含 run_id、source_fingerprint、tool_family,若 RTL/filelist 材料变化则拒绝该次运行,须把该 run ID 与 fingerprint 传入 update_state.py,不得事后从当前 checkout 合成。

限制:lint 修复须经评审;先提出根因、报告行与补丁计划,待用户确认后才可施加最终 RTL 修复、waiver 或降级。代码评审需阅读 references/verilog_coding_style.md,并按强制、建议、参考给出带文件/行号的发现。所有名称、仿真器、测试、种子与作业数均经校验,非零退出或超时会成为 MCP 工具错误。