render-puzzle-docs
À propos
Cette compétence génère le site de documentation Quarto de jigsawR pour GitHub Pages, prenant en charge les constructions fraîches (cache effacé), les constructions en cache (plus rapides) et le rendu de page unique. Elle est utilisée pour les constructions complètes du site après des modifications de contenu, les prévisualisations de page unique lors d'édition itérative, et la préparation de la documentation pour les versions ou les PRs. La compétence peut utiliser un script de rendu intégré ou appeler quarto.exe directement depuis WSL.
Installation rapide
Claude Code
Recommandénpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/render-puzzle-docsCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
name: render-puzzle-docs description: > jigsawRのQuartoドキュメントサイトをGitHub Pages用にレンダリングする。 フレッシュレンダリング（キャッシュクリア）、キャッシュレンダリング（高速）、 シングルページレンダリングをサポート。バンドルされたレンダースクリプトまたは WSLからの直接quarto.exe呼び出しを使用する。コンテンツ変更後のフルサイト ビルド、反復編集中のシングルページレンダリング、リリースやPR向けの ドキュメント準備、Quarto .qmdファイルのレンダーエラーデバッグに使用する。 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, quarto, documentation, github-pages, rendering locale: ja source_locale: en source_commit: 6f65f316 translator: claude-sonnet-4-6 translation_date: 2026-03-16
パズルドキュメントのレンダリング
jigsawRのQuartoドキュメントサイトをレンダリングする。
使用タイミング
- コンテンツ変更後のフルドキュメントサイトビルド
- 反復編集中のシングルページレンダリング
- リリースやPR向けのドキュメント準備
- Quarto .qmdファイルのレンダーエラーデバッグ
入力
- 必須: レンダリングモード（
fresh、cached、またはsingle） - 任意: 特定の.qmdファイルパス（シングルページモード用）
- 任意: ブラウザで結果を開くかどうか
手順
ステップ1: レンダリングモードの選択
| モード | コマンド | 所要時間 | 使用場面 |
|---|---|---|---|
| Fresh | bash inst/scripts/render_quarto.sh | 約5-7分 | コンテンツ変更、キャッシュが古い場合 |
| Cached | bash inst/scripts/render_quarto.sh --cached | 約1-2分 | 軽微な編集、キャッシュが有効な場合 |
| Single | 直接quarto.exe | 約30秒 | 1ページの反復作業 |
期待結果： 現在の状況に基づいてレンダリングモードが選択される：コンテンツ変更や古いキャッシュにはfresh、軽微な編集にはcached、1ページの反復にはsingle。
失敗時： キャッシュが古いかどうか不明な場合は、freshレンダリングをデフォルトにする。時間はかかるが正しい出力が保証される。
ステップ2: レンダリングの実行
フレッシュレンダリング（_freezeと_siteをクリアし、すべてのRコードを再実行）：
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh
キャッシュレンダリング（既存の_freezeファイルを使用）：
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached
シングルページ（1つの.qmdファイルを直接レンダリング）：
QUARTO_EXE="/mnt/c/Program Files/RStudio/resources/app/bin/quarto/bin/quarto.exe"
"$QUARTO_EXE" render quarto/getting-started.qmd
期待結果： レンダリングがエラーなく完了する。出力はquarto/_site/に格納される。
失敗時：
- .qmdチャンクのRコードエラーを確認する（
#| label:マーカーを探す） - pandocが
RSTUDIO_PANDOC環境変数経由で利用可能か確認する - キャッシュをクリアしてみる：
rm -rf quarto/_freeze quarto/_site - .qmdファイルで使用されるすべてのRパッケージがインストールされているか確認する
ステップ3: 出力の検証
ls -la /mnt/d/dev/p/jigsawR/quarto/_site/index.html
サイト構造を確認する：
quarto/_site/index.htmlが存在する- ナビゲーションリンクが正しく解決される
- 画像とSVGファイルが正しくレンダリングされる
期待結果： index.htmlが存在し空でない。ナビゲーションリンクが解決され、画像/SVGがブラウザで正しくレンダリングされる。
失敗時： index.htmlが見つからない場合、レンダリングがサイレントに失敗した可能性がある。詳細出力で再実行し、.qmdチャンクのRコードエラーを確認する。一部のページのみ欠落している場合、それらの.qmdファイルが_quarto.ymlにリストされているか確認する。
ステップ4: プレビュー（任意）
Windowsブラウザで開く：
cmd.exe /c start "" "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"
期待結果： ドキュメントサイトがWindowsのデフォルトブラウザで目視検査のために開く。
失敗時： WSLからcmd.exe /c startコマンドが失敗する場合、代わりにexplorer.exe "D:\\dev\\p\\jigsawR\\quarto\\_site\\index.html"を試す。または、ブラウザでファイルに手動でナビゲートする。
バリデーション
-
quarto/_site/index.htmlが存在し空でない - コンソール出力にレンダーエラーがない
- すべてのRコードチャンクが正常に実行された（エラーメッセージを確認）
- ページ間のナビゲーションが機能する
- すべての.qmdファイルがコードチャンクにクリーンな出力のための
#| label:を持つ
よくある落とし穴
- 古いフリーズキャッシュ: Rコードが変更された場合、
_freezeファイルを再生成するためにfreshレンダリングを使用する - 不足しているRパッケージ: Quarto .qmdファイルがrenvにないパッケージを使用している場合がある。先にインストールする
- pandocが見つからない:
.RenvironにRSTUDIO_PANDOCが設定されているか確認する - 長いレンダリング時間: freshレンダリングは5-7分かかる（R実行を伴う14ページ）。反復中はcachedモードを使用する
- コードチャンクラベル: すべてのRコードチャンクにクリーンなレンダリングのための
#| label:が必要
関連スキル
generate-puzzle— ドキュメントで参照されるパズル出力を生成するrun-puzzle-tests— ドキュメント内のコード例が正しいことを確認するcreate-quarto-report— 一般的なQuartoドキュメント作成
Dépôt GitHub
Compétences associées
executing-plans
DesignUtilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
requesting-code-review
DesignCette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
connect-mcp-server
DesignCette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
web-cli-teleport
DesignCette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.