render-puzzle-docs
À propos
Cette compétence génère le site de documentation jigsawR Quarto pour GitHub Pages, prenant en charge des compilations complètes (nouvelles ou mises en cache) ou des rendus de pages individuelles. Elle est utilisée après des modifications de contenu, lors d'éditions itératives, ou lors de la préparation de la documentation pour des versions. La compétence peut utiliser des scripts groupés ou 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 文件路徑(單頁模式)
- 選擇性:是否於瀏覽器開啟結果
步驟
步驟一:擇渲染模式
| 模式 | 命令 | 時長 | 用時 |
|---|---|---|---|
| Fresh | bash inst/scripts/render_quarto.sh | ~5-7 min | 內容已變、快取陳舊 |
| Cached | bash inst/scripts/render_quarto.sh --cached | ~1-2 min | 小編輯、快取仍有效 |
| Single | 直接 quarto.exe | ~30s | 反覆於一頁 |
預期: 依當前情況擇模式:內容變或快取陳舊則 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.
