coding-standardscommit d29cf65SKILL.md · コーディング規約
コーディング規約
命名・可読性・不変性・エラー処理・コードスメル確認など、プロジェクト共通の基本的なコーディング規約を示します。
npx skills add affaan-m/ECC --skill coding-standardsコマンドを選択しました。手動でコピーしてください。
- 権限
- read-repo
- write-files
- shell
- network
- 対応ツール
- Claude Code, Codex, Cursor, Copilot, OpenCode
- GitHub
- 294.3k
- 提供元
- コミュニティ · Affaan Mustafa
- 状態
- スキャン済み
- ライセンス
- MIT
- カテゴリ
- コーディング規約
基本ルール
常にスプレッド構文で新しいオブジェクトや配列を作り、元のデータを直接変更しないこと。
実行フェーズ
フェーズ 01適用範囲の確認
このスキルは共通の土台です。React やバックエンド設計、API 設計には専用スキルを優先します。
フェーズ 02基本原則
可読性を最優先にし、KISS・DRY・YAGNI に従い、過剰設計や早すぎる最適化を避けます。
フェーズ 03TS/JS の規約
説明的な変数名と動詞-名詞の関数名を使い、不変性を守り、エラー処理を入れ、並列化できるなら Promise.all を使い、any を避けます。
フェーズ 04構成とテスト
REST と統一レスポンス形式、zod による入力検証、ファイル命名規則に従い、コメントは理由を書き、テストは AAA 構成と説明的な名前にします。
フェーズ 05コードスメル確認
50行を超える長い関数、5段以上の深いネスト、マジックナンバーを探し、分割・早期 return・名前付き定数で直します。
権限の説明(SKILL.md より)
| 機能 | 必要か | 説明 |
|---|---|---|
| ファイル書き込み | 必要 | これらの規約に沿ってプロジェクトのコードを書いたりリファクタリングしたりします。 |
| コマンド実行 | 不要 | 規約のリファレンスであり、コマンドの実行は求めていません。 |
| 外部通信 | 不要 | ネットワークへのアクセスは不要です。 |
SKILL.md のフロントマター(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
---関連スキル
ルールスキャンですべてのリスクを検出できるわけではありません。インストール前にこのスキルの SKILL.md を読み、権限を確認してください。