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 使用的純文字入口為 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 回報問題。