claw-log は何をしますか?
📝 Git 履歴からAIを活用した日々のコード変更サマリを自動生成し、技術的な意思決定を記録、履歴書作成を効率化します。
概要
claw-log は、開発者の Git 履歴を解析し、日次・週次のコード変更サマリを自動生成する AI エージェントスキルです。これにより、以下のことが可能になります:
- 💡 技術的決定の記録: コミットメッセージやブランチ名、変更内容から、なぜその変更が行われたのかを明らかにします。
- 🚀 履歴書作成の効率化: プロジェクトへの貢献や重要な技術的判断を、後で簡単に参照・活用できる形式で出力します。
- 📊 カスタマイズ可能なレポート: ユーザーはテンプレートや出力形式をカスタマイズでき、特定のプロジェクトやチームに合わせたレポートを作成できます。
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他の AI エージェント環境
使用方法
- リポジトリのルートで
claw-logを実行します。 - 指定した期間(例: 本日、今週、先週)のコード変更を自動解析します。
- 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