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