Communitygithub.com

JordiRigau/hp-prime-kit

專為 AI 代理打造的 HP Prime 工具包:內含 AGENTS.md(以真實 G2 量測的 PPL 規則)、linter、可直接執行原始碼的直譯器,以及 .hpprgm 建構器——讓代理無需觸碰計算機即可撰寫、檢查並打包程式。

hp-prime-kit 是什麼?

此技能專為 AI 代理(如 Claude Code、Cursor、Codex)設計,解決 HP Prime 計算機上 PPL 語言缺乏良好文件與編譯器錯誤訊息模糊的痛點。它提供一套完整的開發工具鏈:一個能發現編譯器無法解釋之問題的 linter、一個在本機執行相同 .txt 原始碼的直譯器(無需計算機),以及一個能產生 .hpprgm 安裝檔的建構器。代理只需編輯純文字檔案並執行三個指令(lint、run、write),就能確保語法正確,最後再由人類透過 Connectivity Kit 將 .hpprgm 拖曳至計算機。此工具包也包含 AGENTS.md 作為操作合約,明確指出代理能做與不能做的事項,以及完整的參考文件,支援所有主流 AI 代理平台。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add JordiRigau/hp-prime-kit

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

HP Prime

PPL 的官方文件品質不佳,且其編譯器只會回報 syntax error 搭配行號。 這個工具包消除了最耗時的兩個瓶頸:猜語法 與 在 Connectivity Kit 中反覆貼上與編譯的繁瑣流程。

從這裡開始

務必閱讀 AGENTS.md。 它是本倉庫的操作合約:撰寫 PPL 前應閱讀的內容、每個程式必須通過的兩個關卡、你不該宣稱的事項,以及只有人類能完成的步驟。這份文件很短,以下所有內容都以它為基礎。

在撰寫任何一行程式碼之前,請先閱讀 docs/reference/ppl.md——尤其是 §2,那裡列出了四個看似合理但實際錯誤的假設。

開發循環:三個指令

hpprime lint FILE.txt                  # 找出編譯器不會說明的問題
hpprime run  FILE.txt --call "F(2)"    # 在本機執行實際檔案,無需計算機
hpprime write FILE.txt -o PROG.hpprgm  # 建構二進位檔

接著,人類將 .hpprgm 拖曳至 Connectivity Kit 視窗中的計算機上。你無法自動化這個步驟,且複製到鏡像資料夾也無效——詳見 docs/reference/deploy.md。

hpprime doctor 檢查環境、hpprime new NAME 建立可直接執行的起手範本、hpprime build 製作應用程式、hpprime verify 驗證單一程式。所有指令說明請見 docs/tools.md。

如果使用者從未操作過 Prime

請先引導他們閱讀 docs/start/01-setup.md。這是一條從空資料夾到在計算機上執行應用程式的六步驟路徑,其中第六步驟涉及與你的協作方式。

安裝此技能

git clone https://github.com/JordiRigau/hp-prime-kit ~/.claude/skills/hp-prime

此倉庫本身即為技能:SKILL.md 位於根目錄,因此任何操作 .hpprgm 檔案或 PPL 程式碼的工作階段都可直接參考經量測的規則,無需自行猜測語法。

相關技能