tech-storyteller
Installation
SKILL.md
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やエラーログから、直面した課題とそれをどう乗り越えたかの「山場」を見つけ出します。