MCP HubMCP Hub
← Retour aux compétences

submit-to-cran

pjt222
Mis à jour 5 days ago
11 vues
17
2
17
Voir sur GitHub
Métadesign

À propos

Cette compétence offre un flux de travail complet pour soumettre des packages R au CRAN, couvrant les versions initiales, les mises à jour et les re-soumissions. Elle automatise les vérifications préalables à la soumission, incluant la validation locale, les tests win-builder et R-hub, ainsi que la préparation de la documentation requise comme cran-comments.md. Utilisez-la lorsque votre package R est prêt pour une publication sur le CRAN ou pour répondre aux retours des examinateurs.

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/submit-to-cran

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

Documentation

提交至 CRAN

執行完整 CRAN 提交流程，自起飛前檢查至提交。

適用時機

  • 套件已備好初次 CRAN 發布
  • 提交既有 CRAN 套件之更新版
  • 收 CRAN 審查者回饋後重新提交

輸入

  • 必要：通過本機 R CMD check 之 R 套件，0 錯誤、0 警告
  • 必要：DESCRIPTION 中之版本號已更新
  • 必要：NEWS.md 含此版本之變更
  • 選擇性：先前 CRAN 審查者意見（重新提交時）

步驟

步驟一：版本與 NEWS 檢查

驗 DESCRIPTION 含正確版本：

desc::desc_get_version()

驗 NEWS.md 有此版本之條目。條目應總結用戶可見之變更。

預期： 版本遵循語義化版本控制。NEWS.md 含此版本之對應條目。

失敗時： 用 usethis::use_version() 更版本（擇「major」、「minor」或「patch」）。為 NEWS.md 加總結用戶可見變更之條目。

步驟二：本機 R CMD Check

devtools::check()

預期： 0 錯誤、0 警告、0 註記（新提交可接受 1 註記：「New submission」）。

失敗時： 進行前修復所有錯誤與警告。閱讀 <pkg>.Rcheck/00check.log 之檢查日誌以了解詳情。註記應於 cran-comments.md 中說明。

步驟三：拼字檢查

devtools::spell_check()

將合理之詞加入 inst/WORDLIST（一行一詞、字母序排）。

預期： 無意外拼字錯。所有標出之詞已修正或加入 inst/WORDLIST。

失敗時： 修真正之拼字錯。對合理之技術術語，加入 inst/WORDLIST（一行一詞、字母序排）。

步驟四：URL 檢查

urlchecker::url_check()

預期： 所有 URL 回 HTTP 200。無損壞或重定向之連結。

失敗時： 替換損壞 URL。對 DOI 連結用 \doi{} 而非生 URL。移除已不存在之資源連結。

步驟五：Win-Builder 檢查

devtools::check_win_devel()
devtools::check_win_release()

待郵件結果（通常 15-30 分鐘）。

預期： Win-builder release 與 devel 上 0 錯誤、0 警告。結果於 15-30 分鐘內以郵件抵達。

失敗時： 處理平台特有問題。常見因：不同編譯器警告、缺系統依賴、路徑分隔符差異。本機修復並重提至 Win-builder。

步驟六：R-hub 檢查

rhub::rhub_check()

此於多平台檢查（Ubuntu、Windows、macOS）。

預期： 所有平台以 0 錯誤、0 警告通過。

失敗時： 若某平台失敗，檢 R-hub 建置日誌找平台特有錯。對平台依賴行為用 testthat::skip_on_os() 或條件碼。

步驟七：準備 cran-comments.md

於套件根建立或更新 cran-comments.md：

## R CMD check results
0 errors | 0 warnings | 1 note

* This is a new release.

## Test environments
* local: Windows 11, R 4.5.0
* win-builder: R-release, R-devel
* R-hub: ubuntu-latest (R-release), windows-latest (R-release), macos-latest (R-release)

## Downstream dependencies
There are currently no downstream dependencies for this package.

對更新，含：

  • 變更為何（簡述）
  • 對任何先前審查者回饋之回應
  • 反向依賴檢查結果（如適用）

預期： cran-comments.md 準確總結跨所有測試環境之檢查結果並說明任何註記。

失敗時： 若檢查結果於平台間差，記錄所有差異。CRAN 審查者將以其自身測試核驗此等聲明。

步驟八：最終起飛前

# One last check
devtools::check()

# Verify the built tarball
devtools::build()

預期： 最終 devtools::check() 乾淨通過。.tar.gz tarball 於父目錄建成。

失敗時： 若末刻問題現，修之並自步驟二重跑所有檢查。勿以已知失敗提交。

步驟九：提交

devtools::release()

此跑互動式檢查並提交。誠實答所有問題。

或於 https://cran.r-project.org/submit.html 手動上傳 tarball 提交。

預期： CRAN 之確認郵件數分鐘內抵。點確認連結以完成提交。

失敗時： 檢郵件以求拒因。常見問題：例執行過慢、缺 \value 標籤、不可移植之代碼。修問題並重提，於 cran-comments.md 中註明變更。

步驟十：提交後

接受後：

# Tag the release
usethis::use_github_release()

# Bump to development version
usethis::use_dev_version()

預期： GitHub 發布以接受版本之標籤建立。DESCRIPTION 升至開發版本（x.y.z.9000）。

失敗時： 若 GitHub 發布失敗，以 gh release create 手動建立。若 CRAN 接受延遲，待確認郵件再標籤。

驗證

  • 本機 R CMD check 回 0 錯誤、0 警告
  • Win-builder 通過（release + devel）
  • R-hub 於所有測試平台通過
  • cran-comments.md 準確描述檢查結果
  • 所有 URL 有效
  • 無拼字錯
  • 版本號正確且已遞增
  • NEWS.md 已更新
  • DESCRIPTION 元資料完整且正確

常見陷阱

  • 例執行過慢：將昂貴之例包入 \donttest{}。CRAN 強制時間限制。
  • 非標準檔／目錄名：避免會觸發 CRAN 註記之檔（檢 .Rbuildignore）
  • 文件缺 \value：所有匯出函式需 @return 標籤
  • vignette 建置失敗：確保 vignettes 於無你 .Renviron 之乾淨環境中建置
  • DESCRIPTION Title 格式：須為 Title Case、結尾無句點、無「A Package for...」
  • 遺忘反向依賴檢查：對更新，跑 revdepcheck::revdep_check()

範例

# Full pre-submission workflow
devtools::spell_check()
urlchecker::url_check()
devtools::check()
devtools::check_win_devel()
rhub::rhub_check()
# Wait for results...
devtools::release()

相關技能

  • release-package-version — 版本升級與 git 標籤
  • write-roxygen-docs — 確保文件符合 CRAN 標準
  • setup-github-actions-ci — 鏡像 CRAN 期望之 CI 檢查
  • build-pkgdown-site — 已接受套件之文件站

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/wenyan-lite/skills/submit-to-cran
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