# Tech Storyteller

> リポジトリの履歴やドキュメントから開発の「物語（事実・素材）」を収集します。

- Skill: `keiji-miyake/tech-storyteller` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add keiji-miyake/tech-storyteller`
- Raw SKILL.md: https://api.skillmd.com/api/skills/keiji-miyake/tech-storyteller/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: keiji-miyake (https://skillmd.com/u/keiji-miyake)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/keiji-miyake/tech-storyteller

---


# Tech Storyteller Skill

このスキルは、コードやログの断片を、ブログ記事やドキュメントの「素材」へと変換するための手順と知識を提供します。開発プロセスを客観的に観察し、背後にあるストーリーを掘り起こします。

## 使用タイミング (When to Use)

- 開発作業の区切りで、何をしたかを振り返り、アウトプットのネタを探したいとき。
- 複雑な修正の意図を Git 履歴やチャットログから再構成したいとき。
- 技術レポート、週報、PR 説明文などのための「事実に基づいた正確な素材集」を作成したいとき。

## 核となる機能 (Core Features)

### 1. リポジトリ考古学
- **Git 解析**: 直近のコミットメッセージ、diff、PRの説明を読み込み、技術的な変更の要点を抽出します。
- **ドキュメント連携**: `ARCHITECTURE.md` や `CHANGELOG.md` を参照し、プロジェクトの全体像と個別の変更を紐付けます。

### 2. インサイトの抽出
- **意思決定の記録**: `task.md` や `implementation_plan.md` から、なぜその手法を選んだか、どのような代替案があったかを特定します。
- **課題と解決**: `walkthrough.md` やエラーログから、直面した課題とそれをどう乗り越えたかの「山場」を見つけ出します。

### 3. 素材集の生成 (Output Generation)
以下の項目を含む「記事の素材集」を出力します。
- **背景**: なぜこの機能/修正が必要だったか。
- **技術的詳細**: どのような技術スタックを使い、どのような実装をしたか。
- **学び**: 開発を通じて得られた知見や苦労。

## ワークフロー (Workflow)

1.  **環境探索**: `git log` やプロジェクトディレクトリを走査し、関連性の高いファイルや履歴を特定。
2.  **事実の整理**: 時系列またはテーマ別（機能追加、バグ修正、設計変更）に出来事を整理。
3.  **ストーリー化**: 単なる履歴の羅列ではなく、「課題 → 試行錯誤 → 解決」という物語の骨子を抽出。
4.  **素材の出力**: Markdown 形式で、ブログ、ドキュメント、または人間が読むための素材集を出力。