javascript-practices
JavaScript 和 TypeScript 关于语法、模块、类型和运行时行为的约定。在编写或审查 JS/TS 代码、实现模块、处理类型或使用运行时 API 时使用。
📖 中文导读:JavaScript 和 TypeScript 关于语法、模块、类型和运行时行为的约定。在编写或审查 JS/TS 代码、实现模块、处理类型或使用运行时 API 时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: javascript-practices description: JS/TS conventions for syntax, modules, and types. Use when writing or reviewing JavaScript/TypeScript code.
JavaScript/TypeScript Practices
Conventions for JS/TS syntax, modules, types, and runtime behavior.
Quick Start
import * as path from "@std/path"; // namespace import
import { utils } from "./utils.ts"; // explicit extension
export function buildConfig() {} // direct named export
const port = config.port ?? 8000; // nullish coalescing
Key Principles
Modules: Direct named exports, namespace imports, explicit .ts extensions
Syntax: const over let, always semicolons, === strict equality, ??
over ||
Types: Number() over +, instanceof over typeof, prefer null over
undefined
Runtime: import.meta.dirname, globalThis over window, optional
projectRoot params
Async: Use return await consistently for better stack traces and correct
error handling
Avoid: eval, prototype mutation, truthy/falsy checks on non-booleans
References
See rules.md for complete guidelines with examples.