MCP HubMCP Hub
← Retour aux compétences

release-package-version

pjt222
Mis à jour 2 days ago
8 vues
17
2
17
Voir sur GitHub
Métageneral

À propos

Cette compétence automatise le cycle complet de publication des packages R, en gérant les mises à jour de version, les mises à jour du NEWS.md, le marquage git et les publications sur GitHub. Elle est conçue pour être utilisée lorsqu'un package est prêt pour une publication de correctif, mineure ou majeure, ou après l'acceptation sur CRAN pour créer une publication GitHub correspondante. Le processus inclut également la configuration d'un incrément de version de développement post-publication.

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/release-package-version

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

Documentation

Release Package Version

Execute full version release cycle for R package.

When Use

  • Ready to release new version (bug fix, feature, or breaking change)
  • After CRAN acceptance, create matching GitHub release
  • Set up post-release dev version

Inputs

  • Required: Package with changes ready for release
  • Required: Release type: patch (0.1.0 -> 0.1.1), minor (0.1.0 -> 0.2.0), or major (0.1.0 -> 1.0.0)
  • Optional: Whether to submit to CRAN (default: no, use submit-to-cran skill separately)

Steps

Step 1: Determine Version Bump

Follow semantic versioning:

Change TypeVersion BumpExample
Bug fixes onlyPatch0.1.0 -> 0.1.1
New features (backward compatible)Minor0.1.0 -> 0.2.0
Breaking changesMajor0.1.0 -> 1.0.0

Got: Correct bump type (patch, minor, or major) determined based on nature of changes since last release.

If fail: Unsure? Review git log since last tag and classify each change. Any breaking API change needs major bump.

Step 2: Update Version

usethis::use_version("minor")  # or "patch" or "major"

This updates Version field in DESCRIPTION and adds heading to NEWS.md.

Got: DESCRIPTION version updated. NEWS.md has new section header for release version.

If fail: usethis::use_version() not available? Manually update Version field in DESCRIPTION. Add # packagename x.y.z heading to NEWS.md.

Step 3: Update NEWS.md

Fill in release notes under new version heading:

# packagename 0.2.0

## New Features
- Added `new_function()` for processing data (#42)
- Support for custom themes in `plot_results()` (#45)

## Bug Fixes
- Fixed crash when input contains all NAs (#38)
- Corrected off-by-one error in `window_calc()` (#41)

## Minor Improvements
- Improved error messages for invalid input types
- Updated documentation examples

Use issue/PR numbers for traceability.

Got: NEWS.md has complete summary of user-facing changes organized by category. Issue/PR numbers for traceability.

If fail: Changes hard to reconstruct? Use git log --oneline v<previous>..HEAD to list all commits since last release. Categorize them.

Step 4: Final Checks

devtools::check()
devtools::spell_check()
urlchecker::url_check()

Got: devtools::check() returns 0 errors, 0 warnings, 0 notes. Spell check and URL check find no issues.

If fail: Fix all errors and warnings before release. Add false-positive words to inst/WORDLIST for spell checker. Replace broken URLs.

Step 5: Commit Release

git add DESCRIPTION NEWS.md
git commit -m "Release packagename v0.2.0"

Got: Single commit containing version bump in DESCRIPTION and updated NEWS.md.

If fail: Other uncommitted changes present? Stage only DESCRIPTION and NEWS.md. Release commits should contain only version-related changes.

Step 6: Tag the Release

git tag -a v0.2.0 -m "Release v0.2.0"
git push origin main --tags

Got: Annotated tag v0.2.0 created and pushed to remote. git tag -l shows tag locally; git ls-remote --tags origin confirms it on remote.

If fail: Push fails? Check write access. Tag already exists? Verify it points to correct commit with git show v0.2.0.

Step 7: Create GitHub Release

gh release create v0.2.0 \
  --title "packagename v0.2.0" \
  --notes-file NEWS.md

Or use:

usethis::use_github_release()

Got: GitHub release created. Release notes visible on repository Releases page.

If fail: gh release create fails? Ensure gh CLI authenticated (gh auth status). usethis::use_github_release() fails? Create release manually on GitHub.

Step 8: Set Development Version

After release, bump to dev version:

usethis::use_dev_version()

Changes version to 0.2.0.9000 indicating development.

git add DESCRIPTION NEWS.md
git commit -m "Begin development for next version"
git push

Got: DESCRIPTION version now 0.2.0.9000 (dev version). NEWS.md has new heading for dev version. Changes pushed to remote.

If fail: usethis::use_dev_version() not available? Manually change version to x.y.z.9000 in DESCRIPTION. Add # packagename (development version) heading to NEWS.md.

Checks

  • Version in DESCRIPTION matches intended release
  • NEWS.md has complete, accurate release notes
  • R CMD check passes
  • Git tag matches version (e.g., v0.2.0)
  • GitHub release exists with release notes
  • Post-release dev version set (x.y.z.9000)

Pitfalls

  • Forget push tags: git push alone no push tags. Use --tags or git push origin v0.2.0
  • NEWS.md format: Use markdown headers matching pkgdown/CRAN expected format
  • Tag wrong commit: Always tag after version-bump commit, not before
  • CRAN version already exists: CRAN no accept version already published. Always increment.
  • Dev version in release: Never submit .9000 version to CRAN

See Also

  • submit-to-cran - CRAN submission after version release
  • create-github-release - general GitHub release creation
  • setup-github-actions-ci - triggers pkgdown rebuild on release
  • build-pkgdown-site - documentation site reflects new version

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/caveman/skills/release-package-version
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