mcpField
C
codefmt

codefmt

github.com/amplicode開発134253 回インストール7 週間前に更新
リポジトリ

codefmt について

codefmt は、プロジェクトのコードスタイルに沿ってソースファイルを整形するスキルです。IDE からリポジトリにアクセスできる場合は IntelliJ のフォーマッターを使い、利用できない場合はコンソールでプロジェクトの外部フォーマッターを実行します。

主な機能

  1. 01IDE と CLI の整形経路を選択
  2. 02利用可能時に IntelliJ フォーマッターを使用
  3. 03プロジェクトの外部フォーマッターに切り替え
  4. 04IDE でコードブロックを整形
  5. 05git diff で変更ファイルを報告

活用シーン

  1. 01プロジェクトのファイルを整形
  2. 02IDE で選択したコードブロックを整形
  3. 03IDE 不在時に外部フォーマッターを実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/amplicode/spring-skills --skill codefmt

インストール後、Claude Code で/codefmtを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
fallback.md
ide.md
scripts/
format-code-block.kts
format-file-group.kts
format-single-file.kts
format-uncommitted.kts

詳細

プロジェクトのコードスタイルでソースファイルをフォーマットする

同じコードスタイルにたどり着く方法は 2 つあります。IDEでは IntelliJ 独自のフォーマッターを適用します（忠実度が最も高く、IDE の VFS／PSI キャッシュとの整合性も保たれます）。CLI フォールバックでは、IDE に接続できない場合に、プロジェクト独自の外部フォーマッター（Spotless ／google-java-format／palantir-java-format）を適用します。

方法を選ぶ

どちらのリファレンスも読み込む前に、まずここで確認してください。必要な方だけを読みます。steroid_list_projects を呼び出してください（ツールのスキーマが読み込まれていない場合は ToolSearch("steroid list projects execute code") を使用します）。

  • 現在のリポジトリが返される場合 → IDE の方法：その項目の project_name （人が読むための name ではなく、不透明なルーティングキー）を控えて、 references/ide.md に従います。その手順では最初から project_name がわかっているため、再確認しないでください。
  • 失敗する場合、またはリポジトリが一覧にない場合 → CLI フォールバックの方法： references/fallback.md に従います（Spotless／ java-format を検出してコンソールで実行します）。IDE に接続できなかったため、 外部フォーマッターにフォールバックすることを、最初にユーザーへ伝えてください。

ブロック／行範囲のフォーマット（IDE の手順 2）は IDE 専用です。CLI では忠実に 置き換えられません。ユーザーがブロックを指定し、IDE に接続できない場合は、ファイル 全体を黙ってフォーマットするのではなく、その旨を伝えてください。

どちらの方法でも最後に git diff --stat <paths> を実行し、実際に変更された内容を報告します。フォーマット後に差分がない場合も有効な結果です。ファイルはすでにスタイルに準拠していると、作業を行ったかのように示唆せず、明確に伝えてください。

コメント

Markdown 対応