Communitygithub.com

JordiRigau/hp-prime-kit

Agent-bereites HP Prime Toolkit: AGENTS.md mit den auf einem echten G2 gemessenen PPL-Regeln, ein Linter, ein Interpreter der exakt die gleiche Quelle ausführt, die installiert wird, und ein .hpprgm-Builder – damit ein Agent Programme schreiben, prüfen und paketieren kann, ohne den Taschenrechner zu berühren.

Was ist hp-prime-kit?

Dieses Toolkit ermöglicht KI-Agenten (wie Claude Code, Cursor oder Codex) die Arbeit mit HP Prime Programmen in der PPL-Sprache, ohne dass ein physischer Taschenrechner erforderlich ist. Es löst die beiden Hauptprobleme von PPL: die schlechte Dokumentation und den zeitaufwändigen Prozess des Kopierens und Kompilierens über die Connectivity Kit Software. Das Toolkit enthält einen Linter (hpprime lint), der die kryptischen Syntaxfehler des PPL-Compilers klar erklärt, einen Interpreter (hpprime run), der die identische Datei ausführt, die später auf dem Taschenrechner installiert wird, und einen Builder (hpprime write), der .hpprgm-Dateien erzeugt, die der Benutzer per Drag & Drop auf den Rechner ziehen kann. Der Workflow folgt einer klaren Schleife: Linten, Ausführen, Bauen – unterstützt durch Hilfskommandos wie hpprime doctor, new, build und verify. Die AGENTS.md Datei dient als verbindlicher Vertrag, der festlegt, was der Agent vor dem Schreiben von PPL lesen muss, welche beiden Prüfungen jedes Programm durchläuft, was der Agent nicht behaupten darf und welche Schritte nur der Mensch ausführen kann. Das Repository selbst ist die Skill-Definition mit SKILL.md im Wurzelverzeichnis, sodass jede Session, die mit .hpprgm-Dateien oder PPL-Code arbeitet, direkt die Regelbasis zur Hand hat.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add JordiRigau/hp-prime-kit

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

HP Prime

PPL ist schlecht dokumentiert und sein Compiler gibt nur Syntaxfehler mit einer Zeilennummer aus. Dieses Toolkit beseitigt die beiden Dinge, die die meiste Zeit verschwenden: das Erraten der Syntax und das Kopier- und Kompilier-Ritual im Connectivity Kit.

Hier starten

Lies AGENTS.md. Es ist der Betriebsvertrag dieses Repositories: was vor dem Schreiben von PPL zu lesen ist, die beiden Prüfungen, die jedes Programm durchläuft, was du nicht behaupten darfst und was nur der Mensch tun kann. Er ist kurz, und alles unten setzt ihn voraus.

Dann lies docs/reference/ppl.md, bevor du eine Zeile schreibst – insbesondere §2, vier Hypothesen, die vernünftig aussehen und doch falsch sind.

Die Schleife in drei Befehlen

hpprime lint DATEI.txt                  # was der Compiler nicht erklären wird
hpprime run  DATEI.txt --call "F(2)"    # führe die echte Datei aus, hier, kein Taschenrechner
hpprime write DATEI.txt -o PROG.hpprgm  # erzeuge die Binärdatei

Dann zieht der Mensch die .hpprgm-Datei im Connectivity-Kit-Fenster auf den Taschenrechner. Diesen Schritt kannst du nicht ausführen, und das Kopieren in den Spiegelordner funktioniert nicht – docs/reference/deploy.md.

hpprime doctor prüft die Maschine, hpprime new NAME schreibt einen Starter, der bereits läuft, hpprime build erstellt eine App, hpprime verify prüft eine. Jeder Befehl steht in docs/tools.md.

Wenn der Benutzer noch nie einen Prime programmiert hat

Schicke ihn zuerst zu docs/start/01-setup.md. Es ist ein sechs Schritte umfassender Weg von einem leeren Ordner zu etwas, das auf dem Taschenrechner läuft – und Schritt 6 handelt von der Zusammenarbeit mit dir.

Installation dieses Skills

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

Das Repository ist der Skill: SKILL.md befindet sich im Stammverzeichnis, sodass jede Session, die .hpprgm-Dateien oder PPL-Code bearbeitet, die gemessenen Regeln vor sich hat, anstatt Syntax zu improvisieren.

Verwandte Skills