render-puzzle-docs
О программе
Этот навык рендерит сайт документации jigsawR Quarto для GitHub Pages, поддерживая свежие, кешированные или одностраничные рендеры. Используйте его после изменений контента, в процессе итеративного редактирования или при подготовке документации к выпускам. Он может использовать как встроенные скрипты, так и прямой вызов Quarto через WSL.
Быстрая установка
Claude Code
Рекомендуется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-docsСкопируйте и вставьте эту команду в Claude Code для установки этого навыка
Документация
渲拼文
渲 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 文建
GitHub репозиторий
Похожие навыки
content-collections
МетаЭтот навык предоставляет проверенную в продакшене настройку для Content Collections — TypeScript-ориентированного инструмента, который преобразует файлы Markdown/MDX в типобезопасные коллекции данных с валидацией Zod. Используйте его при создании блогов, сайтов документации или контентных приложений на Vite + React для обеспечения типобезопасности и автоматической проверки содержимого. Он охватывает всё: от настройки плагина Vite и компиляции MDX до оптимизации развертывания и валидации схем.
polymarket
МетаЭтот навык позволяет разработчикам создавать приложения на платформе прогнозных рынков Polymarket, включая интеграцию с API для торговли и получения рыночных данных. Он также обеспечивает потоковую передачу данных в реальном времени через WebSocket для отслеживания текущих сделок и рыночной активности. Используйте его для реализации торговых стратегий или создания инструментов, обрабатывающих обновления рынка в реальном времени.
creating-opencode-plugins
МетаЭтот навык помогает разработчикам создавать плагины OpenCode, которые подключаются к более чем 25 типам событий, таким как команды, файлы и операции LSP. Он предоставляет структуру плагина, спецификации API событий и шаблоны реализации для модулей на JavaScript/TypeScript. Используйте его, когда вам нужно перехватывать, отслеживать или расширять жизненный цикл ассистента OpenCode AI с помощью пользовательской событийно-ориентированной логики.
sglang
МетаSGLang — это высокопроизводительный фреймворк для обслуживания больших языковых моделей (LLM), специализирующийся на быстрой структурированной генерации JSON, regex и рабочих процессов агентов с использованием кэширования префиксов RadixAttention. Он обеспечивает значительно более высокую скорость вывода, особенно для задач с повторяющимися префиксами, что делает его идеальным для сложных структурированных результатов и многократных диалогов. Выбирайте SGLang вместо альтернатив, таких как vLLM, когда вам требуется ограниченное декодирование или вы создаете приложения с интенсивным совместным использованием префиксов.
