release-debrief

リリースノートのキャッチアップ

ユーザーがこのスキルを最後に実行してから、サポート対象のツールで何が変わったかを要約します。ウォークスルーや演習はありません。変更点に絞った概要です。

サポート対象のツール

各ツールには、resources/tools/<tool>.md にプロファイル（ソース URL、カテゴリ、注意点）があり、resources/outputs/<tool>.md に出力ファイル（最後に確認したバージョンと要約の履歴）があります。両方のパスは、ユーザーの現在の作業ディレクトリではなく、この SKILL.md を基準に解決してください。

ツール	ユーザーが入力する可能性のある別名	プロファイル	出力
Claude Code	claude-code, claudecode, cc	resources/tools/claude-code.md	resources/outputs/claude-code.md
OpenCode	opencode, open-code	resources/tools/opencode.md	resources/outputs/opencode.md
llama-swap	llama-swap, llamaswap	resources/tools/llama-swap.md	resources/outputs/llama-swap.md
llama.cpp	llama-cpp, llama.cpp, llamacpp	resources/tools/llama-cpp.md	resources/outputs/llama-cpp.md

ツールの選択：ユーザーのプロンプトから、上記の別名に一致するツールを特定してください。テーブルにない名前が指定された場合は、サポート対象の一覧を返して終了してください。

フロー

1. ツールプロファイルを読み込みます。 resources/tools/<tool>.md を読み込みます。変更履歴の取得先、バージョン体系の仕組み、どのカテゴリに分類するか、何を除外するか、注意すべき点が記載されています。そのツールについては、プロファイルを正式な基準として扱ってください。

2. 状態を読み込みます。 ツールの出力ファイルを読み込みます。フロントマターから last_seen_version を解析します。ファイルが存在しない、空である、またはフロントマターにバージョンがない場合は初回実行として扱い、プロファイルのバージョン体系に従って直近3件のリリースを要約します。確認は求めません。

3. 現在の変更履歴を取得します。 プロファイルの主要ソースに対して、WebFetch または ctx_fetch_and_index を使用します。項目の文脈が必要な場合（設定スキーマの比較、API ドキュメントへのリンク、概要を補足する編集情報）に限り、補足ソースを取得します。プロファイルに条件付きソースが記載されている場合は、差分を確認してから各条件に該当するか判定し、該当するソースを取得します。これらにはそれぞれ独自のカテゴリがあります。

4. 差分を特定します。 保存されているバージョンより新しく、最新リリースまでの項目を残します。プロファイルに記載の方式でバージョンを比較します。

   • semver - major.minor.patch を解析し、各コンポーネントを数値で比較します。
   • build-number - 接頭辞（b、v）を取り除き、整数として比較します。
   • github-release-tag - GitHub のリリース順（時系列）を使用します。

   バージョンタグを辞書順の文字列として比較してはいけません。

5. 要約します。 項目をプロファイルのカテゴリごとにまとめます。各項目について、以下を記載します。

   • 機能や変更の内容を1行で記載します。
   • 重要な理由、または利用する場面を1行で記載します。
   • 機能が重要なものであれば、ドキュメントへのリンクを記載します（プロファイルの機能リンク表、またはリリースページ自体）。

   プロファイルの対象外リストに従って、情報価値の低い項目を除外します。解析、分類、注意喚起の判断には、プロファイルの注意事項を適用します。簡潔で直接的な文体を保ちます。実験的な変更、破壊的変更、スキーマに影響する変更は目立つように示します。

6. 状態を保存します。 Edit（出力ファイルがまだ存在しない場合は Write）を使用して、ツールの出力ファイルを更新します。

   • 取得した変更履歴の最新バージョン（要約の対象範囲にかかわらず、単一の最新バージョン）をフロントマターの last_seen_version に設定します。
   • last_updated を今日の日付（ISO 形式）に設定します。
   • # <Tool> Changelog Summaries の下に、今回提示したカテゴリ別要約を含む ## <version> (<date>) セクションを追加します。1回の実行で複数のバージョンを対象とする場合は、範囲見出し ## <oldest> → <newest> (<date>) を使用します。
   • ## セクションは新しいものから2つだけ残します。新しいセクションを追加して3つ以上になる場合は、最も古いセクションを削除し、2つだけ残します。

   1行で確認します。Updated resources/outputs/<tool>.md to <version>. 実行に失敗した場合、または要約を提示する前にユーザーが中止した場合は、ファイルを変更しません。

7. ファイルのフルパスを出力します。 書き込みが成功した後に、次のように出力します。「Debrief saved to: /absolute/path/to/resources/outputs/.md 」

保存ファイルの形式

各出力ファイルは次の形式です。

---
last_seen_version: 2.1.112
last_updated: 2026-04-17
---

# <Tool> Changelog Summaries

## <version> (<date>)

### <Bucket>
- ...

## <prior version> (<prior date>)

### <Bucket>
- ...

見出しの <version> には単一のバージョン（2.1.112）または、1回の実行で複数のバージョンを対象とした場合は範囲（2.1.109 → 2.1.112）を指定できます。フロントマターの last_seen_version には常に単一の最新バージョンを設定します。## セクションは最大2つで、新しいものを先頭に置き、その直下に前回の実行分を置きます。新しいセクションを追加する際は、最も古いセクションを削除します。

適用範囲の指定

• 明示的なバージョン（「2.1.90 以降の新機能」など）：last_seen_version の代わりに、ユーザーが指定したバージョンを使用します。ユーザーが保存しないよう指定していない限り、状態は引き続き保存します。
• 日付範囲（「直近2週間のすべて」など）：バージョンではなく変更履歴の日付を使用します。状態は引き続き保存します。
• 領域フィルター（「フックだけ」など）：差分をその領域に絞り込みますが、状態は引き続き保存します。新しいセクションの見出しにフィルターを記載します。## <version> (<date>, hooks only)。
• 保存しない指定（「状態を更新しないで」など）：手順6を省略し、状態が保存されなかったことをユーザーに伝えます。

よくある注意点

• resources/tools/<tool>.md と resources/outputs/<tool>.md は、この SKILL.md を基準とした相対パスで解決してください。ユーザーは任意の作業ディレクトリからスキルを実行します。
• バージョンの解析方法はツールごとに異なります。比較する前に、必ずプロファイルの バージョン方式 セクションを読んでください。セマンティックバージョニングを前提にしないでください。
• 保存されているバージョンが取得した変更履歴のどのバージョンよりも新しい場合（ユーザーが手動でバージョンを上げた場合や、ソースがまだ更新されていない場合）は、その旨を明確に伝え、差分を捏造しないでください。
• Edit を使って新しいセクションを先頭に追加し、最も古いセクションを削除して、2つだけ残してください。ファイルがまだ存在しない場合に限り、Write を使ってください。
• 1つの出力ファイルに複数のツールを混在させないでください。各ツールには専用の出力ファイルがあります。
• 初回実行時のヒューリスティック（直近3件のリリース）は、実行ごとではなくツールごとに適用されます。ユーザーが昨日 Claude Code でスキルを実行し、今日 OpenCode について尋ねた場合、OpenCode はまだ初回実行です。