スキル一覧に戻る
shoma-endo

project-naming

by shoma-endo

0🍴 0📅 2026年1月18日
GitHubで見るManusで実行

SKILL.md


name: project-naming description: プロジェクト全域の命名規則。ディレクトリ、ファイル、コード内の全ルールを網羅した唯一の正解(SSoT)。

プロジェクト命名規則

このスキルは、プロジェクトにおけるすべての命名の「唯一の正解 (Single Source of Truth)」を定義します。常にこの規約を守ってください。

命名規則ガイドライン

1. ディレクトリ命名

  • 原則: すべて kebab-case (例: business-info/, api/line-oauth/, src/server/actions/)

2. ファイル命名 (接尾辞・ケースの徹底)

  • Next.js 固定名: page.tsx, layout.tsx, route.ts, error.tsx, loading.tsx, not-found.tsx, template.tsx
  • コンポーネント:
    • shadcn/ui: kebab-case.tsx (例: button.tsx, avatar.tsx)
    • カスタム: PascalCase.tsx (例: ChatClient.tsx, CanvasPanel.tsx)
  • 実装ファイル (論理命名/ドメイン系):
    • Hooks: camelCase.ts (例: useChatSession.ts)
    • Services: ...Service.ts (例: chatService.ts, supabaseService.ts)
    • Actions: ...actions.ts (例: user.actions.ts)
    • Middleware: ...middleware.ts (例: auth.middleware.ts)
    • Schemas: ...schema.ts (例: brief.schema.ts)
    • Models: ...Models.ts (例: chatModels.ts)
  • その他 (物理命名/モジュール系):
    • Types: kebab-case.ts (例: chat.ts, analytics.ts)
    • Lib/Utils: kebab-case.ts (例: client-manager.ts, blog-canvas.ts)

3. コード内命名

  • React コンポーネント / クラス / 型 / インターフェース / Enum: PascalCase
  • 関数・メソッド / 変数 / パラメータ: camelCase
  • 定数 (グローバル・設定): UPPER_SNAKE_CASE (例: MODEL_CONFIGS, ERROR_MESSAGES)

運用ルール

  1. このファイルを絶対的な基準とし、.claude.codex で常に内容を同期させます。
  2. 命名に迷った場合、ドキュメントではなくこのスキルの定義を優先してください。

スコア

総合スコア

50/100

リポジトリの品質指標に基づく評価

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です