SuperAPI AI 工具集

google-javascript-best-practices

编程与开发

查看项目

更新于 10-16 05:51

技能介绍

该技能基于 Google 官方 JavaScript 风格指南,面向 AI 智能体与大语言模型,汇总 47 条规则,分为 8 个类别并按影响程度排序,用于辅助自动化重构和代码生成。

适用场景包括:编写新的 JavaScript 或 ES6+ 代码;组织模块与管理导入导出;添加 JSDoc 类型注解和文档;检查命名与风格一致性;重构既有 JavaScript 代码。

规则类别按优先级如下:模块系统与导入(CRITICAL,module-);语言特性(CRITICAL,lang-);类型安全与 JSDoc(HIGH,type-);命名规范(HIGH,naming-);控制流与错误处理(MEDIUM-HIGH,control-);函数与参数(MEDIUM,func-);对象与数组(MEDIUM,data-);格式与风格(LOW,format-)。

各类别示例规则:模块系统要求避免循环依赖、导入路径包含 .js 扩展名、优先具名导出、不重复导入、不改别名、遵循标准文件结构;语言特性要求默认用 const、用 class 而不是原型操作、使用显式分号、禁用 eval、不修改内置原型、只用标准 ECMAScript 特性、不用原始包装对象、不用 with 语句;类型安全要求类型转换加括号、枚举加静态字面值注解、显式可空修饰符、导出函数需 JSDoc、指定模板参数、复杂对象用 typedef;命名规范要求常量用 CONSTANT_CASE、重描述轻简略、文件名小写加连字符或下划线、方法与变量用 lowerCamelCase、标识符避免美元前缀、类用 UpperCamelCase;控制流要求记录空 catch、优先 for-of、用严格相等、switch 含 default、抛 Error 对象;函数要求嵌套函数用箭头函数、箭头参数加括号、用默认参数、用剩余参数、用展开代替 apply;对象与数组要求用字面量而非构造函数、用解构、不混用引号与非引号键、用展开代替 concat 和 slice、多行字面量加尾随逗号;格式要求控制结构必须加花括号、行宽限 80 字符、每行一条语句、字符串用单引号、两空格缩进。

使用方式:可安装为 AI 智能体技能,并阅读各参考文件了解详细解释与代码示例;提供完整编译指南 AGENTS.md,以及 _sections.md、_template.md、metadata.json 等参考文件。详细安装命令与具体价格暂未提供。