translate-to-vision-storylisted
Install: claude install-skill YasuakiOmokawa/skills
# translate-to-vision-story
**プロジェクト単位の活動を、ビジョン整合した Zenn 記事下書きに翻訳する。**
## 何を解決するか
プロジェクトでやったこと (taimei-auth, freee-mcp, ID統合設計など) を、自分のビジョンに繋がる物語として記事化したい。しかし「何をどう書けばビジョンと整合するか」を毎回ゼロから考えるのは負担で、結果としてふりかえりが「単なる技術深掘り」で終わり、ブランディングに繋がらない。
このスキルは、`~/.claude/skills-config/vision.md` に書かれたビジョン要素と照合しながら、5 ステップの対話フローで Zenn 記事下書きを生成する。
## 入出力
- **入力**: プロジェクトディレクトリのパス (例: `~/mydev/taimei`)
- **出力**: Zenn 記事下書き Markdown ファイル (デフォルト: `<project-path>/docs/draft/YYYY-MM-DD-<title>.md`)
## 前提
- `~/.claude/skills-config/vision.md` が存在すること
- 存在しない場合は `references/vision-config-template.md` をコピーして編集を促す
## 5 ステップ対話フロー
### Step 1: 文脈把握
#### 入力受け取り
ユーザーが `/translate-to-vision-story <project-path>` または「物語化したい」と発話したら起動する。`<project-path>` を引数または対話で受け取る。
#### 必須読み込み
各ステップは「成功 / 空・件数不足 / 欠落」の 3 分岐を明示する。skip した情報源は肝推定時に「○○ 由来情報なし」と内部メモする (後続 Step で証拠の偏りを判断するため)。
1. `~/.claude/skills-config/vision.md` を Read
- 成功 → ビジョン要素 (V1-V10) を把握
- 不在 → エラーハンドリング表 1 行目に従う (skill を一旦中断)
2. `<project-path>/README.md` を Read
- 成功 → 肝推定の主要証拠として使用
- 不在 → skip (内部メモ: README 由来情報なし)
3. `<project-path>` で `git log --oneline -50` を実行し直近コミットを取得
- 50 件以上 → そのまま使う
- 50 件未満 → 全件を使う (リポが小さくても abort しない)
- git history 自体が無い → エラーハンドリング表 2 行目に従う
4. `<project-path>` で `gh pr list --state merged --limit 30 --json number,title,mergedAt` を実行 (gh 利用可能時のみ)
- 利用するフィールド: `number` (関連活動表記用), `title` (柱抽出用), `mergedAt` (時系列把握用)
- gh 利用不可 → skip (内部メモ: PR 由来情報なし)
- 0 件 → skip (内部メモ: PR 駆動開発でない)
5.