用途:这是一套跨项目的通用编码规范技能,适用于 TypeScript、JavaScript、React 和 Node.js。在代码质量与可维护性审查、按约定重构既有代码、统一命名/格式/结构、以及配置 lint、格式化或类型检查规则时启用。涉及具体框架的任务应改用对应专用技能,如 React 用 skill: react-patterns(组件、Hooks、Zustand、性能、反模式),Vue 3 用 skill: vue-patterns(Composition API、Pinia、composables、性能、反模式);本技能专注框架无关的标准:命名、类型、错误处理、文件组织、API 设计。
主要能力与原则:核心质量原则为可读性优先、KISS(保持简单、避免过度工程与过早优化)、DRY(抽取公共逻辑、复用组件与工具、避免复制粘贴)、YAGNI(不提前构建功能、避免推测性泛化)。
具体规范:变量用描述性命名(如 marketSearchQuery、isUserAuthenticated);函数采用动词-名词模式(如 fetchMarketData、isValidEmail);使用不可变模式,通过展开运算符生成新对象/数组,不直接修改;错误处理要完整,检查 response.ok 并抛出含状态信息的错误;异步尽量用 Promise.all 并行;类型安全避免使用 any,接口用联合类型描述有限状态。文件组织给出 src 目录结构示例(app、components、hooks、lib、types、styles),文件命名组件用 PascalCase,hooks 用 camelCase 且以 use 前缀,工具与类型文件用 camelCase。注释应解释 WHY 而非 WHAT。
参考文件:references/api-design.md(设计 REST API、响应格式、校验时阅读),references/testing.md(编写测试、识别反模式时阅读)。
限制:资料未提供安装命令、具体配置示例、平台与价格信息,暂未提供。