用途:依据自然语言时序描述、协议要求、时序表或已有资料,生成、修改、校验并渲染官方 WaveDrom 图。支持 signal 时序图,也保留或生成 assign、reg 图,可把 Datasheet 尺寸注解写入同一 JSON5 的 datasheet.annotations。
主要能力:输出可编辑源文件 <name>.json5,默认渲染 <name>.svg,可加 PNG 与可离线编辑、实时渲染、校验、缩放、复制和下载的自包含 HTML;保持官方字段,把因果关系放在 edge,Datasheet 尺寸放在 datasheet.annotations,不重复同一对端点;要求为每个产物返回绝对路径,并说明对时序语义有实质影响的假设。
使用方式:先分类请求并建立时序契约(时间单位或时钟域、有效边沿、初始状态、信号与有效电平、有序事件、延迟、传输条件、最终状态、未决假设);有影响的歧义才询问。编写前阅读 references/wavejson-official.md,标准协议另读 references/protocol-questions.md,同步或实现级工作读 references/semantic-review.md,规格表尺寸读 references/datasheet-annotations.md。校验优先用 wavedrom_validate MCP,否则运行 node <skill-dir>/scripts/validate-wavejson.mjs --input <source.json5>;默认只在 JSON5、官方渲染或 Datasheet 扩展错误时失败,语义 lint 为建议,加 --strict 可让所有警告失败。渲染优先用 wavedrom_render MCP,否则运行 node <skill-dir>/scripts/render-wavedrom.mjs --input <source.json5> --svg <output.svg>,可加 --png <output.png> 或 --html <output.html>。依赖需 Node.js 20 及以上,固定 wavedrom@3.6.2 及六种皮肤,PNG 用 @resvg/resvg-js 从官方 SVG 派生。未经授权不要静默安装依赖,授权后在技能目录运行 npm ci --omit=dev。
适用场景与限制:适合同步设计、协议时序和规格尺寸标注;渲染成功不代表协议正确,需对照时序契约核查标签、跳变、分组、箭头、裁剪、皮肤和裁切。不得仅为了图面完整而虚构信号,需区分未知 x、高阻 z、保持 .、间隔 |、数据框 =/2-9 与子周期 <...>,除非用户要求否则逐字保留既有官方语法。官方主包 CLI 仍可单独使用:npx wavedrom --input source.json5 > output.svg。未注册 MCP 时可读 references/mcp-registration.md。收费、价格等信息暂未提供。