ShanHaiFish/code-style-normalizer

code-style-normalizer は何をしますか？

コードクリーンアップ、コメントの正規化、末尾コメントの整列を高速かつ安全に行う再利用可能なスキルです。Codex、VSCodeエージェント、OpenCodeで動作します。

概要

このスキルは、コードベース全体のコメントスタイルを統一し、冗長なコメントを削除し、トラバースコメント（行末コメント）を整列させることで、可読性と保守性を向上させます。

主な機能

• コメント正規化: コメント内の不要なスペースや特殊文字を削除し、フォーマットを統一します。
• 末尾コメント整列: コード行の末尾にあるコメントを、一定のインデントで整列させて視認性を高めます。
• コードクリーンアップ: 不要な空白行、末尾空白、その他のフォーマット問題を自動的に修正します。

対応プラットフォーム

• Codex
• VSCodeエージェント
• OpenCode

使用方法

1. スキルをインストールします。
2. 設定ファイル（例: .code-style-normalizer.json）をプロジェクトルートに配置します。
3. エージェントにスキルを実行するよう指示します。

設定例

{
  "commentAlignment": true,
  "removeRedundantComments": true,
  "excludeDirs": ["node_modules", "dist"],
  "fileExtensions": [".js", ".ts", ".py", ".java"]
}

詳細

このスキルは内部で正規表現と構文解析を組み合わせて、コードの意味を変更せずにスタイルのみを変更します。ファイルの種類ごとに適切なコメント記号を自動認識し、言語に応じた処理を行います。