dev-standards

# 開発ルール遵守チェックスキル

このスキルは、プロジェクトで重要な7つの開発ルールが適切に守られているかをチェックし、違反を発見・報告・修正します。

## 実行方法

### 基本的な使用方法

```
/dev-standards
```

プロジェクト全体の開発ルール遵守状況をチェックし、レポートを生成します。

### オプション

- `--fix` - 自動修正可能な違反を修正提案として表示
- `--typescript` - TypeScript関連のルールのみチェック
- `--ci` - CI/CD関連のルールのみチェック
- `--dependencies` - 依存関係管理のルールのみチェック
- `--commit` - コミット規約のルールのみチェック
- `--local-test` - ローカルテスト実行環境のルールのみチェック
- `--unit-test` - ユニットテスト関連のルールのみチェック
- `--pre-commit` - コミット前のlint/format/test実行に関するルールのみチェック
- 引数にファイルパスを指定 - 特定のファイルのみをチェック

### 使用例

```bash
# プロジェクト全体をチェック
/dev-standards

# TypeScriptファイルのanyのみチェック
/dev-standards --typescript

# 自動修正提案を表示
/dev-standards --fix

# 特定のファイルをチェック
/dev-standards src/utils/api.ts
```

## チェックされる7つの開発ルール

### 1. TypeScriptにおいてanyは使わない

**目的**: 型安全性を確保し、バグを事前に防止する

**チェック内容**:
- `.ts`, `.tsx` ファイル内の `any` 使用を検出
- `any[]`, `Promise<any>`, `Record<string, any>` なども対象
- `// @ts-ignore`, `// @ts-expect-error` の使用も確認

**修正提案**:
- `unknown` への置き換え
- ジェネリクス型の使用
- 適切な型定義の作成
- 型ガードの使用

### 2. 必ずCIで品質チェックを行うようにする

**目的**: コード品質を自動的に担保し、チーム全体の開発効率を向上

**チェック内容**:
- `.github/workflows/` または `.gitlab-ci.yml` などのCI設定ファイルの存在確認
- CI設定内での品質チェック実行の確認（lint, test, type-check など）
- プルリクエスト/マージリクエストでの必須チェックの設定確認

**推奨される品質チェック**:
- リント（ESLint, Prettier など）
- テスト実行（Jest, Vitest など）
- 型チェック（TypeScript）
- ビルドの成功確認

### 3. デプロイ前にローカルで実行して動作確認できるようにする

**目的**: 本番環境への影響を最小限にし、デプロイの安全性を向上

**チェック内容**:
- `package.json` の `scripts` セクションでのローカル実行スクリプトの確認
  - `dev`, `start`, `serve` などの開発サーバー起動コマンド
  - `build` や `preview` などのビルド・プレビューコマンド
- Docker Compose や devcontainer などのローカル実行環境設定の確認
- README.md でのローカル実行手順の記載確認

**推奨される設定**:
- `npm run dev` または `yarn dev` でローカル開発サーバーを起動できる
- `npm run build && npm run preview` で本番ビルドをローカルで確認できる
- ドキュメントにローカル実行手順が明記されている

### 4. 原則としてconventional commitを採用する

**目的**: コミット履歴を整理し、変更履歴の理解とリリースノート生成を容易にする

**チェック内容**:
- 直近のコミットメッセージが Conventional Commit 形式に従っているか確認
- プレフィックス（`feat:`, `fix:`, `docs:`, `chore:` など）の使用確認
- コミットメッセージの構造確認（type, scope, descripti