MCP HubMCP Hub
Retour aux compétences

render-puzzle-docs

pjt222
Mis à jour Yesterday
5 vues
17
2
17
Voir sur GitHub
Métaworddesign

À propos

Cette compétence génère le site de documentation jigsawR Quarto pour GitHub Pages, prenant en charge les rendus frais, mis en cache ou sur une seule page. Utilisez-la pour des constructions complètes du site après des modifications de contenu, pour le rendu d'une seule page lors d'une édition itérative, ou pour préparer la documentation pour les versions. Elle peut utiliser soit un script groupé, soit une invocation directe de Quarto via WSL.

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/render-puzzle-docs

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

Documentation

渲拼之文檔

渲 jigsawR 之 Quarto 文檔站。

用時

  • 內變後建全文檔站乃用
  • 於迭編時渲單頁乃用
  • 為釋或 PR 備文檔乃用
  • 於 Quarto .qmd 之文中察渲誤乃用

  • 必要:渲模(freshcached、或 single
  • 可選:具體 .qmd 文之路(為單頁模)
  • 可選:是否於覽器開其果

第一步:擇渲模

用時
Freshbash inst/scripts/render_quarto.sh~5-7 分內變、緩陳
Cachedbash inst/scripts/render_quarto.sh --cached~1-2 分微編、緩有效
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 缺,渲或暗敗。重行附詳出察 R 碼之誤於 .qmd 塊。若獨某頁缺,驗其 .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: 以清渲

  • 陳之凍緩:若 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

pjt222/agent-almanac
Chemin: i18n/wenyan/skills/render-puzzle-docs
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