Agent skill · software engineering · affaan-m
coding-standards
Universal coding standards, best practices, and patterns for TypeScript, JavaScript, React, and Node.js development.
Why this skill is useful
Codifies specific naming conventions and best practices for TypeScript, JavaScript, React, and Node.js development that the AI could infer but 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（保持簡單） 使用最簡單的解決方案 避免過度工程 不做過早優化 易於理解 > 聰明的程式碼 3. DRY（不重複自己） 將共用邏輯提取為函式 建立可重用的元件 在模組間共享工具函式 避免複製貼上程式設計 4. YAGNI（你不會需要它） 在需要之前不要建置功能 避免推測性的通用化 只在需要時增加複雜度 從簡單開始，需要時再重構 TypeScript/JavaScript 標準 變數命名 函式命名 不可變性模式（關鍵） 錯誤處理 Async/Await 最佳實務 型別安全 React 最佳實務 元件結構 自訂 Hooks 狀態管理 條件渲染 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--0b202b