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 形式で、ブログ、ドキュメント、または人間が読むための素材集を出力。