🚀 Claude Code と Git で自分の活動を可視化しよう
GitHub リポジトリはこちら → htanaka0828/Nippo-by-llm
複数のプロジェクトやリポジトリにまたがって開発をしていると、自分がどこで何をしていたかを振り返るのが難しいと感じたことはないでしょうか。たとえば、日報や週報を作成する場面で「今日は何をしたんだっけ？」と考え込んでしまう──そんな経験がある方に向けて、今回はその課題を解決するツールをご紹介します。
✅ 活動の棚卸し、もっと楽にしませんか？
私が開発した 「Nippo-by-llm」 は、GitHub 上での活動履歴（コミットやプルリクエストなど）を自動的に収集し、Claude Code を活用して自然な文章として要約し、Slack に投稿できるツールです。プロジェクトが複数にまたがっていたとしても、まとめて振り返ることができるので、個人の作業記録だけでなくチームへの共有や報告にも役立ちます。
このツールは、Claude を日常的に使っているエンジニアであれば導入に手間がかかることはありません。Shell スクリプトで Git ログを安定して収集しつつ、出力の整形には Claude の柔軟な自然言語生成を活用しているため、**"構造は安定していて、内容は柔軟"**という設計思想になっています。なお、OpenAI APIキーは不要です。
⚙️ どのように動くのか？
ツールの基本的な流れは以下の通りです：
- 複数の GitHub オーガナイゼーションやリポジトリから、直近の活動ログを収集します。
- ログは Shell スクリプトによって整形され、Claude Code に渡されます。
- Claude がログを人間が読みやすい文に要約します。
- 必要に応じて、Slack に日報として投稿されます。
このような構成により、ログ取得の安定性と、生成文の柔軟さの両立が可能になっています。文章出力の揺らぎを防ぐ工夫も施しており、Claude からの出力は日報や週報として十分に実用に耐える品質になっています。
💡 なぜ作ったのか？
私自身、複数のチームにまたがって開発やレビュー、仕様策定などの業務を行う中で、自分のアウトプットを日々記録するのが煩雑になっていました。特にマルチリポジトリ・マルチオーガナイゼーションでの活動は GitHub の UI だけでは俯瞰しづらく、記録も漏れがちになります。そんな背景から、「ログから自然な日報を生成し、Slack に投げるだけ」というシンプルかつ実用的な仕組みを作りました。
文章を一から書くのが苦手な方や、毎日の作業をうまく言語化できないと悩む方にとっても、このツールは良い補助線になるはずです。
🛠 実際の使い方
利用にあたっての前提環境や設定方法は、GitHub リポジトリの README に詳しく書いてあります。Claude を使ったことがある方であれば、簡単に導入できるはずです。
ツールを実行すると、数分でその日の活動がまとまった日報として生成されます。必要があれば、その内容を Slack に投げることでチームとの共有も完結。普段から Slack でコミュニケーションしているチームであれば、自然な形で「今日やったこと」の共有が習慣化されるはずです。
🧠 Claude のプロンプト設計について
LLM を活用する際に重要なのがプロンプト設計です。今回のツールでは、どのリポジトリでどんな作業をしたのかを明確に出力させることを意識し、プロンプトに工夫を加えています。特に、日報にふさわしい文体やトーンが安定するように指示を加えることで、「毎回出力が違って困る」といった LLM 活用時の課題もある程度抑えています。
さらに、自分のチームやプロジェクトに合わせてこのプロンプト部分をカスタマイズすることで、例えば週報形式やマネージャー向けのレポートなどにも応用可能です。
📝 おわりに
Git のログは、ただの履歴ではなく、あなたの積み重ねた成果そのものです。Nippo-by-llm は、それを見える形にし、言葉としてまとめてくれるツールです。毎日コツコツと何をしてきたかを自然な形で記録できる仕組みを、自分のワークフローに取り入れてみてはいかがでしょうか。
興味を持たれた方は、ぜひ GitHub リポジトリ を覗いてみてください。フィードバックや改善提案、Pull Request も歓迎しています。
🧾 この記事は、筆者が提示した構成・内容をもとに ChatGPT により作成されました。
スクリプト設計と Claude プロンプト設計に関する知見を整理し、文章化しています。