Communitygithub.com

fiftiesHousewife/Clean-Claude

Robert Martinスタイルのコーディングスタイルフィードバックを提供するGradleプラグイン。OpenRewriteと静的コード解析ツールを使用し、Claudeスキルを生成します。

Clean-Claude とは?

Clean-Claudeは、Gradleプラグインとして動作し、OpenRewriteや静的コード解析ツール(Checkstyle、PMD、SpotBugsなど)を統合して、Robert Martin(Clean Codeの提唱者)の流儀に基づくコーディングスタイルのフィードバックを自動生成します。本ツールは、コードベースの品質を評価し、改善点を特定するだけでなく、その結果を元にClaude CodeのようなAIエージェントが読み取り可能なスキル定義(Markdownファイル)を自動生成します。開発者はこのスキルをClaude CodeやCursor、CodexなどのAIアシスタントに組み込むことで、一貫したクリーンコードの原則をプロジェクト全体に適用でき、コードレビューの効率化と品質向上を実現します。Javaプロジェクトに特化しており、Gradleビルドシステムとの親和性が高く、CI/CDパイプラインへの統合も容易です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add fiftiesHousewife/Clean-Claude

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

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

ドキュメント

Clean-Claude は何をしますか?

Robert Martinスタイルのコーディングスタイルフィードバックを提供するGradleプラグイン。OpenRewriteと静的コード解析ツールを使用し、Claudeスキルを生成します。

概要

Clean-Claudeは、Gradleビルドシステムのプラグインとして動作し、以下の主要な機能を提供します:

  • 静的コード解析:Checkstyle、PMD、SpotBugsなどのツールを統合し、コードの品質を自動評価
  • OpenRewriteによるリファクタリング:コードパターンの自動変換と改善
  • Claudeスキルの自動生成:解析結果を元に、Claude Codeや他のAIエージェントが理解可能なスキル定義(Markdown)を作成
  • Robert Martinスタイルのフィードバック:Clean Codeの原則に基づいた具体的な改善提案

インストール

build.gradle または build.gradle.kts に以下のプラグインを追加します:

plugins {
    id 'com.fiftieshousewife.clean-claude' version '1.0.0'
}

使用方法

基本的なタスク

./gradlew cleanClaude

このコマンドは、以下の処理を実行します:

  1. 静的コード解析ツールを実行
  2. OpenRewriteによるリファクタリング提案を生成
  3. 解析結果を基にClaudeスキルを生成

設定

build.gradle にカスタム設定を追加可能です:

cleanClaude {
    includePatterns = ['**/*.java']
    excludePatterns = ['**/test/**']
    ruleSets = ['clean-code', 'security', 'performance']
}

生成されるスキル

プラグインを実行すると、build/clean-claude/ ディレクトリにスキル定義が生成されます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントに読み込ませることで、以下のメリットが得られます:

  • 一貫したコードレビュー:プロジェクト全体で統一されたクリーンコードの原則を適用
  • 自動化されたフィードバック:プルリクエスト作成時に自動的にスタイルチェックを実施
  • 継続的な改善:コードベースの品質が時間とともに向上

対応プラットフォーム

  • Claude Code
  • Cursor
  • Codex
  • GitHub Copilot(部分対応)

ライセンス

MIT

関連スキル