O que pokemon-harness faz?
Harness local para agente LLM do Pokémon Red com UI de gameplay ao vivo, traces estruturados, estados de save, replay e observabilidade turno a turno do agente.
Descrição
Este skill permite que um agente de LLM (como Claude, GPT ou outro) controle o jogo Pokémon Red em um ambiente local. Ele oferece uma interface de usuário interativa que exibe o estado do jogo em tempo real, permitindo que os desenvolvedores vejam exatamente o que o agente está fazendo. Além disso, ele grava todas as ações do agente em traces estruturados (estrutura de dados rastreável), suporta salvamento e carregamento de estados do jogo (save states), e permite a reprodução de sequências de ações (replay). A observabilidade turno a turno é fundamental para depurar ou entender as decisões do agente.
Como usar
- Clone o repositório do skill.
- Instale as dependências necessárias (consulte o README do repositório).
- Execute o harness com seu agente LLM configurado.
- A UI será iniciada, mostrando o jogo e os controles de observabilidade.
Recursos
- Live Gameplay UI: Visualize o jogo sendo jogado pelo agente em tempo real.
- Structured Traces: Cada ação do agente é registrada em um formato estruturado para análise.
- Save States: Salve e carregue estados do jogo a qualquer momento.
- Replay: Reproduza sequências de ações do agente.
- Turn-by-Turn Observability: Inspecione decisões do agente passo a passo.
Exemplo de uso com código
from pokemon_harness import Harness
from my_agent import MyAgent
harness = Harness()
agent = MyAgent()
while not harness.game_over:
estado = harness.get_state()
acao = agent.decide(estado)
harness.execute_action(acao)
Plataformas suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes baseados em LLM
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório.