render-puzzle-docs
À propos
Cette compétence génère le site de documentation jigsawR Quarto pour GitHub Pages, prenant en charge des rendus frais, mis en cache ou sur une seule page. Utilisez-la après des modifications de contenu, lors d'édition itérative, ou lors de la préparation de la documentation pour les versions. Elle peut utiliser soit des scripts groupés, soit une invocation directe de Quarto via 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
渲拼文
渲 jigsawR Quarto 文站。
用
- 容變後建全站
- 漸編時渲一頁
- 為發或 PR 備文
- 除 Quarto .qmd 渲錯
入
- 必:渲模(
fresh、cached、single) - 可:特 .qmd 路(單頁模)
- 可:果開於瀏覽乎
行
一:擇渲模
| Mode | Command | Duration | Use when |
|---|---|---|---|
| Fresh | bash inst/scripts/render_quarto.sh | ~5-7 min | Content changed, cache stale |
| Cached | bash inst/scripts/render_quarto.sh --cached | ~1-2 min | Minor edits, cache valid |
| Single | Direct quarto.exe | ~30s | Iterating on one page |
得:渲模按況選:fresh 為容變或舊快取、cached 為微編、single 為迭一頁。
敗:未定快取舊乎→默 fresh。費時而保正出。
二:執渲
Fresh 渲(清 _freeze 與 _site、重執諸 R 碼):
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh
Cached 渲(用現 _freeze 檔):
cd /mnt/d/dev/p/jigsawR && bash inst/scripts/render_quarto.sh --cached
單頁(直渲一 .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 包皆裝
三:驗出
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。
四:預(可)
於 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:為潔出
忌
- 舊 freeze 快取:R 碼變、用 fresh 渲重生
_freeze檔 - 缺 R 包:Quarto .qmd 或用 renv 外包;先裝
- Pandoc 不見:確
RSTUDIO_PANDOC設於.Renviron - 長渲時:Fresh 渲費 5-7 分(14 頁含 R 執);迭時用 cached 模
- 碼塊標:諸 R 碼塊應有
#| label:為潔渲
參
generate-puzzle— 生文中所引拼出run-puzzle-tests— 確文中碼例正create-quarto-report— 通 Quarto 文建
Dépôt GitHub
Compétences associées
content-collections
MétaCette 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.
polymarket
MétaCette 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.
creating-opencode-plugins
MétaCette 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.
sglang
MétaSGLang 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.
