s-lixy/enterprise-code-conventions-skill

enterprise-code-conventions-skill は何をしますか？

Python、Java、Vue プロジェクトにおいて、エンタープライズグレードのコード規約、ファイル命名規則、ディレクトリ配置、レイヤードアーキテクチャ、モジュール構成を強制するための Codex/エージェントスキルです。

概要

このスキルは、大規模な開発チームやエンタープライズ環境において、コードベースの一貫性を維持するために設計されています。AI エージェント（Codex、Claude Code、Cursor など）と連携し、プロジェクト構造やコードスタイルに関するガイドラインを自動的に適用します。

サポート言語

• Python
• Java
• Vue (JavaScript/TypeScript)

主な機能

• ファイル命名規則の強制: 各言語の標準に従った命名（例：Python ではスネークケース、Java ではパスカルケース）
• ディレクトリ配置の検証: レイヤードアーキテクチャ（例：controller, service, repository）や機能単位のモジュール分割をチェック
• モジュール構成の標準化: インポート順序、公開 API の設計、依存関係の方向性をルール化
• コードスタイルの統一: インデント、空白、コメント形式など、プロジェクト固有の規約を適用

使用方法

1. エージェント設定ファイルにこのスキルを追加します（例：.cursorrules、CLAUDE.md、codex.md）。
2. AI エージェントがプロジェクトのコードを分析・生成する際、自動的にルールが適用されます。
3. 必要に応じて、プロジェクトルートに配置された設定ファイル（例：codestyle.yaml）を読み込み、カスタムルールを追加できます。

設定例

# codestyle.yaml
naming:
  python: snake_case
  java: PascalCase
  vue: kebab-case

directories:
  python:
    - src/
    - tests/
  java:
    - src/main/java/
    - src/test/java/
  vue:
    - src/components/
    - src/views/

注意事項

• このスキルは既存のプロジェクトにも後から適用可能ですが、大規模なリファクタリングが必要になる場合があります。
• プロジェクト固有の例外ルールを設定することで、柔軟性を保つことができます。
• すべてのルールは AI エージェントによる自動チェックを前提としており、人間のレビューを完全に代替するものではありません。

ライセンス

MIT