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
Windows PowerShell
手动安装
rnl-skill.zip 内含 rnl/ 文件夹及其全部文件。解压后将 rnl/ 放入你的 Agent 存放 skill 的目录即可。zip 与各文件的 SHA-256 记录于 SHA256SUMS.txt,各文件的大小与地址则记录于 manifest.json。
从仓库获取
skill 的源文件位于仓库的 skills/rnl/:克隆仓库并复制该文件夹,效果完全相同。此处的 zip 始终由最新的 main 分支构建而成。
03 · 包内内容
一份简明指南、一份自动生成的参考文档,以及经过验证的示例
每个文件均可直接作为纯文本读取。参考文档由标准包文件自动生成,确保与标准包保持一致;包中的每个 SPICE 与 Spectre 示例均在 CI 中通过 rnl check 验证。
-
从这里开始
SKILL.mdRNL 是什么、一个完整示例、工作步骤,以及省时的重要规则。
-
语言简明指南
references/language.md读写 RNL 0.3 文件所需的一切:文件结构、语句、对象与引用、定义、布局、导线、文字与包。同一份指南也收录于RNL 0.3 语言标准页面中。
-
标准包参考
references/packages.md标准系列 0.3 的每个包、定义及其角色、符号及其引脚、元件默认分配的符号、集合,以及中文代称包
rnl-zh的说明。附有符号原理图的图库位于标准包页面。 -
检查与绘制
references/tools.md预构建或从源码构建的
rnl命令、npm 包@rich-netlist/runtime、网页版查看器与桌面版查看器的使用方式,并附有一份完整的检查脚本。 -
示例:仅含结构
examples/ota5t.sp以 SPICE 编写的五管 OTA:写了差分对与电流镜,未指定位置;同一电路的 Spectre 版本为
examples/ota5t.scs。 -
示例:已完成摆放与布线
examples/ota5t-placed.sp同一个电路,所有对象均已指定位置,并写好导线、端口、地与电源,可由
rnl render完整绘制出原理图。 -
许可证
LICENSE.md各文件所适用的许可证,以及许可证全文(
LICENSES/)。
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 报告问题。