accelint-ts-best-practices

JavaScript と TypeScript のベストプラクティス

最新の JavaScript／TypeScript コードベースを扱う AI エージェントや LLM 向けに設計された、JavaScript および TypeScript アプリケーションの包括的なコーディング標準です。

注： このスキルでは、一般的なベストプラクティス、TypeScript のパターン、安全性に焦点を当てています。パフォーマンスの最適化には、代わりに accelint-ts-performance スキルを使用してください。

このスキルを使用する場面

このスキルでは、JavaScript と TypeScript のコードに関する専門的なパターンを提供します。AGENTS.md を読み込み、ルールの概要を確認して、タスクに関連する最適化を特定してください。

使用方法

このスキルでは、コンテキストの使用量を最小限に抑えるために、段階的開示の構成を採用しています。

1. 概要から始める（AGENTS.md）

AGENTS.md を読み、カテゴリ別に整理されたすべてのルールの簡潔な概要と、各ルールの一行要約を確認してください。

2. 必要に応じて特定のルールを読み込む

関連するパターンや問題を特定したら、対応するリファレンスファイルを読み込み、実装の詳細なガイダンスを確認してください。

クイックスタート：

• quick-start.md - 前後のコードを含む、ワークフローの完全な例

一般的なベストプラクティス：

• naming-conventions.md - わかりやすい名前、修飾子の順序、ブール値の接頭辞
• functions.md - 関数の規模、パラメーター、明示的な値
• control-flow.md - 早期リターン、フラットな構造、ブロックスタイル
• state-management.md - const と let、不変性、純粋関数
• return-values.md - null／undefined ではなくゼロ値を返す
• misc.md - 行末、堅牢なプログラミング、技術的負債
• code-duplication.md - 共通パターンの抽出、DRY 原則、集約するタイミング

TypeScript：

• any.md - any を避け、unknown またはジェネリクスを使用する
• enums.md - enum ではなく as const オブジェクトを使用する
• type-vs-interface.md - interface より type を優先する
• bundler-paths.md - 最適なバンドルのため、静的解析可能なインポートパスとファイルシステムパスを使用する

安全性：

• input-validation.md - スキーマを使用して外部データを検証する
• assertions.md - アサーションを分割し、値を含める
• error-handling.md - すべてのエラーを明示的に処理する
• error-messages.md - ユーザー向けメッセージと開発者向けメッセージ

パフォーマンス：

• パフォーマンス最適化のタスクでは、包括的なプロファイリングワークフローと最適化パターンを提供する accelint-ts-performance スキルを使用してください

ドキュメント：

• ドキュメント作成のタスクでは、JSDoc とコメントに関する包括的なガイダンスを提供する accelint-ts-documentation スキルを使用してください

3. パターンを適用する

各リファレンスファイルには、次の内容が含まれています。

• ❌ アンチパターンを示す誤った例
• ✅ 最適な実装を示す正しい例
• そのパターンが重要である理由の説明

4. レポートテンプレートを使用する

このスキルが呼び出された場合は、標準化されたレポート形式を使用します。

テンプレート： assets/output-report-template.md

レポート形式には、以下が含まれます。

• 影響評価を含むエグゼクティブサマリー
• 優先順位付けのための重大度レベル（Critical、High、Medium、Low）
• 影響分析（潜在的なバグ、型安全性、保守性、ランタイムエラー）
• 分類（型安全性、安全性、状態管理、戻り値、コード品質）
• references/ の詳細なガイダンスへのリンクを含むパターンの参照
• すべての問題を追跡するためのフェーズ 2 のサマリーテーブル

監査テンプレートを使用する場合：

• /accelint-ts-best-practices <path> からスキルが直接呼び出された場合
• ユーザーが「コード品質をレビューして」または「コードを監査して」と依頼し、1 つ以上のファイルを対象にスキルが暗黙的に呼び出された場合

レポートテンプレートを使用しない場合：

• ユーザーが「この型エラーを修正して」と依頼した場合（直接実装）
• ユーザーが「このコードの何が問題ですか？」と尋ねた場合（質問に回答）
• ユーザーが特定の修正を依頼した場合（正式なレポートは作成せず、直接修正を適用）