release-package-version
À 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, l'étiquetage git et la création de versions sur GitHub. Elle est utilisée lors de la préparation de nouvelles versions correctives, mineures ou majeures, après l'approbation du CRAN, ou pour configurer la prochaine version de développement. L'outil gère l'ensemble du flux de travail, depuis l'incrémentation de la version jusqu'à la configuration post-publication.
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/release-package-versionCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
name: release-package-version description: > RパッケージのリリースサイクルをすべてとおしてI実行する。バージョンバンプ、 NEWS.mdの更新、gitタグ付け、GitHubリリースの作成、リリース後の開発バージョン設定を含む。 パッケージが新しいパッチ、マイナー、またはメジャーリリースの準備完了時、 CRANへの承認後に対応するGitHubリリースを作成する時、またはリリース直後に 開発バージョンバンプを設定する時に使用する。 locale: ja source_locale: en source_commit: 6f65f316 translator: claude-opus-4-6 translation_date: 2026-03-16 license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: r-packages complexity: intermediate language: R tags: r, versioning, release, git-tags, changelog
パッケージバージョンのリリース
Rパッケージの完全なバージョンリリースサイクルを実行する。
使用タイミング
- 新しいバージョンをリリースする準備ができた時(バグ修正、機能追加、または破壊的変更)
- CRANへの承認後に対応するGitHubリリースを作成する時
- リリース後の開発バージョンを設定する時
入力
- 必須: リリース準備が完了した変更を持つパッケージ
- 必須: リリースタイプ:patch(0.1.0 -> 0.1.1)、minor(0.1.0 -> 0.2.0)、またはmajor(0.1.0 -> 1.0.0)
- 任意: CRANに投稿するかどうか(デフォルト:いいえ、別途
submit-to-cranスキルを使用)
手順
ステップ1: バージョンバンプの決定
セマンティックバージョニングに従う:
| 変更タイプ | バージョンバンプ | 例 |
|---|---|---|
| バグ修正のみ | Patch | 0.1.0 -> 0.1.1 |
| 新機能(後方互換) | Minor | 0.1.0 -> 0.2.0 |
| 破壊的変更 | Major | 0.1.0 -> 1.0.0 |
期待結果: 最後のリリース以降の変更の性質に基づいて正しいバンプタイプ(patch、minor、またはmajor)が決定される。
失敗時: 不明な場合は最後のタグ以降のgit logを確認して各変更を分類する。API破壊的変更はメジャーバンプが必要。
ステップ2: バージョンの更新
usethis::use_version("minor") # または"patch"または"major"
これによりDESCRIPTIONのVersionフィールドが更新され、NEWS.mdに見出しが追加される。
期待結果: DESCRIPTIONのバージョンが更新される。NEWS.mdにリリースバージョンの新しいセクション見出しが追加される。
失敗時: usethis::use_version()が利用できない場合、DESCRIPTIONのVersionフィールドを手動で更新し、NEWS.mdに# packagename x.y.z見出しを追加する。
ステップ3: NEWS.mdの更新
新しいバージョン見出しの下にリリースノートを記入する:
# 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
トレーサビリティのためにイシュー/PR番号を使用する。
期待結果: NEWS.mdにカテゴリ別に整理されたユーザー向けの変更の完全なまとめが含まれ、トレーサビリティのためにイシュー/PR番号が付いている。
失敗時: 変更の再構築が困難な場合はgit log --oneline v<previous>..HEADを使用して最後のリリース以降のすべてのコミットをリストアップして分類する。
ステップ4: 最終チェック
devtools::check()
devtools::spell_check()
urlchecker::url_check()
期待結果: devtools::check()が0エラー、0警告、0ノートを返す。スペルチェックとURLチェックで問題が見つからない。
失敗時: リリース前にすべてのエラーと警告を修正する。スペルチェッカーの誤検知にはinst/WORDLISTに単語を追加する。壊れたURLを置き換える。
ステップ5: リリースのコミット
git add DESCRIPTION NEWS.md
git commit -m "Release packagename v0.2.0"
期待結果: DESCRIPTIONのバージョンバンプと更新されたNEWS.mdを含む単一のコミット。
失敗時: 他のコミットされていない変更が存在する場合は、DESCRIPTIONとNEWS.mdのみをステージングする。リリースコミットにはバージョン関連の変更のみを含めること。
ステップ6: リリースのタグ付け
git tag -a v0.2.0 -m "Release v0.2.0"
git push origin main --tags
期待結果: アノテーション付きタグv0.2.0が作成されてリモートにプッシュされる。git tag -lでローカルにタグが表示され、git ls-remote --tags originでリモートに確認できる。
失敗時: プッシュが失敗する場合は書き込みアクセスがあることを確認する。タグが既に存在する場合はgit show v0.2.0で正しいコミットを指しているか確認する。
ステップ7: GitHubリリースの作成
gh release create v0.2.0 \
--title "packagename v0.2.0" \
--notes-file NEWS.md
または以下を使用する:
usethis::use_github_release()
期待結果: リポジトリのReleasesページにリリースノートが表示されたGitHubリリースが作成される。
失敗時: gh release createが失敗する場合はgh auth statusでghCLIが認証されているか確認する。usethis::use_github_release()が失敗する場合はGitHubで手動でリリースを作成する。
ステップ8: 開発バージョンの設定
リリース後、開発バージョンにバンプする:
usethis::use_dev_version()
これにより開発中を示す0.2.0.9000にバージョンが変更される。
git add DESCRIPTION NEWS.md
git commit -m "Begin development for next version"
git push
期待結果: DESCRIPTIONのバージョンが0.2.0.9000(開発バージョン)になる。NEWS.mdに開発バージョンの新しい見出しが追加される。変更がリモートにプッシュされる。
失敗時: usethis::use_dev_version()が利用できない場合、DESCRIPTIONのバージョンを手動でx.y.z.9000に変更し、NEWS.mdに# packagename (development version)見出しを追加する。
バリデーション
- DESCRIPTIONのバージョンが意図したリリースと一致する
- NEWS.mdに完全で正確なリリースノートがある
-
R CMD checkがパスする - gitタグがバージョンと一致する(例:
v0.2.0) - GitHubリリースがリリースノートとともに存在する
- リリース後の開発バージョンが設定されている(x.y.z.9000)
よくある落とし穴
- タグのプッシュ忘れ:
git pushだけではタグはプッシュされない。--tagsを使用するかgit push origin v0.2.0を使用する - NEWS.md形式: pkgdown/CRANが期待するMarkdown見出し形式を使用する
- 間違ったコミットへのタグ付け: 常にバージョンバンプコミットの後にタグを付ける
- CRANに既に存在するバージョン: CRANは既に公開されているバージョンを受け付けない。常にインクリメントする
- リリースに開発バージョンを含める: CRANに
.9000バージョンを決して投稿しないこと
関連スキル
submit-to-cran- バージョンリリース後のCRAN投稿create-github-release- 一般的なGitHubリリースの作成setup-github-actions-ci- リリース時にpkgdownの再ビルドをトリガーするbuild-pkgdown-site- ドキュメントサイトが新しいバージョンを反映する
Dépôt GitHub
Compétences associées
llamaguard
AutreLlamaGuard est le modèle de Meta, doté de 7 à 8 milliards de paramètres, conçu pour modérer les entrées et sorties des LLM selon six catégories de sécurité comme la violence et les discours haineux. Il offre une précision de 94 à 95 % et peut être déployé avec vLLM, Hugging Face ou Amazon SageMaker. Utilisez cette compétence pour intégrer facilement le filtrage de contenu et des garde-fous de sécurité dans vos applications d'IA.
cost-optimization
AutreCette compétence de Claude aide les développeurs à optimiser les coûts du cloud grâce au redimensionnement des ressources, aux stratégies d'étiquetage et à l'analyse des dépenses. Elle fournit un cadre pour réduire les dépenses cloud et mettre en œuvre une gouvernance des coûts sur AWS, Azure et GCP. Utilisez-la lorsque vous devez analyser les coûts d'infrastructure, redimensionner les ressources ou respecter des contraintes budgétaires.
quantizing-models-bitsandbytes
AutreCette compétence quantifie les LLMs en précision 8 bits ou 4 bits à l'aide de bitsandbytes, permettant une réduction de 50 à 75 % de la mémoire utilisée avec une perte de précision minime. Elle est idéale pour exécuter des modèles plus volumineux sur une mémoire GPU limitée ou pour accélérer l'inférence, prenant en charge des formats comme INT8, NF4 et FP4. La compétence s'intègre à HuggingFace Transformers et permet l'entraînement QLoRA ainsi que l'utilisation d'optimiseurs en 8 bits.
dispatching-parallel-agents
AutreCette compétence Claude déploie plusieurs agents pour enquêter et résoudre simultanément 3 problèmes indépendants ou plus. Elle est conçue pour des scénarios impliquant des défaillances non liées qui peuvent être résolues sans état partagé ni dépendances. La capacité fondamentale est la résolution de problèmes en parallèle, en assignant un agent par domaine problématique indépendant afin de maximiser l'efficacité.
