Agent-almanac generate-puzzle

install

source · Clone the upstream repo

git clone https://github.com/pjt222/agent-almanac

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/es/skills/generate-puzzle" ~/.claude/skills/pjt222-agent-almanac-generate-puzzle-5c6964 && rm -rf "$T"

manifest: i18n/es/skills/generate-puzzle/SKILL.md

source content

Generar Rompecabezas

Generar rompecabezas usando la API unificada del paquete jigsawR.

Cuando Usar

Crear archivos SVG de rompecabezas para un tipo y configuracion especificos
Probar la generacion de rompecabezas con diferentes parametros
Generar salida de muestra para documentacion o demos
Crear visualizaciones de rompecabezas con geom_puzzle_*() de ggplot2

Entradas

Requerido: Tipo de rompecabezas (

"rectangular"

"hexagonal"

"concentric"

"voronoi"

"random"

"snic"

)

Requerido: Dimensiones de cuadricula (dependiente del tipo:
```
c(cols, rows)
```
o
```
c(rings)
```
)
Opcional: Tamano en mm (el valor predeterminado varia segun el tipo)
Opcional: Semilla para reproducibilidad (predeterminado: 42)
Opcional: Desplazamiento (0 = entrelazado, >0 = piezas separadas)
Opcional: Disposicion (
```
"grid"
```
o
```
"repel"
```
para rectangular)
Opcional: Grupos de fusion (cadena en notacion PILES)

Procedimiento

Paso 1: Leer Restricciones de Configuracion

R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"
"$R_EXE" -e "cat(yaml::yaml.load_file('inst/config.yml')[['{TYPE}']]$grid$max)"

O leer

inst/config.yml

directamente para verificar los rangos validos para el tipo elegido.

Esperado: Los valores min/max para grid, size, tabsize y otros parametros son conocidos para el tipo de rompecabezas elegido.

En caso de fallo: Si

config.yml

no existe o la clave del tipo no existe, verificar que se encuentra en la raiz del proyecto jigsawR y que el paquete ha sido compilado al menos una vez.

Paso 2: Determinar Tipo y Parametros

Mapear la solicitud del usuario a argumentos validos de

generate_puzzle()

Tipo	grid	size	Parametros extra
rectangular	`c(cols, rows)`	`c(width, height)` mm	`offset` , `layout` , `tabsize`
hexagonal	`c(rings)`	`c(diameter)` mm	`do_warp` , `do_trunc` , `tabsize`
concentric	`c(rings)`	`c(diameter)` mm	`center_shape` , `tabsize`
voronoi	`c(cols, rows)`	`c(width, height)` mm	`n_interior` , `tabsize`
random	`c(cols, rows)`	`c(width, height)` mm	`n_interior` , `tabsize`
snic	`c(cols, rows)`	`c(width, height)` mm	`n_interior` , `compactness` , `tabsize`

Esperado: La solicitud del usuario mapeada a argumentos validos de

generate_puzzle()

con

type

, dimensiones

grid

y valores

size

correctos dentro de los rangos de config.yml.

En caso de fallo: Si no esta seguro de que formato de parametro usar, consulte la tabla anterior. Los tipos rectangular y voronoi usan

c(cols, rows)

para grid; hexagonal y concentric usan

c(rings)

Paso 3: Crear Script R

Escribir un archivo de script (preferido sobre

-e

para comandos complejos):

library(jigsawR)

result <- generate_puzzle(
  type = "rectangular",
  seed = 42,
  grid = c(3, 4),
  size = c(400, 300),
  offset = 0,
  layout = "grid"
)

cat("Pieces:", length(result$pieces), "\n")
cat("SVG length:", nchar(result$svg_content), "\n")
cat("Files:", paste(result$files, collapse = ", "), "\n")

Guardar en un archivo de script temporal.

Esperado: Un archivo de script R guardado en una ubicacion temporal que contiene

library(jigsawR)

, una llamada a

generate_puzzle()

con todos los parametros y lineas de salida diagnostica.

En caso de fallo: Si el script tiene errores de sintaxis, verificar que todos los argumentos de cadena estan entre comillas y los vectores numericos usan

c()

. Evitar el escape complejo del shell usando siempre archivos de script.

Paso 4: Ejecutar mediante WSL R

R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"
"$R_EXE" /path/to/script.R

Esperado: El script se completa sin errores. Archivo(s) SVG escritos en

output/

En caso de fallo: Verificar que renv esta restaurado (

renv::restore()

). Verificar que el paquete esta cargado (

devtools::load_all()

). NO usar la bandera

--vanilla

(renv necesita .Rprofile).

Paso 5: Verificar Salida

El archivo SVG existe en el directorio
```
output/
```
El contenido SVG comienza con
```
<?xml
```
o
```
<svg
```
El conteo de piezas coincide con lo esperado: cols * rows (rectangular), formula de anillos (hex/concentric)
Para el enfoque ggplot2, verificar que el objeto de grafico se renderiza sin error

Esperado: El archivo SVG existe en

output/

, el contenido comienza con

<?xml

<svg

, y el conteo de piezas coincide con la especificacion de cuadricula (cols * rows para rectangular, formula de anillos para hex/concentric).

En caso de fallo: Si falta el archivo SVG, verificar que el directorio

output/

existe. Si el conteo de piezas es incorrecto, verificar que las dimensiones de cuadricula coinciden con la formula esperada del tipo de rompecabezas. Para salida ggplot2, verificar que el grafico se renderiza sin error envolviendolo en

tryCatch()

Paso 6: Guardar Salida

Los archivos generados se guardan en

output/

por defecto. El objeto

result

contiene:

```
$svg_content
```
-- cadena SVG sin procesar
```
$pieces
```
-- lista de datos de piezas
```
$canvas_size
```
-- dimensiones
```
$files
```
-- rutas a archivos escritos

Esperado: El objeto

result

contiene los campos

$svg_content

$pieces

$canvas_size

$files

. Los archivos listados en

$files

existen en disco.

En caso de fallo: Si

$files

esta vacio, el rompecabezas puede haberse generado solo en memoria. Guardar explicitamente con

writeLines(result$svg_content, "output/puzzle.svg")

Validacion

El script se ejecuta sin errores
El archivo SVG es XML bien formado
El conteo de piezas coincide con la especificacion de cuadricula
La misma semilla produce salida identica (reproducibilidad)
Los parametros estan dentro de las restricciones de config.yml

Errores Comunes

Usar la bandera
--vanilla
: Rompe la activacion de renv. Nunca usarla.
Comandos
-e
complejos: Usar archivos de script en su lugar; el escape del shell causa codigo de salida 5.
Confusion grid vs size: Grid es el conteo de piezas, size son las dimensiones fisicas en mm.
Semantica de offset: 0 = rompecabezas ensamblado, positivo = piezas explotadas/separadas.
SNIC sin paquete: El tipo snic requiere el paquete
```
snic
```
instalado.

Habilidades Relacionadas

```
add-puzzle-type
```
-- crear un nuevo tipo de rompecabezas de principio a fin
```
validate-piles-notation
```
-- validar cadenas de grupos de fusion antes de pasarlas a generate_puzzle()
```
run-puzzle-tests
```
-- ejecutar la suite de pruebas despues de cambios en la generacion
```
write-testthat-tests
```
-- agregar pruebas para nuevos escenarios de generacion