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。
免安裝直接讀取
無法解壓縮或寫入檔案的 Agent 可以直接讀取純文字:先讀 SKILL.md,它會指引至 references/ 下的檔案。所有檔案皆位於 skill/rnl/ 下,完整清單見下方。
從儲存庫取得
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 回報問題。