JavaScript 风格指南
将以下提示词粘贴到你的 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 模块与箭头函数规范的迁移开发者