القائمة
main との差分と要件ドキュメントを参考に、次バージョン用の README と CHANGELOG を更新する
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | update-release-docs |
| description | main との差分と要件ドキュメントを参考に、次バージョン用の README と CHANGELOG を更新する |
| allowed-tools | Read, Edit, Bash(cd:*), Bash(git log:*), Bash(git diff:*), Bash(git status:*), Bash(git add:*), Bash(git commit:*) |
| argument-hint | <要件ドキュメントのパス> [バージョン] |
main ブランチとの差分と指定された要件ドキュメントを参照し、
次バージョン用の CHANGELOG.md と README.md を更新します。
~/work/ai/git-keizucd ~/work/ai/git-keizu を実行することスペース区切りで最大2トークンを受け取る。
| 位置 | 必須 | 説明 |
|---|---|---|
| 第1引数 | 必須 | 要件ドキュメントのパス（リポジトリルートからの相対パスまたは絶対パス） |
| 第2引数 | 省略可 | バージョン番号（例: 0.2.7 または v0.2.7、v-prefix は任意） |
# バージョンを明示する場合
/update-release-docs notes/features/007-foo/要件整理.md 0.2.7
# バージョンを省略する場合（package.json から自動取得）
/update-release-docs notes/features/007-foo/要件整理.md
引数が指定されていない場合は、要件ドキュメントのパスをユーザーに確認してから進めること。
コミットメッセージを生成する前に、以下を必ず実行すること。
docs/development/project-settings.md を Read ツールで読む
commit-language: en があれば英語、commit-language: ja または記述なしなら日本語を使用CLAUDE.md を Read ツールで読む
commit-language: を探す言語の優先順位: docs/development/project-settings.md > CLAUDE.md > グローバルデフォルト（日本語）
cd ~/work/ai/git-keizu
以下を並列で Read/Bash 実行し、内容を把握する:
$ARGUMENTS で指定されたファイルを Read ツールで読むgit log main..HEAD --oneline
git diff main...HEAD
git diff main...HEAD --stat で概要を先に把握し、
必要なファイルだけ個別に Read で確認するCHANGELOG.md を Read ツールで読むREADME.md を Read ツールで読む# Read ツールで package.json を読み "version" フィールドを取得
v prefix は除去して正規化。例: v0.2.7 → 0.2.7）package.json の "version" フィールドを Read ツールで読んで使用する決定したバージョンが CHANGELOG に既存エントリとして存在する場合は処理を中断し、以下の形式でユーザーに確認する：
⚠️ CHANGELOG に [X.Y.Z] エントリが既に存在します。
- 別のバージョン番号を指定して再実行するか
- 既存エントリを上書きしても良い場合は「続行」と入力してください
ユーザーが「続行」または続行の意思を示した場合のみ、既存エントリを上書きして処理を進める。
## [Unreleased] セクションの直後に新バージョンのセクションを挿入する。
docs/development/project-settings.md の commit-language: en に準拠）Added / Changed / Fixed / Removed のうち該当するもの- **機能名**: 説明文 の形式。何を・どう変えたかを1文で明確に書くファイル末尾のリンク定義を更新する:
[Unreleased]: https://github.com/numlia/git-keizu/compare/v{新バージョン}...HEAD
[{新バージョン}]: https://github.com/numlia/git-keizu/compare/v{前バージョン}...v{新バージョン}
前バージョンは既存の CHANGELOG エントリから読み取ること。
## Features セクションのリストを更新する。
- **機能名**: 説明文 の箇条書き## Security セクション（機能変更でない限り手をつけない）## Installation / ## Contributing & Support / ## License セクションCHANGELOG.md と README.md をまとめて1コミットとして記録する。
docs: {説明} の prefix を使うdocs: update CHANGELOG and README for v{version}docs: v{バージョン}の CHANGELOG と README を更新(#issue-number) を含めない# Step 6-1: ステータス確認
git status
# Step 6-2: 対象ファイルをステージング（別々の Bash tool call で実行）
git add CHANGELOG.md README.md
# Step 6-3: コミット（HEREDOC 形式）
git commit -m "$(cat <<'EOF'
docs: {決定したメッセージ}
EOF
)"
更新後、以下の形式でレポートを出力する:
## 📊 Report
**Overview**: [バージョン X.Y.Z の CHANGELOG と README を更新・コミットした旨]
**Changed files**: 2 files
- `CHANGELOG.md`
- `README.md`
**CHANGELOG の主な変更**:
- Added: N 項目
- Changed: N 項目
**README の主な変更**:
- [追加・変更した bullet の概要]
**Next step**: /release X.Y.Z を実行してください
/commit は不要## [Unreleased] は空のまま: 新バージョンのセクションはその下に追加する