JavaScript规范工具(免费版)

--- name: "javascript-skills-tool-free" description: "面向个人开发者的JavaScript代码风格指南,涵盖核心规则与基础代码审查能力。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。" license: Proprietary allowed-tools: read exec compatibility: "Requires LLM with tool-use capability" metadata: displayName: "JavaScript规范工具(免费版)" version: "1.0.0" summary: "面向个人开发者的JavaScript代码风格指南,涵盖核心规则与基础代码审查能力。" tags: - "Development" - "Frontend" - "JavaScript" - "代码规范" source: "SkillHub" converted_at: "2026-07-22T17:58:36" tools: - exec - read - write - browser --- > **功能说明**: 本技能涵盖 中文交互、化工作流场景 等核心能力。 # JavaScript规范工具(免费版) ## 概述 JavaScript规范工具(免费版)面向个人开发者,提供经过提炼的JavaScript代码风格指南。当你在请求中提及 JavaScript 或前端编码相关内容时,本工具会自动激活,为你输出符合业界主流规范的代码、给出风格纠正建议,并解释每条规则背后的原因。 本版本聚焦于日常编码中最常用的核心规则集,适合个人项目、学习场景与快速自查。如需团队级规范、性能优化与自动化集成能力,请升级至 PRO 版本。 ## 核心能力 | 能力 | 说明 | | --- | --- | | 风格规则指导 | 覆盖引用、对象、数组、函数、箭头函数、字符串等核心规则 | | 代码生成 | 输出符合规范的JavaScript代码片段 | | 基础代码审查 | 识别常见风格问题并给出修正建议 | | 命名约定 | 提供camelCase / PascalCase / 常量命名指引 | **技术实现要点**：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。 ### 核心功能执行 用`input_params`参数进行配置。 **输出**: 返回核心功能执行的执行结果,包含操作状态和输出数据。 - 执行此能力时使用`input_params`参数,支持创建/查询/导出操作 ### 参数配置与调用 用`config_options`参数进行配置。 **输出**: 返回参数配置与调用的执行结果,包含操作状态和输出数据。 - 执行此能力时使用`config_options`参数,支持修改/重置/导入操作 ### 结果处理与输出 用`output_format`参数进行配置。 **输出**: 返回结果处理与输出的执行结果,包含操作状态和输出数据。 - 执行此能力时使用`output_format`参数,支持导出/保存/转换操作 **能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：面向个人开发者的、代码风格指南、涵盖核心规则与基、础代码审查能力、规范工具、免费版、为个人开发者提供、基础而实用的、代码风格指导、涵盖对象、字符串等核心语法、提供基础代码审查、与风格纠正建议、输出符合主流规范等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。 ## 使用场景 ### 场景一:个人项目快速编写工具函数 用户希望生成一个深拷贝对象的工具函数,工具会输出符合规范的实现。 ```javascript /** * 深拷贝一个普通对象或数组,优先使用结构化克隆。 * 在不支持 structuredClone 的环境中回退到 JSON 序列化。 * * @param {Object|Array} source - 待克隆的值。 * @returns {Object|Array} source 的深拷贝。 */ function deepClone(source) { if (typeof structuredClone === 'function') { return structuredClone(source); } return JSON.parse(JSON.stringify(source)); } export default deepClone; ``` ### 场景二:代码风格自查与修正 用户粘贴一段使用 `var` 和函数声明的旧代码,工具指出问题并给出符合规范的版本。 ```javascript // 修正前 var count = 1; var items = new Array(); // 修正后 const count = 1; const items = []; ``` ### 场景三:学习ES模块与解构语法 用户询问如何正确使用解构与模块导入,工具给出标准示例。 ```javascript // 对象解构 function getFullName({ firstName, lastName }) { return `${firstName} ${lastName}`; } // 数组解构 const [first, , third] = [1, 2, 3]; // ES 模块 import { fetchData } from './utils'; export default fetchData; ``` ## 不适用场景 以下场景JavaScript规范工具(免费版)不适合处理： - 无明确技术栈的模糊需求 - 纯架构设计决策 - 运维部署管理 ## 触发条件 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求。 ## 快速开始 本工具为基于Markdown指令的Prompt Skill,无需安装额外依赖。 1. 在请求中提及 JavaScript 即可自动激活。 2. 直接描述需求,例如:"写一个处理表单校验的 JavaScript 模块"。 3. 粘贴代码请求审查,例如:"审查这段 JavaScript 代码的风格问题"。 ```text 用户: 如何在 JavaScript 中正确声明变量? 工具: 使用 const 声明不会被重新赋值的引用,使用 let 声明需要重新赋值的引用,避免使用 var。 ``` **结果处理**: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。 ## 示例 ### 基础ESLint配置(个人项目) ```javascript // .eslintrc.js module.exports = { env: { browser: true, es2022: true, }, extends: ['eslint:recommended'], parserOptions: { ecmaVersion: 'latest', sourceType: 'module', }, rules: { 'no-var': 'error', 'prefer-const': 'error', 'eqeqeq': ['error', 'always'], 'no-unused-vars': 'warn', }, }; ``` ### Prettier基础格式化 ```json { "singleQuote": true, "semi": true, "tabWidth": 2, "trailingComma": "all", "printWidth": 80 } ``` ## 优选实践 ### 1. 引用声明 使用 `const` 为主,`let` 为辅,杜绝 `var`。 ```javascript // 推荐 const count = 1; let mutableValue = 1; mutableValue += 1; // 不推荐 var count = 1; ``` ### 2. 对象与数组字面量 使用字面量语法创建对象与数组,避免使用构造函数。 ```javascript // 推荐 const item = {}; const items = []; // 不推荐 const item = new Object(); const items = new Array(); ``` ### 3. 箭头函数 匿名函数优先使用箭头函数,单表达式可省略大括号与 `return`。 ```javascript // 推荐 [1, 2, 3].map((x) => x * 2); [1, 2, 3].map((x) => { const y = x + 1; return x * y; }); ``` ### 4. 字符串 单引号 `''` 用于普通字符串,模板字符串用于插值与多行。 ```javascript // 推荐 const name = 'Alice'; const greeting = `Hello, ${name}!`; ``` ### 5. 解构 访问对象多个属性或函数多返回值时使用解构。 ```javascript // 推荐 function getFullName({ firstName, lastName }) { return `${firstName} ${lastName}`; } const { left, top } = processInput(input); ``` ### 6. 命名约定 | 类型 | 约定 | 示例 | | --- | --- | --- | | 变量与函数 | camelCase | `calculateTotal` | | 类与构造函数 | PascalCase | `class User {}` | | 常量 | UPPERCASE_SNAKE_CASE | `MAX_RETRY_COUNT` | ### 7. 比较运算 使用 `===` 与 `!==`,避免隐式类型转换。 ```javascript // 推荐 if (name !== '') { /* ... */ } if (collection.length > 0) { /* ... */ } // 不推荐 if (name != '') { /* ... */ } ``` ### 8. 模块导入 统一使用 ES 模块,导入语句置于文件顶部。 ```javascript // 推荐 import { longNameA, longNameB, } from 'path/to/module'; export default fetchData; ``` ## 常见问题 ### Q1:免费版支持哪些规则? 免费版涵盖引用、对象、数组、解构、字符串、函数、箭头函数、类与构造函数、模块、命名约定、比较运算、块与控制语句、注释与空白、逗号与分号、类型转换、可选链与空值合并等核心规则集。 ### Q2:免费版是否支持TypeScript? 本工具主要面向 JavaScript 规范,对 TypeScript 提供基础兼容建议,深度 TypeScript 规范请使用 PRO 版本或专用工具。 ### Q3:如何让工具审查我粘贴的代码? 直接在请求中粘贴代码并说明"审查这段 JavaScript 代码的风格问题",工具会逐项给出修正建议。 ### Q4:免费版与PRO版的主要差异? | 维度 | 免费版 | PRO版 | | --- | --- | --- | | 规则覆盖 | 核心规则集 | 全量规则 + 性能优化 + 安全审查 | | 适用对象 | 个人开发者 | 团队与企业 | | 自动化集成 | 基础配置示例 | CI/CD + 预提交钩子 + 自定义规则 | | 异步优选实践 | 基础 async/await | 完整并发模型与错误链路 | | 支持 | 社区支持 | 优先支持 | ### Q5:工具是否会自动修改我的文件? 本工具基于Markdown指令驱动Agent,实际文件修改由Agent执行。工具仅提供建议与代码片段,是否落盘由用户与Agent配置决定。 ## 依赖说明 ### 运行环境 - **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等) - **操作系统**: Windows / macOS / Linux - **Node.js版本**: 建议 18 LTS 及以上(用于运行ESLint/Prettier等配套工具) ### 依赖详情 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:-------|:-----|:---------|:---------| | LLM API | API | 必需 | 由Agent内置LLM提供 | | ESLint | npm包 | 可选 | `npm i -D eslint` | | Prettier | npm包 | 可选 | `npm i -D prettier` | | Node.js | 运行时 | 可选 | nodejs.org 下载 | ### API Key 配置 - 本skill基于Markdown指令规范,无需额外API Key(除内容中明确标注的外部API)。 - 若需对接外部Lint服务,请按对应服务文档配置对应环境变量。 ### 可用性分类 - **分类**: MD+execute(纯Markdown指令,部分功能需exec命令行执行) - **说明**: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。免费版聚焦个人开发场景的核心规则指导。 ## 错误处理 | 错误场景 | 原因 | 处理方式 | |---------|------|---------| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 | ## 已知限制 - 本地运行，不支持多设备同步 ## 安全注意事项 | 风险类型 | 防范措施 | |----------|---------| | API密钥泄露 | 通过环境变量配置，禁止硬编码到代码或配置文件中 | | 命令执行风险 | 仅执行白名单命令，避免拼接用户输入到命令行参数中 | | 网络通信安全 | 使用HTTPS协议，验证SSL证书有效性 | | 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 | 使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。 ## 效率量化分析 | 操作场景 | 手动耗时 | 自动化耗时 | 效率提升 | |----------|---------|-----------|---------| | 文件解析与提取 | 5-10分钟/个 | <5秒/个 | 60-120x | | 批量文件处理(100个) | 8-16小时 | <5分钟 | 96-192x | | API调用与响应解析 | 2-3分钟/次 | <1秒/次 | 120-180x | | 多接口数据聚合 | 15-30分钟 | <10秒 | 90-180x | | 命令执行与结果收集 | 3-5分钟/次 | <2秒/次 | 90-150x | | 重复任务批量执行 | 因任务而异 | 线性缩减 | 5-50x | | 错误排查与修复 | 10-30分钟 | <30秒 | 20-60x | ## 差异化对比 | 对比维度 | 本技能 | 传统手动方式 | 通用脚本工具 | |---------|------------|-------------|------------| | 自动化程度 | 全流程自动 | 完全手动 | 部分自动 | | 错误处理 | 内置错误恢复 | 依赖人工经验 | 基本try-catch | | 可复用性 | 参数化配置 | 一次性脚本 | 模板化 | | 安全合规 | 内置安全检查 | 无安全保障 | 无安全保障 | | 适用场景 | 核心功能 | 通用场景 | 通用场景 |

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

相关资产