GROK BOT TOOLS · SKILL
Release notes from commits, draft file onlyコミットからリリースノートを作成(下書きのみ)
Reads a repository commit range, groups changes and flags possible breaking changes. Writes one draft file and stops before tagging, committing or publishing.
リポジトリの指定したコミット範囲を読み、変更を分類し、互換性に影響する可能性がある変更を示します。下書きファイルを1つ作り、タグ作成・コミット・公開の前で止まります。
Where it goesどこに貼るか
Grok Build: save the file as .grok/skills/release-notes-from-commits/SKILL.md in the repository, or as ~/.grok/skills/release-notes-from-commits/SKILL.md for every project. It then shows up as the slash command /release-notes-from-commits.
Grok Build:リポジトリの .grok/skills/release-notes-from-commits/SKILL.md に保存します。すべてのプロジェクトで使うなら ~/.grok/skills/release-notes-from-commits/SKILL.md に。スラッシュコマンド /release-notes-from-commits として呼べるようになります。
First three moves最初の3手
- Fill the blanks and save the text as ./.grok/skills/release-notes-from-commits/SKILL.md in the repository.
- In Grok Build, invoke /release-notes-from-commits for a small range already present locally.
- Read the draft beside the commit range and review every breaking change flag before publishing anything.
- 空欄を埋め、リポジトリ内の ./.grok/skills/release-notes-from-commits/SKILL.md に保存します。
- Grok Build で /release-notes-from-commits を呼び出し、ローカルにある小さな範囲を対象にします。
- 下書きとコミット範囲を見比べ、公開前に互換性への影響があるとされた変更をすべて確認します。
Where it stops止まる条件
- Before tagging, committing, pushing, merging, deploying or any force operation.
- Before overwriting an existing draft file: it returns the proposed text for review.
- Before sending messages, publishing, purchasing, paying, deleting or changing production.
- When either reference cannot be read locally: it reports the missing range and stops.
- タグ作成、コミット、push、マージ、デプロイ、強制操作の前で止まります。
- 既存の下書きファイルを上書きする前で止まり、確認用の文面を返します。
- メッセージの送信、公開、購入、支払い、削除、本番環境の変更の前で止まります。
- いずれかの参照をローカルで読めない場合は、確認できない範囲を報告して止まります。
Blanks to fill埋める空欄
| Blank空欄 | What goes there入れるもの |
|---|---|
[REPOSITORY] | Local repository containing the commit history.コミット履歴があるローカルリポジトリです。 |
[FROM_REF] | Starting reference, excluded from the commit range.コミット範囲に含めない開始側の参照です。 |
[TO_REF] | Ending reference for the commit range.コミット範囲の終点となる参照です。 |
[DRAFT_FILE] | Path for a new draft file inside the repository.リポジトリ内に新しく作る下書きファイルのパスです。 |
[AUDIENCE] | Readers and the level of technical detail they need.想定する読み手と、必要な技術的説明の詳しさです。 |
Replace every bracket. Leave none behind.
角かっこはすべて置き換え、残さないでください。
The text文面
Download SKILL.mdSKILL.md で持ち帰る Fork itフォークする Results & questions結果・質問を書く
--- name: release-notes-from-commits description: Draft release notes from a local commit range with grouped changes and breaking change flags. Use when asked to summarize commits for a release without tagging or publishing. when-to-use: draft release notes, summarize this release, write notes from commits metadata: author: BotShelf Vampire (unofficial, not xAI) short-description: Commit evidence turned into a draft file license: MIT --- # Release notes from commits, draft file only ## When to use Use this when I ask for release notes from an explicit commit range. Produce a reviewable draft for the stated readers. Do not infer that these changes are already released. ## Inputs and access - Local repository: [REPOSITORY]. - Commit range: [FROM_REF]..[TO_REF]. - New draft file: [DRAFT_FILE]. - Intended readers: [AUDIENCE]. Read local history, diffs and repository guidance. The only allowed write is the new draft file. ## Steps 1. Resolve both references locally and record their revisions. List the commits in the range. If the range is empty, report that and stop without creating a file. 2. Read commit messages and relevant diffs. Trace each proposed note to a commit and changed behavior; a message alone may be incomplete. 3. Group notes under Added, Changed, Fixed and Removed. Omit empty groups. Combine related commits without losing their references. 4. Flag changes to public interfaces, configuration, required inputs or stored data that may break existing use. Separate supported breaking changes from questions needing an owner decision. 5. Describe effects in language suited to the intended readers. Do not invent release dates, version numbers, adoption claims or migration instructions absent from the sources. 6. Check the destination. If it already exists, return proposed text without overwriting it. Otherwise write the draft, including its range, evidence and open questions. ## Check the result Make sure each note has a supporting commit. Account for reversions and follow-up changes before describing the final effect. Check that unrelated history is excluded and that uncertainties remain visible. Inspect the draft for secrets before returning it. ## What to return Return the draft location, resolved range, change groups, breaking change flags and unanswered questions. State which commits could not be interpreted. Keep review questions distinct from the release prose. ## Needs my approval Stop before overwriting files, tagging, committing, pushing, merging, deploying or force operations. Also stop before sending messages, publishing, purchasing, paying, deleting or changing production. Do not create a release. ## If data is missing or stale If either reference is unavailable, report the missing input without fetching it. If references move during work, identify the old revisions and leave the draft pending review. Do not fill missing history from memory.
License: MIT. Free, no sign-up. Use is at your own risk. BSV does not run it or set it up for you.
ライセンス:MIT。無料・登録不要。利用は自己責任です。BSVが代わりに実行・セットアップすることはありません。
What it adds to the official page公式ページに足しているもの
The official page describes the Grok Build skill format. This text adds rules for selecting commit evidence, grouping release changes and handling an existing draft file without overwriting it.
公式ページは Grok Build のスキル形式を説明しています。この文面は、コミットから根拠を選ぶ決まり、リリースの変更を分類する手順、既存の下書きを上書きせずに扱う方法を足しています。
Sources出どころ
The product facts in this text come from these official pages, read on 2026-11-18. Products change: when a page and this text disagree, the page is right.
この文面の製品に関する記述は、次の公式ページ(2026-11-18 に確認)に基づいています。製品は変わります。公式ページとこの文面が食い違うときは、公式ページが正です。
All Grok Bot toolsGrok Bot の道具の一覧 Download all (ZIP)まとめてダウンロード(ZIP) Search the shelf棚を検索