RNLRich Netlist
简中

The English terms are the normative ones. Glossary

RICH NETLIST · AGENT SKILLRNL 0.3 · 标准包 0.3

给 Agent

下载 skill 包,你的 Agent 就能读、写、检查并绘制 RNL

RNL 将原理图的画法写入 SPICE 或 Spectre 网表的注释中,而网表本身依然是电路的唯一定义。skill 包是一个符合 Agent Skills 格式的文件夹,内含语言简明指南、标准包参考、使用工具检查与绘制文件的说明,以及通过 rnl check 验证的示例。包内文档为英文,供 Agent 直接读取;中文版简明指南亦收录于语言标准 0.3 的中文页面中。本页说明如何下载并安装此包;供 Agent 读取的纯文本入口为 llms.txt。

包
rnl
格式
Agent Skills:SKILL.md 搭配参考文件
语言版本
RNL 0.3
标准包
系列 0.3
下载
rnl-skill.zip
许可证
MIT · CC-BY-4.0 · CC0-1.0

01 · 一句话指令

把这句话交给你的 Agent,剩下的交给它完成

无论是 Claude Code,还是任何能读取网页并写入文件的 Agent:只要读取 llms.txt,就能得知从何处下载 skill 包、解压至何处,接着按照 SKILL.md 读写 RNL。

请读取 https://rich-netlist.github.io/rnl/llms.txt,安装其中说明的 RNL skill,接着协助我处理 RNL 网表。

llms.txt 是专为 Agent 准备的纯文本入口:说明如何安装、包内包含哪些文件、如何检查文件,以及语言标准的位置。该文件为英文,位于 /rnl/llms.txt。

02 · 安装

解压至 Agent 存放 skill 的目录,即可得到 rnl/SKILL.md

此 skill 即为 rnl/ 文件夹。Claude Code 将个人 skill 存放在 ~/.claude/skills/(所有项目均可使用),而项目专属的 skill 则放在 .claude/skills/;其他 Agent 各有其存放目录,请参阅各自的文档。下方命令会将 zip 解压至 Claude Code 的个人目录。

macOS · Linux · Git Bash

mkdir -p ~/.claude/skills
curl -fL https://rich-netlist.github.io/rnl/skill/rnl-skill.zip -o /tmp/rnl-skill.zip
unzip -o /tmp/rnl-skill.zip -d ~/.claude/skills

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Invoke-WebRequest https://rich-netlist.github.io/rnl/skill/rnl-skill.zip -OutFile "$env:TEMP\rnl-skill.zip"
Expand-Archive -Force "$env:TEMP\rnl-skill.zip" "$HOME\.claude\skills"

手动安装

rnl-skill.zip 内含 rnl/ 文件夹及其全部文件。解压后将 rnl/ 放入你的 Agent 存放 skill 的目录即可。zip 与各文件的 SHA-256 记录于 SHA256SUMS.txt,各文件的大小与地址则记录于 manifest.json。

免安装直接读取

无法解压或写入文件的 Agent 可以直接读取纯文本:先读 SKILL.md,它会指引至 references/ 下的文件。所有文件均位于 skill/rnl/ 下,完整列表见下方。

从仓库获取

skill 的源文件位于仓库的 skills/rnl/:克隆仓库并复制该文件夹,效果完全相同。此处的 zip 始终由最新的 main 分支构建而成。

03 · 包内内容

一份简明指南、一份自动生成的参考文档,以及经过验证的示例

每个文件均可直接作为纯文本读取。参考文档由标准包文件自动生成,确保与标准包保持一致;包中的每个 SPICE 与 Spectre 示例均在 CI 中通过 rnl check 验证。

04 · 检查与绘制

写完即检查,使用你能运行的第一个工具

这四项工具共用同一个核心,因此读取文件的行为完全一致。Agent 可直接运行前两项来检查与渲染文件;两款查看器则用于交互式查看(在用户要求时,Agent 也可安装并启动桌面版查看器)。完整说明与命令列于 references/tools.md。

rnl

从最新核心发布页下载适用于 Windows、Linux 或 macOS 的压缩包,或从源码构建(需 Rust 1.85 或更高版本):cargo build --release -p rnl-cli。rnl check FILE 会输出诊断信息并在发生错误时以退出码 1 结束;rnl render FILE -o DIR 会为每个层级输出 SVG。功能最完整,也是 CI 所使用的工具。

npm

npm i @rich-netlist/runtime(需 Node 18 或更高版本):将同一个核心编译为 WebAssembly,提供诊断信息与各层级的 SVG。版本号与 rnl 命令一致,并随核心同步发布。

网页版查看器

供使用浏览器的人操作:rich-netlist.github.io/rnl/viewer/。打开文件即可查看原理图与“问题”面板;文件不会上传。若 Agent 无法操作浏览器,可请用户在此打开文件。

桌面版查看器

支持 Windows 10/11、Linux x86_64 与 macOS 13 或更高版本:请前往工具页面下载。

05 · 版本与许可证

紧随 main 分支更新,并逐文件标明许可证

  • 版本此 skill 对应语言标准 0.3(修订 2)与标准系列 0.3 的标准包。语言与工具链目前仍为草案,0.x 各版本之间不保证兼容:0.2 的文件使用不同的名称,需搭配标准系列 0.2 的包读取。
  • 保持同步每当网站发布时,zip 与相关文件均会重新生成,确保始终与当前的 main 分支同步。参考文档由包文件生成,简明指南与语言标准一并维护,所有示例均在 CI 中通过 rnl check 验证。
  • 许可证SKILL.md 与工具说明采用 MIT 许可证,语言简明指南采用 CC-BY-4.0 许可证(复用时请注明出处),标准包参考与示例则采用 CC0-1.0 许可证。包中不含代码与字体。完整条款载于包内的 LICENSE.md 与 LICENSES/。
  • 发现错误若 skill 或简明指南与语言标准有所出入,以语言标准为准;欢迎前往 GitHub 报告问题。