用途:该技能用于在审查或重构 JavaScript 语言模式时,提供符合惯用法的编码约定,帮助维护既有代码。优先级为 P1(HIGH)。
主要能力与约定:命名方面,变量与函数用 camelCase,类用 PascalCase,常量用 UPPER_SNAKE。错误处理方面,只抛出 Error 对象,并处理所有异步错误。注释方面,API 使用 JSDoc,注释解释“为什么”而非“做什么”。文件方面,每个文件只放一个实体,导出统一放在 index.js。模块方面,只使用具名导出,导入顺序为外部依赖、内部模块、相对路径。
反模式:不使用全局变量,状态需封装;不使用魔法数字,改用 const;避免深层嵌套,使用守卫子句或提前返回;不使用默认导出,改用具名导出;避免副作用,保持函数纯粹。
参考与相关:常量、自定义错误、异步模式和模块结构示例见 references/REFERENCE.md。相关主题为 language 与 tooling。当该技能适用时,回答中应保留 Naming、index.js、Comments 等领域术语或等价的具体示例。
限制:资料未提供安装命令、平台支持、收费方式或具体使用步骤,这些信息暂未提供。