| name | marketing-release-handoff |
| description | KIOKU の release (v0.X.Y tag publish) 後に、PM → マーケ担当への引き継ぎ資料を `tools/claude-brain/marketing/handoff/YYMMDDNN_v{VERSION}-release-summary.md` (NN = 同日 N 件目の連番) として自動生成する。Changelog + release PRs から user-facing 変化だけを抽出し、バグ fix / 内部 refactor / LEARN 組織知は除外。記事ネタ候補 3 本 + 想定読者 + 既存 article 資産 pointer 付き。`/marketing-release-handoff v0.7.0` のように version 引数で起動、省略時は kioku 最新 tag を自動検出。 |
marketing-release-handoff
KIOKU の release 直後に PM session (本 skill 起動者) がマーケ部に投げる引き継ぎ資料 を構造化して生成する skill。バグ fix や内部改善は除外し、user が touch できる価値 + 訴求角度 + 記事ネタ のみに絞った markdown を tools/claude-brain/marketing/handoff/ に保存する。
いつ使うか
- KIOKU の release (v0.X.Y tag) を publish した直後
- マーケ部に「何が出たか / 何を訴求できるか」を PM side から説明したい時
- 記事ネタ候補 (dev.to / Qiita / Zenn) を構造化して引き渡したい時
使わない場面:
- Patch release (v0.X.Y hotfix) で user-facing な変化が無い時 → 手動で省略判断
- マーケ担当が自力で Changelog 解読する運用に戻したい時 → 本 skill は PM→マーケ の橋渡し用
前提
- release 作業 (tag + .mcpb + GitHub Release + README Changelog 10 言語) が既に完了していること
tools/claude-brain/app/README.md の Changelog に 対象 version の entry が存在すること- 参照正典:
tools/claude-brain/marketing/handoff/kioku-marketing-handover.md (マーケ運用鉄則)、.claude/rules/marketing.md (マーケ関連 file 配置ルール)
起動
/marketing-release-handoff v0.7.0
引数省略時 (/marketing-release-handoff) は kioku 最新 tag を gh api repos/megaphone-tokyo/kioku/tags で自動検出。
実行手順 (skill 本体の処理)
Step 1: Release info 収集
-
VERSION を確定: slash command 引数 (例: /marketing-release-handoff v0.7.0 の v0.7.0) が与えられていればそれを使う。省略時は latest tag を Bash で取得:
gh api 'repos/megaphone-tokyo/kioku/tags?per_page=1' --jq '.[0].name'
※ この snippet 内の $1 / ${1:-...} を slash command 引数と混同しないこと。skill は引数を prompt 文脈で受け取り、shell 位置引数は空。<VERSION> は以降 v0.7.0 等の確定値に置換して使う。
-
tag 情報と published 日を取得:
gh release view "<VERSION>" --repo megaphone-tokyo/kioku --json tagName,publishedAt,assets
-
handoff filename の日付 + NN 連番を決定: publishedAt を YYMMDD 形式に変換 (例: 2026-04-24 → 260424)、NN は既存 handoff の同日件数 +1 を ls tools/claude-brain/marketing/handoff/ | grep "^<YYMMDD>" で数えて決定 (該当無しなら 01)。
Step 2: Changelog 該当 entry 抽出 (LEARN#10 準拠)
-
必ず 以下 grep で heading 実在を verify (LEARN#10 精読必須):
grep -n "^### .*— <VERSION>:" tools/claude-brain/app/README.md
hit 無し → 即 abort。推測ベースで handoff 本文を書かず、user に以下を報告:
Changelog entry 未作成の可能性。release cascade (parent PR → sync-to-app → kioku README PR → kioku main merge → post-release-sync) が完了していない疑い。LEARN#11 の 4 step を確認してください。
-
hit あり → 該当行から次の ### 見出しまでを範囲として抽出する。README.md が master、10 言語 i18n parity は前提 (抽出は EN master から)。
Step 3: User-facing filter
抽出した Changelog から以下を 除外:
- "bug fix" / "hotfix" / "regression" / "silent" を含む行
- "internal" / "refactor" / "test" で始まる行
- "LEARN#" で始まる行 (組織知、マーケ外)
- "version bump" / "parity" / "i18n fix" 等の裏方 item
残すもの = user が install / setup / 日常使用で体感する変化。
Step 4: Before / After 再構成
各 feature について以下の 3 点セットで書く:
- Before: v0.(X-1).Y の状態、user が何に困っていたか
- After: v0.X.Y で user が何ができるようになったか (必要ならコード例)
- なぜ重要: マーケ的 narrative (target persona、差別化 angle)
Step 5: 記事ネタ候補 3 本提案
release の key feature から 3 つの article angle を生成:
- 各 angle に 想定読者 (persona) を明示
- 対象媒体 (dev.to 英語 / Qiita 日本語技術 / Zenn 日本語広め) を提案
- 既存 article
tools/claude-brain/marketing/article/<媒体>/YYMMDD_kioku-v0.(X-1)-<媒体>.md のフォーマットを踏襲する旨を明記
Step 6: Save
tools/claude-brain/marketing/handoff/{YYMMDDNN}_v{VERSION}-release-summary.md として save。
- YYMMDD は release 日 (tag publishedAt 由来)
- NN は同日 N 件目 handoff の連番 (既存 handoff file を ls して決定)
- frontmatter に PM 属性 + from/to/created/purpose/status/related を入れる
related field の埋め方 (出力 template の plan/claude/XXXXX は placeholder、必ず解決 or 削除):
handoff/post-release-{VERSION}.md: 存在すれば記載、無ければ omitplan/claude/<YYMMDDNN>_*: Changelog entry 中に plan/claude 参照があればそれを採用。無ければ plan/claude/ 配下で該当 Phase を ls -la | grep -i <feature-keyword> で 1 候補に絞って記載。確信が持てなければ omit して PM に照会 (推測で埋めない、LEARN#10 準拠)README.md Changelog §{YYYY-MM-DD}: 必須
Step 7: 報告
作成 file path と主要 section の proof を console に出す。マーケ担当への共有文言サンプルも提示:
「PM から v0.7.0 の release 申し送り書が marketing/handoff/26050101_v0-7-0-release-summary.md に入りました。article draft 展開お願いします。」
出力 template (frontmatter + 構造)
---
title: KIOKU {VERSION} リリース概要 — マーケ部向け説明資料
from: PM Claude ({起動時の session 文脈})
to: マーケティング戦略部 / マーケ担当 Claude
created: {YYYY-MM-DD}
purpose: {VERSION} リリースをマーケ部に説明するための構造化資料。バグ fix / 内部改善は除外、user が touch できる価値のみに絞る
status: PM からの申し送り、以降 article 展開・SNS 展開・LP 素材化はマーケ担当管轄
related:
- handoff/post-release-{VERSION}.md (PM 側 observation checklist、あれば)
- plan/claude/XXXXX (該当 Phase roadmap)
- README.md Changelog §{YYYY-MM-DD} (user 向け一次情報)
---
# 📌 PM からの説明 (冒頭)
本 document は **PM Claude が {VERSION} リリースの中身をマーケ部向けに整理した申し送り** です。技術 side (PM) が「何が出たか / なぜ重要か / どう訴求できるか」に翻訳し、マーケ担当 (別 Claude session + RYU) に渡します。
**ルール**:
- 本 file 以降の article draft 作成 / X 投稿 / note.com 記事 / LP 素材化はマーケ担当の管轄 (`tools/claude-brain/marketing/article/`)
- PM side は実装 / release / observation が守備範囲
- 事実確認はマーケ担当 → PM session に照会してください
- `.claude/rules/marketing.md` + `feedback_marketing_separation.md` (memory) 準拠。**本 file は PM が marketing/ 配下に書く RYU 明示例外**: release 申し送りは PM 主導、以降の article 展開・SNS 展開・LP 素材化はマーケ担当管轄
---
# 📢 KIOKU {VERSION} リリース概要
**リリース日**: {YYYY-MM-DD}
**タグライン案**: "{1 行 narrative}"
## 🌟 {N} つの大きな user 変化
### 1. {Feature 1}
**Before**: ...
**After**: ...
**なぜ重要**: ...
(... 各 feature について繰り返し)
---
## 🛡 セキュリティ姿勢の強化 (該当 release なら)
...
---
## 🔮 次バージョン ({next}) への仕込み
内部で {...} 実装済 (user には見えない)。{next} で以下が出ます:
- ...
**なぜ marketing 的に重要**: ...
---
## 💬 {next}+ へ延期 (問い合わせ対応 FAQ)
| 項目 | 状態 / 予定時期 |
|---|---|
| ... | ... |
---
## 📣 記事ネタ候補 (3 本、マーケ担当が draft 化)
### A. "{タイトル}" ({媒体})
- ...
- **想定読者**: ...
### B. ...
### C. ...
---
## 📥 Release リンク
- **GitHub Release**: https://github.com/megaphone-tokyo/kioku/releases/tag/{VERSION}
- **`.mcpb` Direct**: https://github.com/megaphone-tokyo/kioku/releases/download/{VERSION}/kioku-wiki-{VERSION_NO_V}.mcpb
- **SHA-256**: `{sha}`
---
## 🤝 マーケ担当への引き継ぎ
### 既存 article 資産
`tools/claude-brain/marketing/article/` 配下に過去 release 記事あり。{VERSION} 記事を書く際は v0.(X-1) 記事 (dev.to / Qiita / Zenn 3 媒体) のフォーマットを踏襲推奨。
### マーケ運用鉄則
`tools/claude-brain/marketing/handoff/kioku-marketing-handover.md` を正典として参照。
### 疑問があれば PM へ照会
本資料の事実関係 (何が実装されたか / どの PR / test coverage / release 時期) は PM session で確認可能。
---
## 📌 Metadata
- 本 file 作成時の parent main: `{sha}`
- kioku main: `{sha}`
- kioku tag: `{VERSION}` — published {timestamp}
- PM session 今日の merged PR: {list}
Reference example
最初の実例は tools/claude-brain/marketing/handoff/26042404_v0-6-0-release-summary.md (v0.6.0 release、2026-04-24)。文体・粒度・記事ネタの書き方はこれを基準にする。
マーケ運用ルール整合
.claude/rules/marketing.md 準拠: marketing/ 配下への保存、YYMMDD_topic.md 命名feedback_marketing_separation.md 例外: 本 skill は PM が起動するが、出力は marketing/ に入る (RYU 明示の許可運用)feedback_handoff_script_verify.md (LEARN#10) 準拠: Changelog 抽出前に ### YYYY-MM-DD — {VERSION} heading の実在を grep で verify
Test (skill 自体には test 不要、ただし出力検証)
本 skill が生成した handoff は PM が目視で以下 check:
生成物に不備があれば skill ロジックを改訂 (PR で SKILL.md 修正)。
