From translate-to-vision-story
プロジェクト活動 (commits/PRs/README/ADR) を `~/.claude/skills-config/vision.md` のビジョン要素と照合し、対話型 draft → revise loop で Zenn 記事下書きを生成する。プロジェクト単位の物語化・キャリアブランディング・月次記事執筆時に使用。
How this skill is triggered — by the user, by Claude, or both
Slash command
/translate-to-vision-story:translate-to-vision-storyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**プロジェクト単位の活動を、ビジョン整合した Zenn 記事下書きに翻訳する。**
プロジェクト単位の活動を、ビジョン整合した Zenn 記事下書きに翻訳する。
プロジェクトでやったこと (taimei-auth, freee-mcp, ID統合設計など) を、自分のビジョンに繋がる物語として記事化したい。しかし「何をどう書けばビジョンと整合するか」を毎回ゼロから考えるのは負担で、結果としてふりかえりが「単なる技術深掘り」で終わり、ブランディングに繋がらない。
このスキルは、~/.claude/skills-config/vision.md に書かれたビジョン要素と照合しながら、5 ステップの対話フローで Zenn 記事下書きを生成する。
~/mydev/taimei)<project-path>/docs/draft/YYYY-MM-DD-<title>.md)~/.claude/skills-config/vision.md が存在すること
references/vision-config-template.md をコピーして編集を促すユーザーが /translate-to-vision-story <project-path> または「物語化したい」と発話したら起動する。<project-path> を引数または対話で受け取る。
各ステップは「成功 / 空・件数不足 / 欠落」の 3 分岐を明示する。skip した情報源は肝推定時に「○○ 由来情報なし」と内部メモする (後続 Step で証拠の偏りを判断するため)。
~/.claude/skills-config/vision.md を Read
<project-path>/README.md を Read
<project-path> で git log --oneline -50 を実行し直近コミットを取得
<project-path> で gh pr list --state merged --limit 30 --json number,title,mergedAt を実行 (gh 利用可能時のみ)
number (関連活動表記用), title (柱抽出用), mergedAt (時系列把握用)<project-path>/docs/adr/*.md<project-path>/adr/*.md<project-path>/../docs/adr/*.md収集した情報から、AI が「このプロジェクトの肝はこの 3 点」を初期提案する。
ビジョン要素紐付けの優先順位:
整合点の分岐:
形式:
このプロジェクトの肝は以下の 3 点と推定しました:
1. **(技術的判断 1)** — (1-2 行の説明)
- 関連活動: (commit hash / PR# / ADR-N 等)
- 推定整合ビジョン要素: V_x
2. **(技術的判断 2)** — ...
3. **(技術的判断 3)** — ...
この 3 点で物語化を進めて良いですか? 違うなら指摘してください。
→ Step 2 (柱確認) へ。
| ユーザー応答 | 動作 |
|---|---|
| 「OK」「いいよ」「進めて」 | 3 点を確定し Step 3 へ |
| 「(別の柱を提示)」 | 提示された柱で再構成、再度ユーザー確認 |
| 「○番を変えたい」 | 該当番号のみ AI が再生成、再度ユーザー確認 |
| 「3 点じゃなくて 2 点でいい」 | 数を調整して再構成、再度ユーザー確認 |
柱の合意なしに Step 3 (下書き生成) に進んではならない。 誤った柱で進むと revise loop が無限化する。
確定した柱ごとに、vision.md のビジョン要素 (V1-V7 等) と紐付ける。整合する要素が複数ある場合は全て列挙する。整合する要素がゼロの柱は「ビジョンに整合しない柱」としてマークし、Step 3 で「失敗した点 / ビジョンに整合しなかった点」セクションに含めることを提案する。
確定結果のフォーマット:
柱が確定しました:
1. (柱 1) → V1, V4
2. (柱 2) → V5
3. (柱 3) → 整合要素なし (失敗談として扱う)
下書きを生成します...
→ Step 3 へ。
デフォルト: <project-path>/docs/draft/YYYY-MM-DD-<title>.md
<title> は柱から自動生成 (例: 「taimei-auth-separation」「freee-mcp-namespace-pattern」)<project-path>/docs/draft/ ディレクトリが存在しなければ作成する${CLAUDE_PLUGIN_ROOT}/skills/translate-to-vision-story/references/zenn-article-structure.md の構造に従う:
「ビジョンに整合しなかった柱」がある場合は、3. の前に「失敗した点 / ビジョンに整合しなかった点」セクションを追加する。
---
title: "(自動生成)"
emoji: "💭"
type: "tech"
topics: ["claudecode"] # 柱から推定して追加
published: false
---
Write ツールでファイル作成。書き出し後、ユーザーに以下を提示:
下書きを生成しました: <output-path>
変更したい箇所があれば教えてください:
- 「ここ弱い」「ここ強調」「この技術詳細追加」「カット」 などの FB を受け付けます
- 「OK」と言えば完了処理に進みます
→ Step 4 へ。
| FB パターン | 動作 |
|---|---|
| 「○○を強調」 | 該当箇所を 50% 程度厚くする (Edit でファイル更新) |
| 「○○弱い / 詳細追加」 | 該当箇所に技術詳細・コード例・図を追加 |
| 「○○カット」 | 該当箇所を削除、前後を接続 |
| 「○○を別の言い方で」 | 該当箇所を書き換え |
| 「ビジョン要素 V_x への繋がりが弱い」 | 該当ビジョン要素について追記 |
| 「OK」「これで完了」 | Step 5 へ |
Step 5 で revision-log を記録するため、各 revise の内容を内部的に保持する。形式:
- (revise 1) ユーザー FB: "○○強調" → 該当段落を厚くした
- (revise 2) ユーザー FB: "V_x への繋がり弱い" → 該当ビジョン要素について追記
- ...
ユーザーが「OK」「これで完了」「いいよ」と発話したら Step 5 へ進む。
→ Step 5 へ。
最終版をそのまま保存 (revise loop の最後の Edit / Write 結果が最終版)。
ファイル末尾に HTML コメント形式で revision-log を埋め込む (Zenn 記事として publish 時には表示されない、再 revise 時の参考資料)。
<!-- revision-log
- (revise 1) ユーザー FB: "○○強調" → 該当段落を厚くした
- (revise 2) ユーザー FB: "V_x への繋がり弱い" → 該当ビジョン要素について追記
-->
ユーザーが希望すれば、各 H2 段落の冒頭に整合するビジョン要素を HTML コメントで付与する:
## 取り組み
<!-- vision: V1, V4 -->
(段落本文)
記事下書きが完成しました: <output-path>
次にやること:
1. このファイルを Zenn ローカル CLI で preview する
2. 必要に応じて手動で文章を磨く
3. publish 準備が整ったら frontmatter の `published: true` に変更
skill 終了。
| 状況 | 動作 |
|---|---|
~/.claude/skills-config/vision.md が存在しない | エラーメッセージ最低含有要素 (1) に従いユーザー提示。承認後コピー → 編集 → skill 再実行 |
<project-path> に git history が無い | エラーメッセージ最低含有要素 (2) に従いユーザー提示 |
| ビジョン整合点ゼロ (全柱で整合要素ゼロのとき) | エラーメッセージ最低含有要素 (3) に従いユーザー提示 |
| 出力先ディレクトリが書き込み不可 | 別パスを提案、または abort |
各エラー提示メッセージに以下を必ず含める。要素の欠落は不可。
${CLAUDE_PLUGIN_ROOT} 等): ユーザー提示メッセージ内ではそのまま展開せず変数表記のままで可~/.claude/skills-config/vision.md が存在しない旨を明示${CLAUDE_PLUGIN_ROOT}/skills/translate-to-vision-story/references/vision-config-template.md~/.claude/skills-config/vision.md/translate-to-vision-story <project-path> を再実行<project-path> に git history が無い旨define-acceptance-criteria / mece-plan-review / finalize-plan 等の「プラン駆動開発」スキル群とは別レイヤー (career 系)~/.claude/plans/translate-to-vision-story.mdFetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Applies a firm's KYC/AML rules grid to parsed onboarding records: assigns risk rating, checks required documents, outputs rule outcomes with citations, and routes for escalation.
Generates daily or weekly digests of activity from connected sources (chat, email, docs, tasks, CRM), highlighting action items, decisions, mentions, and project updates.
npx claudepluginhub yasuakiomokawa/skills --plugin translate-to-vision-story