用途
JavaScript Pro 是一个面向 JavaScript 开发的技能,用于编写、调试和重构 JavaScript 代码。它聚焦于使用 ES2023+ 的现代语言特性、async/await 异步模式、ESM 模块系统以及 Node.js API。
主要能力
该技能覆盖以下使用场景:
- 构建原生(vanilla)JavaScript 应用
- 实现 async/await 模式与 Promise 处理
- 使用现代模块系统(ESM/CJS)
- 优化浏览器性能与内存占用
- 开发 Node.js 后端服务
- 实现 Web Workers、Service Workers 或浏览器 API
使用方式
该技能定义了一套核心工作流程:
- 分析需求 — 检查
package.json、模块系统、Node 版本、浏览器目标;确认.js/.mjs/.cjs约定 - 设计架构 — 规划模块、异步流程与错误处理策略
- 实现 — 使用 ES2023+ 编写代码,采用恰当的模式与优化
- 校验 — 运行 linter(
eslint --fix);若 linter 失败,修复所有报告的问题并重新运行后再继续。使用 DevTools 或--inspect检查内存泄漏,验证打包体积;若发现泄漏,解决后再继续 - 测试 — 使用 Jest 编写全面测试,达到 85%+ 覆盖率;若覆盖率不足,补充缺失用例并重新运行。确认没有未处理的 Promise rejection
该技能还提供按上下文加载的参考指南:
| 主题 | 参考文档 | 加载时机 |
|---|---|---|
| 现代语法 | references/modern-syntax.md |
ES2023+ 特性、可选链、私有字段 |
| 异步模式 | references/async-patterns.md |
Promise、async/await、错误处理、事件循环 |
| 模块 | references/modules.md |
ESM 与 CJS、动态导入、package.json exports |
| 浏览器 API | references/browser-apis.md |
Fetch、Web Workers、Storage、IntersectionObserver |
| Node 核心 | references/node-essentials.md |
fs/promises、streams、EventEmitter、worker threads |
约束规范
必须遵守(MUST DO):
- 仅使用 ES2023+ 特性
- 使用
X | null或X | undefined模式 - 使用可选链(
?.)与空值合并(??) - 所有异步操作使用 async/await
- 新项目使用 ESM(
import/export) - 使用 try/catch 实现正确的错误处理
- 为复杂函数添加 JSDoc 注释
- 遵循函数式编程原则
禁止事项(MUST NOT DO):
- 使用
var(始终使用const或let) - 使用基于回调的模式(优先使用 Promise)
- 在同一模块中混用 CommonJS 与 ESM
- 忽略内存泄漏或性能问题
- 在异步函数中跳过错误处理
- 在 Node.js 中使用同步 I/O
- 修改函数参数
- 在浏览器中创建阻塞操作
关键模式示例
Async/Await 错误处理:
// ✅ Correct — always handle async errors explicitly
async function fetchUser(id) {
try {
const response = await fetch(`/api/users/${id}`);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
return await response.json();
} catch (err) {
console.error("fetchUser failed:", err);
return null;
}
}
// ❌ Incorrect — unhandled rejection, no null guard
async function fetchUser(id) {
const response = await fetch(`/api/users/${id}`);
return response.json();
}
可选链与空值合并:
// ✅ Correct
const city = user?.address?.city ?? "Unknown";
// ❌ Incorrect — throws if address is undefined
const city = user.address.city || "Unknown";
ESM 模块结构:
// ✅ Correct — named exports, no default-only exports for libraries
// utils/math.mjs
export const add = (a, b) => a + b;
export const multiply = (a, b) => a * b;
// consumer.mjs
import { add } from "./utils/math.mjs";
// ❌ Incorrect — mixing require() with ESM
const { add } = require("./utils/math.mjs");
避免 var / 优先 const:
// ✅ Correct
const MAX_RETRIES = 3;
let attempts = 0;
// ❌ Incorrect
var MAX_RETRIES = 3;
var attempts = 0;
输出模板
实现 JavaScript 功能时,应提供:
- 具有清晰导出的模块文件
- 具有全面覆盖的测试文件
- 面向公共 API 的 JSDoc 文档
- 所用模式的简要说明
适用场景与限制
该技能适用于原生 JavaScript 应用开发、异步与 Promise 处理、现代模块系统使用、浏览器性能与内存优化、Node.js 后端服务开发以及 Web Workers、Service Workers 等浏览器 API 实现。其约束要求仅使用 ES2023+ 特性、避免 var 与回调模式、不在同一模块混用 CommonJS 与 ESM、不在 Node.js 中使用同步 I/O。关于收费、价格、平台支持范围等信息,资料中暂未提供。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- jeffallan/claude-skills/skills/javascript-pro/SKILL.md — 署名:Jeffallan;许可:MIT;版本:
3bf9a24b76a7c122f1fc05e83929fbc84e1c207a。