MCP HubMCP Hub
← Retour aux compétences

generate-puzzle

pjt222
Mis à jour Yesterday
3 vues
17
2
17
Voir sur GitHub
Métageneral

À propos

Cette compétence génère des puzzles de type "casse-tête" en utilisant le package R jigsawR, prenant en charge les types de puzzles rectangulaires, hexagonaux, concentriques, de Voronoi et SNIC avec des paramètres configurables. Elle crée des fichiers SVG ou des visualisations ggplot2 et valide les paramètres par rapport à un fichier de configuration. Utilisez-la pour tester différents réglages de génération, créer des exemples de documentation ou produire des graphiques de puzzles pour des projets.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/generate-puzzle

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

name: generate-puzzle description: > generate_puzzle()またはgeom_puzzle_*()を使用してジグソーパズルを生成し、 inst/config.ymlに対するパラメータバリデーションを実行する。矩形、六角形、 同心円、ボロノイ、snicパズルタイプをサポートし、グリッド、サイズ、シード、 オフセット、レイアウトのパラメータを設定可能。特定のタイプと設定でパズル SVGファイルを作成する場合、異なるパラメータで生成をテストする場合、 ドキュメントやデモ用のサンプル出力を生成する場合、またはggplot2パズル 可視化を作成する場合に使用する。 license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: jigsawr complexity: basic language: R tags: jigsawr, puzzle, svg, generation, ggplot2 locale: ja source_locale: en source_commit: 6f65f316 translator: claude-sonnet-4-6 translation_date: 2026-03-16

パズル生成

jigsawRパッケージの統合APIを使用してジグソーパズルを生成する。

使用タイミング

  • 特定のタイプと設定でパズルSVGファイルを作成する場合
  • 異なるパラメータでパズル生成をテストする場合
  • ドキュメントやデモ用のサンプル出力を生成する場合
  • geom_puzzle_*()を使用してggplot2パズル可視化を作成する場合

入力

  • 必須: パズルタイプ ("rectangular", "hexagonal", "concentric", "voronoi", "random", "snic")
  • 必須: グリッド寸法（タイプ依存：c(cols, rows)またはc(rings)）
  • 任意: サイズ（mm単位、デフォルトはタイプにより異なる）
  • 任意: シード（再現性のため、デフォルト：42）
  • 任意: オフセット（0 = 連結、>0 = 分離ピース）
  • 任意: レイアウト（矩形の場合"grid"または"repel"）
  • 任意: フュージョングループ（PILES記法文字列）

手順

ステップ1: 設定制約の確認

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)"

またはinst/config.ymlを直接読み取り、選択したタイプの有効範囲を確認する。

期待結果： 選択したパズルタイプのgrid、size、tabsize、その他のパラメータの最小/最大値が判明する。

失敗時： config.ymlが見つからないかタイプキーが存在しない場合、jigsawRプロジェクトのルートにいるか、パッケージが少なくとも一度ビルドされているか確認する。

ステップ2: タイプとパラメータの決定

ユーザーのリクエストを有効なgenerate_puzzle()引数にマッピングする：

タイプgridsize追加パラメータ
rectangularc(cols, rows)c(width, height) mmoffset, layout, tabsize
hexagonalc(rings)c(diameter) mmdo_warp, do_trunc, tabsize
concentricc(rings)c(diameter) mmcenter_shape, tabsize
voronoic(cols, rows)c(width, height) mmn_interior, tabsize
randomc(cols, rows)c(width, height) mmn_interior, tabsize
snicc(cols, rows)c(width, height) mmn_interior, compactness, tabsize

期待結果： ユーザーリクエストがconfig.ymlの範囲内の正しいtype、grid寸法、size値を持つ有効なgenerate_puzzle()引数にマッピングされる。

失敗時： どのパラメータ形式を使用するか不明な場合は、上記の表を参照する。矩形とボロノイタイプはgridにc(cols, rows)を使用し、六角形と同心円タイプはc(rings)を使用する。

ステップ3: Rスクリプトの作成

スクリプトファイルを作成する（複雑なコマンドの場合は-eより推奨）：

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")

一時スクリプトファイルに保存する。

期待結果： library(jigsawR)、すべてのパラメータを含むgenerate_puzzle()呼び出し、診断出力行を含むRスクリプトファイルが一時的な場所に保存される。

失敗時： スクリプトに構文エラーがある場合、すべての文字列引数が引用符で囲まれ、数値ベクトルがc()を使用しているか確認する。常にスクリプトファイルを使用して複雑なシェルエスケープを回避する。

ステップ4: WSL Rによる実行

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

期待結果： スクリプトがエラーなく完了する。SVGファイルがoutput/に書き込まれる。

失敗時： renvが復元されているか確認する（renv::restore()）。パッケージがロードされているか確認する（devtools::load_all()）。--vanillaフラグは使用しないこと（renvは.Rprofileが必要）。

ステップ5: 出力の検証

  • SVGファイルがoutput/ディレクトリに存在する
  • SVGコンテンツが<?xmlまたは<svgで始まる
  • ピース数が期待値と一致する：cols * rows（矩形）、リング公式（hex/concentric）
  • ggplot2アプローチの場合、プロットオブジェクトがエラーなくレンダリングされることを確認する

期待結果： SVGファイルがoutput/に存在し、コンテンツが<?xmlまたは<svgで始まり、ピース数がグリッド仕様と一致する（矩形はcols * rows、hex/concentricはリング公式）。

失敗時： SVGファイルが見つからない場合、output/ディレクトリが存在するか確認する。ピース数が間違っている場合、グリッド寸法がパズルタイプの期待される公式と一致するか確認する。ggplot2出力の場合、tryCatch()でラップしてプロットがエラーなくレンダリングされるか確認する。

ステップ6: 出力の保存

生成されたファイルはデフォルトでoutput/に保存される。resultオブジェクトには以下が含まれる：

  • $svg_content — 生のSVG文字列
  • $pieces — ピースデータのリスト
  • $canvas_size — 寸法
  • $files — 書き込まれたファイルのパス

期待結果： resultオブジェクトに$svg_content、$pieces、$canvas_size、$filesフィールドが含まれる。$filesにリストされたファイルがディスク上に存在する。

失敗時： $filesが空の場合、パズルはメモリ内のみで生成された可能性がある。writeLines(result$svg_content, "output/puzzle.svg")で明示的に保存する。

バリデーション

  • スクリプトがエラーなく実行される
  • SVGファイルが整形式のXMLである
  • ピース数がグリッド仕様と一致する
  • 同じシードで同一の出力が生成される（再現性）
  • パラメータがconfig.ymlの制約内にある

よくある落とし穴

  • --vanillaフラグの使用: renvの有効化を破壊する。絶対に使用しないこと。
  • 複雑な-eコマンド: 代わりにスクリプトファイルを使用する。シェルエスケープがExit code 5を引き起こす。
  • グリッドとサイズの混同: グリッドはピース数、サイズはmm単位の物理的寸法。
  • オフセットの意味: 0 = 組み立てられたパズル、正の値 = 展開/分離されたピース。
  • snicにパッケージが必要: snicタイプにはsnicパッケージのインストールが必要。

関連スキル

  • add-puzzle-type — 新しいパズルタイプをエンドツーエンドでスキャフォールドする
  • validate-piles-notation — generate_puzzle()に渡す前にフュージョングループ文字列を検証する
  • run-puzzle-tests — 生成変更後にテストスイートを実行する
  • write-testthat-tests — 新しい生成シナリオのテストを追加する

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/ja/skills/generate-puzzle
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

content-collections

Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence

polymarket

Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence

creating-opencode-plugins

Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence

sglang

Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence