Communitygithub.com

JordiRigau/hp-prime-kit

面向AI代理的HP Prime工具包:包含AGENTS.md(基于真实G2实测的PPL规则)、语法检查器、解释器(可直接运行与安装后相同的源代码)以及.hpprgm构建工具——让AI代理无需接触计算器即可编写、检查和打包程序。

hp-prime-kit 是什么?

该技能为AI代理(如Claude Code、Cursor等)提供了一个完整的HP Prime计算器PPL(Prime Programming Language)开发工具链,旨在消除开发过程中最耗时的两个痛点:语法猜测和反复编译/粘贴的流程。它包含一个基于真实G2硬件实测的规则文档(AGENTS.md),一个能给出比官方编译器更详细错误信息的语法检查器(linter),一个可以直接在开发机上运行相同PPL源文件的解释器,以及一个用于生成最终可安装.hpprgm二进制文件的构建工具。支持通过`hpprime lint`、`hpprime run`和`hpprime write`三个核心命令完成从编写、测试到打包的完整闭环,最后仅需人类将构建好的文件拖入连接工具即可部署到计算器上。工具还提供`hpprime doctor`环境诊断、`hpprime new`项目脚手架生成、`hpprime build`应用构建和`hpprime verify`校验等辅助命令。对于从未接触过HP Prime编程的用户,还提供了从零开始的六步教程(docs/start/01-setup.md)。整个技能仓库本身就是一个完整的解决方案,克隆到`~/.claude/skills/hp-prime`后即可在所有涉及PPL或.hpprgm文件的会话中使用。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HP Prime

PPL的文档资料匮乏,且其编译器仅会给出带有行号的 语法错误 提示。本工具包消除了两个最耗时的环节:猜测语法 和 在连接工具中反复粘贴和编译。

从这里开始

请阅读 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 文件拖到连接工具窗口中的计算器上。你无法完成这一步,复制到镜像文件夹也无法生效 —— 请参考 docs/reference/deploy.md。

hpprime doctor 检查环境配置,hpprime new NAME 创建一个可立即运行的启动项目,hpprime build 构建应用程序,hpprime verify 验证单个文件。每个命令的详细说明在 docs/tools.md 中。

如果用户从未编写过Prime程序

请先引导他们阅读 docs/start/01-setup.md。这是一条从空文件夹出发、直到在计算器上运行程序的六步路径,其中第6步涉及与你协作。

安装本技能

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

该仓库 就是 技能本身:SKILL.md 位于其根目录,因此任何涉及 .hpprgm 文件或 PPL 代码的会话都能直接使用经过实际测量的规则,而无需临时拼凑语法。

相关技能