Communitygithub.com

JordiRigau/hp-prime-kit

Kit HP Prime pronto para agente: AGENTS.md com as regras do PPL medidas em um G2 real, um linter, um interpretador que executa o mesmo código que você instala e um construtor .hpprgm — para que um agente possa escrever, verificar e empacotar um programa sem tocar na calculadora.

O que é hp-prime-kit?

Este kit resolve os dois maiores desperdícios de tempo ao programar para a calculadora HP Prime em PPL: adivinhar a sintaxe (já que a documentação é ruim e o compilador só informa 'syntax error' com o número da linha) e o ritual de copiar e compilar no Connectivity Kit. O repositório funciona como uma habilidade para agentes de IA (como Claude Code, Cursor ou Codex): contém um arquivo AGENTS.md que define o contrato operacional, um linter, um interpretador que executa o mesmo código-fonte que será instalado na calculadora, e um construtor de binários .hpprgm. O loop de desenvolvimento é simples: o agente usa comandos como `hpprime lint` para verificar a sintaxe, `hpprime run` para testar localmente e `hpprime write` para gerar o pacote — e o humano apenas arrasta o arquivo gerado para o Connectivity Kit. Comandos adicionais como `hpprime doctor`, `hpprime new` e `hpprime verify` cobrem diagnóstico, criação de projetos e validação. O kit inclui também documentação de referência detalhada, incluindo hipóteses comuns que parecem corretas mas são falsas.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

HP Prime

O PPL é mal documentado e seu compilador só informa syntax error com um número de linha. Este kit elimina as duas coisas que mais desperdiçam tempo: adivinhar a sintaxe e o ritual de copiar e compilar no Connectivity Kit.

Comece por aqui

Leia AGENTS.md. É o contrato operacional deste repositório: o que ler antes de escrever PPL, os dois gargalos que todo programa atravessa, o que você não deve afirmar e o que só o humano pode fazer. É curto, e tudo abaixo assume que você o leu.

Depois leia docs/reference/ppl.md antes de escrever uma linha — especialmente §2, quatro hipóteses que parecem razoáveis e são falsas.

O loop, em três comandos

hpprime lint ARQUIVO.txt                  # o que o compilador não explicará
hpprime run  ARQUIVO.txt --call "F(2)"    # executa o arquivo real, aqui, sem calculadora
hpprime write ARQUIVO.txt -o PROG.hpprgm  # constrói o binário

Então o humano arrasta o .hpprgm para a calculadora na janela do Connectivity Kit. Você não pode fazer essa etapa, e copiar para a pasta espelho não funciona — docs/reference/deploy.md.

hpprime doctor verifica a máquina, hpprime new NOME escreve um iniciador que já roda, hpprime build cria um aplicativo, hpprime verify verifica um. Cada comando está em docs/tools.md.

Se o usuário nunca programou uma Prime

Envie-o para docs/start/01-setup.md antes de qualquer outra coisa. É um caminho de seis passos de uma pasta vazia até algo rodando na calculadora, e o passo 6 é sobre trabalhar com você.

Instalando esta habilidade

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

O repositório é a habilidade: SKILL.md está em sua raiz, então qualquer sessão que toque em arquivos .hpprgm ou código PPL terá as regras medidas à sua frente, em vez de improvisar a sintaxe.

Habilidades Relacionadas