JavaScript

核心用法

本 Skill 是一套纯 Markdown 文档形式的 JavaScript 编程指南，无代码执行能力，定位为开发者的随身技术参考手册。用户通过自然语言描述问题场景（如 "Promise 未正确处理拒绝"、"NaN 意外出现"、"时区偏移一天"），Skill 会匹配对应的知识模块（async.md、coercion.md、dates.md 等）输出诊断建议与修复代码。

关键使用路径：

• 调试场景：类型错误、异步 bug、内存增长 → 调用 debug.md/memory-leaks.md/async.md
• 代码评审：检查是否符合 === 强制规则、现代 ES2023+ API 兼容性、异常处理规范 → 参考 modern.md/errors.md
• 架构决策：Object/Map/Set 选型、错误处理形态（异常 vs 返回值）、并发策略 → 查阅 collections.md/performance.md
• 配置个性化：首次使用通过 setup.md 初始化，在 ~/Clawic/data/javascript/config.yaml 中设定 runtime_target（node/browser/both）、node_floor（Node 版本基线）、module_system（ESM/CJS/dual）等变量，使后续建议自动适配目标环境

显著优点

1. 权威深度覆盖：由 Clawic 平台维护，内容经过专业打磨，涵盖从基础陷阱（[object Object]、0.1+0.2）到高阶主题（事件循环微任务饥饿、Intl.Segmenter Unicode 处理、结构化克隆）的完整知识体系。

2. 场景化速查：通过 "When To Use" 表格实现问题到文档的秒级映射，开发者无需记忆文件名，只需描述症状即可获得精准指引。

3. 版本感知建议：内置 node_floor 与 browser_floor 机制，自动 gate 高于目标运行时的 API 建议（如 toSorted 在 Node 18 会崩溃），避免"构建通过、运行失败"的隐蔽风险。

4. 安全零负担：纯文档型 Skill，无可执行代码、无网络调用、无第三方依赖，通过 CLS-Certify S 级认证，企业内网环境可放心启用。

5. 可演进的知识库：支持用户偏好持久化（config.yaml + memory-template.md），随着项目技术栈变化持续调优建议策略。

潜在缺点与局限性

1. 非交互式调试：无法直接连接运行时获取堆快照、无法注入探针，诊断输出依赖开发者手动复现与验证。对于复杂 Heisenbug，仍需配合 DevTools/Node Inspector。

2. 框架无关设计：明确声明 "Not for framework internals"，React/Vue/Angular 的组件生命周期、虚拟 DOM 差异不在覆盖范围，需搭配对应框架 Skill 使用。

3. TypeScript 边界：不涉及类型系统设计（泛型约束、条件类型、类型体操），仅处理运行时的 JavaScript 语义。TS 开发者需额外安装 typescript Skill。

4. 静态知识延迟：ES2024+ 新特性需等待版本更新，无法实时追踪 TC39 提案动态。

5. 中文场景局限：国际化内容（localeCompare、Intl API）以英文语境为主，中文排序、农历处理等需额外补充。

适合的目标群体

• 中高级 JavaScript 开发者：已熟悉基础语法，需要系统性规避语言陷阱、掌握现代 idioms
• 全栈工程师：在 Node 与浏览器环境切换，需要双端边缘案例指南
• 代码评审者：需要统一的评审标准输出（如强制 ===、禁止 throw "string"、检测 forEach(async 反模式）
• 技术团队 Lead：建立团队 JavaScript 规范，通过 config.yaml 固化项目基线与工具链偏好
• 面试备考生：深度理解事件循环、闭包、强制转换等高频考点背后的规范细节

使用风险

• 性能误读风险：Skill 提供的性能建议（如 "Chunk batch work with awaited yield"）为通用模式，实际效果受 Node 版本、V8 优化状态、负载特征影响，生产环境优化应以 perf_hooks 实测为准。
• 配置漂移风险：node_floor 默认从 package.json 读取，若项目未声明 engines 字段，可能默认采用 Node 22 特性建议，导致旧环境运行时错误。
• 安全幻觉风险：Skill 本身 S 级安全，但输出的代码建议（如 structuredClone）需开发者自行评估在目标环境的兼容性，不可因 "Skill 推荐" 而盲目信任。
• 知识过载风险：17 个文档模块 875 行密集知识，新手可能陷入细节而忽视整体架构，建议配合 nodejs/react 等框架 Skill 分层使用。