Agent skill · software engineering · affaan-m
coding-standards
TypeScript、JavaScript、React、Node.js開発のための汎用コーディング標準、ベストプラクティス、パターン。
Why this skill is useful
Codifies best practices for TypeScript, JavaScript, and React development that the AI could infer but now doesn't have to guess.
What it needs
About 5k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
コーディング標準とベストプラクティス すべてのプロジェクトに適用される汎用的なコーディング標準。 コード品質の原則 1. 可読性優先 コードは書くよりも読まれることが多い 明確な変数名と関数名 コメントよりも自己文書化コードを優先 一貫したフォーマット 2. KISS (Keep It Simple, Stupid) 機能する最もシンプルなソリューションを採用 過剰設計を避ける 早すぎる最適化を避ける 理解しやすさ > 巧妙なコード 3. DRY (Don't Repeat Yourself) 共通ロジックを関数に抽出 再利用可能なコンポーネントを作成 ユーティリティ関数をモジュール間で共有 コピー&ペーストプログラミングを避ける 4. YAGNI (You Aren't Gonna Need It) 必要ない機能を事前に構築しない 推測的な一般化を避ける 必要なときのみ複雑さを追加 シンプルに始めて、必要に応じてリファクタリング TypeScript/JavaScript標準 変数の命名 関数の命名 不変性パターン（重要） エラーハンドリング Async/Awaitベストプラクティス 型安全性 Reactベストプラクティス コンポーネント構造 カスタムフック 状態管理 条件付きレンダリング API設計標準 REST API規約 レスポンス形式 入力検証 ファイル構成 プロジェクト構造 ファイル命名 コメントとドキュメント コメントを追加するタイミング パブリックAPIのJSDoc typescript const results = await searchMarkets('election', 5) console.log(results[0].name) // "Trump vs Biden" ` パフォーマンスベストプラクティス メモ化 遅延読み込み データベースクエリ テスト標準 テスト構造（AAAパターン） テストの命名 コードスメルの検出 以下のアンチパターンに注意してください。 1. 長い関数 2. 深いネスト 3. マジックナンバー 覚えておいてください: コード品質は妥協できません。明確で保守可能なコードにより、迅速な開発と自信を持ったリファクタリングが可能になります。
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/coding-standards--0ab837