Communityライティング&編集github.com

EHR-U/claw-log

📝 Git 履歴から開発者の技術的決定を自動で要約し、履歴書作成を効率化します。

claw-log とは?

claw-log は、開発者の日常的なコード変更を AI が自動で要約し、技術的な意思決定を記録するためのスキルです。Git 履歴を分析し、変更内容、コミットメッセージ、ブランチ情報などから、日次・週次のサマリレポートを生成します。このツールは、Claude Code や Cursor などの AI エージェントプラットフォームで動作し、開発者が後で振り返ったり履歴書に活用したりできる形で、変更の背景や目的を文書化します。また、複数のレポジトリに対応し、カスタムテンプレートによる出力形式の調整も可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add EHR-U/claw-log

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

claw-log は何をしますか?

📝 Git 履歴からAIを活用した日々のコード変更サマリを自動生成し、技術的な意思決定を記録、履歴書作成を効率化します。

概要

claw-log は、開発者の Git 履歴を解析し、日次・週次のコード変更サマリを自動生成する AI エージェントスキルです。これにより、以下のことが可能になります:

  • 💡 技術的決定の記録: コミットメッセージやブランチ名、変更内容から、なぜその変更が行われたのかを明らかにします。
  • 🚀 履歴書作成の効率化: プロジェクトへの貢献や重要な技術的判断を、後で簡単に参照・活用できる形式で出力します。
  • 📊 カスタマイズ可能なレポート: ユーザーはテンプレートや出力形式をカスタマイズでき、特定のプロジェクトやチームに合わせたレポートを作成できます。

対応プラットフォーム

  • Claude Code
  • Cursor
  • Codex
  • その他の AI エージェント環境

使用方法

  1. リポジトリのルートで claw-log を実行します。
  2. 指定した期間(例: 本日、今週、先週)のコード変更を自動解析します。
  3. AI が生成したサマリが、ターミナルまたは指定されたファイルに出力されます。
claw-log --since "2024-01-01" --until "2024-01-07" --output resume-ready.md

設定

オプションの設定ファイル (claw-log.config.json) を使用して、以下の項目をカスタマイズできます:

設定項目説明デフォルト値
template出力テンプレートのパスdefault
outputFormat出力形式 (markdown, json, text)markdown
includeBranches分析するブランチのパターン["main", "develop"]
excludePatterns除外するファイルパスのパターン["node_modules/**", "*.lock"]

例

## 2024-01-01 の変更サマリ

### 修正
- **認証システムの修正**(ブランチ: `fix/auth-issue`)
  - JWT トークンの有効期限チェックを改善
  - ユーザーセッション管理のバグ修正
  - 関連コミット: `abc123`, `def456`

### 機能追加
- **ダッシュボードの新規ウィジェット**(ブランチ: `feat/dashboard-widget`)
  - リアルタイムデータ表示機能を実装
  - API エンドポイント `/api/v2/widgets` を追加

コントリビューション

フィードバックや改善提案は、GitHub リポジトリの Issue または Pull Request でお寄せください。

ライセンス

MIT

関連スキル