Communitygithub.com

JordiRigau/hp-prime-kit

エージェント対応HP Primeツールキット:実機G2で計測されたPPLルールを記したAGENTS.md、リンター、インストールするソースそのまま実行できるインタプリタ、.hpprgmビルダーを提供。エージェントは電卓に触れずにプログラムの作成、チェック、パッケージ化が可能。

hp-prime-kit とは?

このスキルは、HP Prime電卓のPPL言語向け開発キットです。PPLのドキュメントは不十分で、コンパイラは行番号付きの「syntax error」しか出力しないため、開発効率が非常に悪いという問題を解決します。本キットは、**構文の推測**と**Connectivity Kitでのペースト&コンパイル作業**という二大時間浪費要因を排除します。 主な機能として、リンター(`hpprime lint`)、実機と同じソースを実行できるインタプリタ(`hpprime run`)、.hpprgmバイナリビルダー(`hpprime write`)を提供。また、`AGENTS.md`にエージェントと人間の役割分担が明確に定義されており、エージェントはリンターとインタプリタでコードを検証し、最終的な電卓へのデプロイは人間がConnectivity Kit経由で行います。`hpprime doctor`, `hpprime new`, `hpprime build`, `hpprime verify`などの補助コマンドも用意されています。 このスキルはClaude CodeやCursorなどのAIエージェント環境で動作し、リポジトリ全体をスキルとしてクローンすることで、セッション中にPPLの正確なルールを参照できます。初めてPrimeを触るユーザー向けの段階的なセットアップガイド(`docs/start/01-setup.md`)も含まれています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HP Prime

PPLのドキュメントは不十分で、コンパイラは行番号付きの「syntax error」としか出力しません。 このキットは、最も時間を浪費する2つの作業、構文の推測とConnectivity Kitでのペースト&コンパイル作業を排除します。

ここから始める

最初にAGENTS.mdを読んでください。 これはこのリポジトリの運用契約書です:PPLを書く前に読むべき内容、すべてのプログラムが通過する2つのゲート、あなたが主張してはいけないこと、そして人間だけが実行できること。短い文書で、以下のすべてはこれを前提としています。

次に、コードを書き始める前にdocs/reference/ppl.mdを読んでください——特に§2「妥当に見えて実際は間違っている4つの仮説」です。

3つのコマンドで完結するループ

hpprime lint FILE.txt                  # コンパイラが説明してくれないことをチェック
hpprime run  FILE.txt --call "F(2)"    # 実際のファイルをここで実行、電卓不要
hpprime write FILE.txt -o PROG.hpprgm  # バイナリをビルド

その後、人間がConnectivity Kitウィンドウで.hpprgmファイルを電卓にドラッグします。この手順はあなた(エージェント)は実行できません。また、ミラーフォルダにコピーしても機能しません——詳細はdocs/reference/deploy.mdを参照してください。

hpprime doctorはマシンの状態を確認、hpprime new NAMEはすぐに実行できるスターターファイルを作成、hpprime buildはアプリを作成、hpprime verifyは1つのファイルを検証します。すべてのコマンドはdocs/tools.mdに記載されています。

ユーザーがPrimeを全く触ったことがない場合

まず最初にdocs/start/01-setup.mdを読むように伝えてください。空のフォルダから電卓で動作するものを作るまでの6ステップの手順で、ステップ6ではあなたとの協業について説明しています。

このスキルのインストール

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

リポジトリそのものがスキルです:SKILL.mdがルートに配置されているため、.hpprgmファイルやPPLコードを扱うセッションでは、構文を推測する代わりに測定されたルールを参照できます。

関連スキル