Communitygithub.com

REA 変更履歴更新

固定された Git 履歴から REA リリースのチェンジログと GitHub リリースノートを作成・書き換え、検証済みの貢献者への謝辞と Release Please との同期を行います。

REA 変更履歴更新 とは?

このスキルは、REA プロジェクトのリリースノート作成とコントリビューター帰属を自動化します。固定された Git 履歴からコミット、PR、クローズされた Issue を収集し、検証済みの人間の貢献者のみをクレジットします。GitHub Actions やボットアカウントは除外します。 主な機能は、(1) `scripts/release-notes.mjs inventory` で貢献インベントリを生成し、(2) `record --summary` で要約プロven を生成、(3) そのデータに基づいてユーザー向けのチェンジログを書き、(4) Release Please の PR ボディを最終決定して同期することです。 このスキルは、**マージ、タグ付け、公開の承認は行いません**。代わりに、リリース PR が `rea:release-notes-finalized` ラベルで凍結されていることを確認し、検証済みのチェンジログをプッシュします。エラーが発生した場合、ネットワークエラー後にスクリプトを再実行でき、既存の出力ファイルを上書きしません。 Claude Code (API 使用時)、Cursor、および Codex で動作します(`.mjs` スクリプトが利用可能な場合)。依存関係は Node.js と `gh` CLI のみです。

対応✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/Prompt-Motion/ReaReverse/tree/HEAD/.agents/skills/rea-changelog-update

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

REA チェンジログ更新

リリースノート作成とコントリビューター帰属に使用します。公開の権限と既存のチェックポイントチェックについては、リポジトリルートの docs/releasing.md を参照してください。このスキルはノートを作成しますが、マージ、タグ付け、公開を承認するものではありません。

文章作成前の準備

完全な履歴とタグを取得します。リリース PR の ベースブランチ にある .release-please-manifest.json から公開済みベースラインタグを選択し、そのブランチの正確な SHA を編集ターゲットとして固定します。REA タグは rea-agents-VERSION です。提案されたバージョン(プレリリース接尾辞を含む)を使用し、always-bump-minor 戦略を変更して OpenClaw のカレンダーバージョンを模倣しないでください。

node scripts/release-notes.mjs inventory \
  --repository morluto/rea --base rea-agents-PREVIOUS \
  --target FULL_BASE_BRANCH_SHA --version VERSION \
  --manifest /tmp/rea-VERSION.contributions.json
node scripts/release-notes.mjs record \
  --manifest /tmp/rea-VERSION.contributions.json \
  --summary \
  --output /tmp/rea-VERSION.record.md

既存のボットドラフトだけでなく、インベントリを読んでください。インベントリには、サイドブランチのコミット、マージコミットが範囲内にある GitHub 関連 PR、コミット作成者/共著者、確認されたクローズ Issue とその報告者が含まれます。GitHub の接続はページネーションされます。ネットワークエラーは生成を停止し、回復後は新しい出力ファイルに再実行します。既存の出力ファイルは上書きされません。

未解決のコミット ID は user: null のまま名前/メールアドレスで保持されます。ハンドルを推測したり、マージャーを代わりに謝辞に含めたりしないでください。レポートは不明な情報を保持します。これはレビュー済みのメタデータスナップショットであり、人間がパッチを作成したという独立した証明ではありません。帰属不明の ID、特殊なマージ戦略、バックポート、リバート、GitHub が関連付けなかった参照については、ソース PR と差分を調査し、その制限を報告してください。現在のコレクターは、確認された PR クローズ関係を使用して Issue 報告者にクレジットします。関連のない Issue メンションは自動的にクレジットされません。単にインベントリに含まれる作業がリバート後も出荷されるとは主張しないでください。

ユーザー向けに書き、クレジットを保持する

CHANGELOG.md の最新の ## [VERSION] セクションのみを書き換え、そのバージョン/日付/リンクの見出しを保持します。以下の下で一行の Markdown リスト項目を使用します:

  • ### ハイライト: リリースを定義するいくつかのユーザー成果。小規模リリースのノルマはありません。
  • ### 変更点: 機能と意味のある動作変更。
  • ### 修正点: 信頼性、正確性、互換性、安全性の修正。
  • ### ⚠ 破壊的変更: 該当する場合は保持し、移行方法と、既存のチェックポイントバリデーターが必要とする元の PR/コミット参照を含めます。

関連する作業をアナリストのワークフローまたはユーザーへの影響でグループ化します。短く具体的なエントリで、結果の動作を説明します。ハイライトはリリースを要約し、その完全な説明を変更点で繰り返さないでください。内部クリーンアップ、テスト、CI、および日常的なドキュメントは、通常、プロベナンスファイルにのみ含めます。主張を行う前に、曖昧な PR/差分を読んでください。シミュレーションプロバイダーのチェックと実際のプロバイダーの検証を区別してください。

表現された各貢献を、公開ノートで一度だけ、そのリンクと検証済みの人間の作成者、既知の共著者、確認されたクローズ Issue 報告者の Thanks @... でクレジットします。グループ化により、これらすべてのクレジットを一行に保持します。ハイライト、詳細エントリ、または移行が同じ作業を参照する場合、その謝辞をそれらのエントリの1つにのみ配置し、すべてには配置しません。Issue リンクを含めます。直接コミットの箇条書きには、コミットリンクと既知の人間のクレジットを含めます。GitHub ボットと既知のエージェントアカウントは除外します。REA で観測された Anthropic、Cursor、Codex の共著者トレーラーは、@claude、@cursoragent、@codex に解決され、GitHub タイプは User です。クレジットポリシーでは、それらを除外しつつ、メタデータは保持します。REA メンテナーのリクエストにより、@morluto の自己謝辞は省略し、インベントリ内の著作者情報は保持します。他の人間の貢献者は引き続き対象となります。#NNN という曖昧な番号を避けるために、クロスリポジトリ参照には明示的な GitHub リンクを使用します。不明なハンドルは不明のままにし、偽造されたクレジットにしないでください。

生成された record --summary プロベナンスリンクを、このリリースの末尾にそのまま追加します。リンクされたインベントリは、検出された範囲内のすべての PR と直接貢献を説明し、散文から省略された内部作業も含みます。record の完全な出力を公開ノートに貼り付けないでください。謝辞が重複し、ユーザー向けの変更が不明瞭になります。完全なレコードはレビューのために利用可能なままです。検証を通過させるために、生成されたクレジットを手動で編集しないでください。プロダクト履歴が変更された場合はインベントリを更新し、散文のみの修正ではスナップショットを再利用できます。

Release Please で最終確定

ライブのリリース PR を変更する前に、その PR の更新の承認を得てください。ローカルの準備と検証は独立して進めることができます。

  1. 選択したオープンリリース PR に rea:release-notes-finalized を追加するのは、そのブランチ/本文を編集する前に行ってください。メイン提案のプッシュはこのラベルを尊重します。これはワークフローガードであり、Release Please の autorelease: snooze メカニズムではありません。すでに実行中の提案は、編集前に終了する必要があります。最終確定されたノートに対して手動での準備をディスパッチしないでください。

  2. そのリリースブランチ上で、レビュー済みのインベントリを docs/releases/VERSION.contributions.json として保存します。これは一時的な計画ファイルではなく、耐久性のある公開リリースプロベナンスです。認証情報やローカル環境のダンプを追加しないでください。既存のバージョンアーティファクトを合わせたままにしてください。

  3. 既存のチェックポイントバリデーターと新しいチェッカーを実行します:

    node scripts/release-notes.mjs check \
      --manifest docs/releases/VERSION.contributions.json
    node scripts/release-notes.mjs render \
      --manifest docs/releases/VERSION.contributions.json \
      --output /tmp/rea-VERSION.notes.md
    

    チェッカーは、インラインの PR 本文(その周囲のメタデータを含む)を、GitHub の 65,536 文字制限までサポートします。それを超えるノートでは、クレジットを切り詰める代わりに失敗します。Release Please のオーバーフローリンク本文は統合されていません。

  4. レンダリングされたセクションでリリース PR 本文を更新し、Release Please のヘッダー/フッターおよびコンポーネント/バージョン構造を保持します。body ファイルを gh pr edit --body-file で使用してください。CHANGELOG.md のみを変更しても、Release Please のリリース本文は変わりません。承認された変更のみをプッシュします。

  5. 新たに PR 本文をファイルにフェッチし、check --pr-body FILE を実行します。完全な差分を確認し、現在の CI を待ちます。公開時には、リリース作成前に本文が再度チェックされます。公開中はそれ以上の本文編集を避けてください。

最終確定ラベルはボットのリフレッシュを凍結しますが、メインは凍結しません。インベントリターゲット後の新たなプロダクト変更は、公開前にノートの更新を必要とします。ワークフローはターゲットの祖先をチェックし、そのターゲット以降はリリースメタデータパスのみを許可します。また、インベントリターゲットがレビューされたマージの最初の親と等しいことを要求するため、その間の main コミットは新しいインベントリを必要とします。許可されたリリースメタデータパス内の差分もレビューしてください。パスガードは、パッケージ依存関係/スクリプトの編集がバージョン専用の変更であることを証明しません。

自動提案を再開するには、最終確定ラベルを削除し、ボットに再生成させてください。編集による変更は置き換えられることが予想されます。

貢献インベントリのない既存のリリースは、現在の公開パスを維持します。リリース散文を修正するために、パッケージに再タグ付けしたり再公開したりしないでください。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル