Agent Skills
返回列表
JavaScript 风格指南

JavaScript 风格指南

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/javascript-skills。

技能介绍

要解决什么问题

在 JavaScript 项目里,const/let、箭头函数、模块导入顺序、分号与尾随逗号等细节往往各写各的,评审时大量时间花在「风格争议」而非逻辑与边界条件。人工背一套 Airbnb 式规范又容易漏项,模型生成的代码也常混用 var、隐式分号省略或 ==。

技能如何工作

这是基于自然语言触发的 Prompt-based Skill:请求里出现或与 JavaScript 相关的意图时,会按 SKILL 内置的 Complete Style Rules(引用与对象字面量、解构、函数与箭头函数、类与 ES 模块、异步 async/await、可选链 ?. 与空值合并 ?? 等 28 类规则)作答。

典型能力包括:

  • 风格问答:说明为何用命名函数表达式而非函数声明、为何默认参数放末尾等。
  • 合规代码生成:例如深拷贝工具函数会避免 var、优先展开运算符,并带分号与命名约定。
  • 代码评审视角:对照规则指出与规范不一致的写法。

你也可直接追问某一章(如 Promises、Naming、Whitespace)的细则。

适用边界与注意点

规则面向现代 ES 语法与模块体系;文中明确 暂不建议在面向 ES5 的环境使用 generator。它约束的是代码风格与一致性,不替代类型系统(TypeScript)、测试策略或安全审计。Wild import、getter/setter 滥用等也在规范里被明确不推荐——生成结果会偏向「可维护、可预测」而非最短行数。

使用场景

  • 新仓库要从零写工具函数,希望生成代码统一用 const、模板字符串和展开运算符
  • Code Review 前让助手按规范标出 var、== 和不合理的嵌套三元表达式
  • 遗留回调改 Promise 时,需要按规范写成 async/await 并处理 try/catch
  • 多人协作的 npm 包要统一 import 顺序、命名(camelCase/PascalCase)和尾随逗号

适合人员

  • 负责前端基建、要在 PR 里统一 JS 写法的高级工程师
  • 维护内部 npm 工具库、需要对外导出命名与模块风格一致的维护者
  • 带实习生写业务脚本、希望模型输出可直接纳入 ESLint 文化 코드的 Tech Lead
  • 从 jQuery 迁到模块化写法、需对照 ES 模块与箭头函数规范的迁移开发者