ESLint Configuration Skill
概要
ESLint設定ファイルの作成・更新を行うスキル。プロジェクトの技術スタック(言語、フレームワーク)を分析し、最適なルールセット・パーサー・プラグインを選定・設定する。
ワークフロー
Phase 1: プロジェクト分析
目的: プロジェクトの技術スタックと既存設定を把握
アクション:
- package.json、tsconfig.json、既存eslint設定を確認
- 使用言語(JavaScript/TypeScript)を特定
- フレームワーク(React/Vue/Node等)を判定
- 既存のlint関連設定との整合性を確認
Task: agents/analyze-project.md を参照
Phase 2: 設定生成
目的: 最適なESLint設定を生成
アクション:
- ベースルールセットを選定(recommended/strict等)
- パーサー設定(@typescript-eslint/parser等)
- プラグイン統合(react, import, boundaries等)
- カスタムルール適用
- Prettier競合ルールの無効化
Task: agents/configure-rules.md を参照
Phase 3: 検証
目的: 生成した設定の動作確認
アクション:
- 設定ファイルの構文検証
eslint --print-configで設定確認- サンプルファイルでlint実行
- エラー・警告の適切性確認
Task: agents/validate-config.md を参照
Task仕様(ナビゲーション)
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-project | Phase 1開始時 | プロジェクトパス | 技術スタック情報 |
| configure-rules | Phase 2開始時 | 技術スタック情報 | ESLint設定ファイル |
| validate-config | Phase 3開始時 | ESLint設定ファイル | 検証結果レポート |
詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照
ベストプラクティス
すべきこと
- Flat Config形式(eslint.config.js)を優先使用
- TypeScriptプロジェクトでは
@typescript-eslintを使用 - Prettierと併用時は
eslint-config-prettierを追加 - 段階的に厳格化(最初は recommended から)
- プロジェクト固有ルールは明確にコメント
避けるべきこと
- .eslintrc形式の新規作成(レガシー形式)
- 不要なプラグインの追加
- ルール無効化の乱用(disable コメント)
- 競合するプラグインの併用
- 型チェックルールの過剰適用(パフォーマンス低下)
リソース参照
references/(詳細知識)
| リソース | パス | 用途 |
|---|---|---|
| パーサー設定ガイド | See references/parser-configuration.md | TypeScript/JSパーサー設定 |
| プラグイン統合ガイド | See references/plugin-integration.md | プラグイン選定・設定 |
| ルール選定ガイド | See references/rule-selection-guide.md | ルールセット選択基準 |
scripts/(決定論的処理)
| スクリプト | 用途 | 使用例 |
|---|---|---|
validate-config.mjs |
設定ファイル検証 | node scripts/validate-config.mjs eslint.config.js |
log_usage.mjs |
フィードバック記録 | node scripts/log_usage.mjs --result success |
assets/(テンプレート)
| テンプレート | 用途 |
|---|---|
typescript-base.json |
TypeScript基本設定 |
react-typescript.json |
React+TypeScript設定 |
nextjs.json |
Next.js専用設定 |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.0.0 | 2026-01-01 | 18-skills.md完全準拠版として再構築 |
| 1.0.0 | 2025-12-24 | 初版作成 |