# コーディング規約 (coding-standards)

> 命名・可読性・不変性・エラー処理・コードスメル確認など、プロジェクト共通の基本的なコーディング規約を示します。

- カテゴリ: [コーディング規約](https://www.myskills.tools/ja/categories/code-standards/)
- 提供元: コミュニティ · Affaan Mustafa
- リポジトリ: https://github.com/affaan-m/ECC/tree/main/skills/coding-standards (commit d29cf65)
- SKILL.md: https://github.com/affaan-m/ECC/blob/main/skills/coding-standards/SKILL.md
- インストールコマンド: `npx skills add affaan-m/ECC --skill coding-standards`
- ライセンス: MIT
- 対応ツール: Claude Code, Codex, Cursor, Copilot, OpenCode
- 権限: read-repo ✓, write-files ✓, shell ✗, network ✗
- 状態: スキャン済み
- ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。

## 基本ルール

常にスプレッド構文で新しいオブジェクトや配列を作り、元のデータを直接変更しないこと。

## 実行フェーズ

1. **適用範囲の確認** — このスキルは共通の土台です。React やバックエンド設計、API 設計には専用スキルを優先します。
2. **基本原則** — 可読性を最優先にし、KISS・DRY・YAGNI に従い、過剰設計や早すぎる最適化を避けます。
3. **TS/JS の規約** — 説明的な変数名と動詞-名詞の関数名を使い、不変性を守り、エラー処理を入れ、並列化できるなら Promise.all を使い、any を避けます。
4. **構成とテスト** — REST と統一レスポンス形式、zod による入力検証、ファイル命名規則に従い、コメントは理由を書き、テストは AAA 構成と説明的な名前にします。
5. **コードスメル確認** — 50行を超える長い関数、5段以上の深いネスト、マジックナンバーを探し、分割・早期 return・名前付き定数で直します。

## 権限の説明（SKILL.md より）

| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 必要 | これらの規約に沿ってプロジェクトのコードを書いたりリファクタリングしたりします。 |
| コマンド実行 | 不要 | 規約のリファレンスであり、コマンドの実行は求めていません。 |
| 外部通信 | 不要 | ネットワークへのアクセスは不要です。 |

## SKILL.md のフロントマター（YAML）

```yaml
---
name: coding-standards
description: Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns. Use when reviewing code quality or naming with no framework-specific skill that applies.
metadata:
  origin: ECC
---
```

ホーム: https://www.myskills.tools/ja/ · URL: https://www.myskills.tools/ja/skills/coding-standards/