用途
javascript-modern 用于在 PHP+JavaScript 的 SaaS 应用中编写、评审和重构现代 JavaScript（ES6+）代码。它面向需要对 JavaScript 任务做出可复用判断、遵循领域约束或执行成熟工作流的场景，而不是提供一次性零散建议。
适用与不适用
适用：任务与现代 JavaScript 模式直接相关，且需要本技能提供的约束、清单或参考材料来支撑执行。 不适用：任务与 javascript-modern 无关，或更适合由更具体的配套技能处理；或仅需一个简单答案，本技能的约束与参考资料没有实质帮助。
主要能力
- 模块模式：IIFE 与 ES Modules 结合，通过闭包维护私有状态，仅暴露公共 API，并提供具名导出用于共享工具。
- 异步模式：async/await 的正确用法与生产级 fetch 封装。
- 语言特性：解构进阶用法、可选链与空值合并、生成器用于分页与懒数据、WeakMap/WeakSet 管理私有数据与 DOM 元数据、Proxy/Reflect 用于校验与响应式。
- 工程实践：错误处理策略、事件委托（性能模式）、防抖与节流、带过期时间的 LocalStorage。
- 架构约束（不可妥协）：JavaScript 必须放在独立的 .js 文件中；PHP 只输出 script 标签，或通过单个 JSON data 属性传递配置，不允许多处 PHP 输出散落在 JS 文件内。
使用方式
- 先阅读 SKILL.md，然后按需仅加载参考文献中的深读文件，避免默认加载全部参考文件。
- 收集相关项目上下文、约束和具体问题；确认期望交付物（设计、代码、评审、迁移方案、审计或文档）。
- 若涉及面向对象的浏览器模块、可复用 UI 组件或复杂有状态工作流，配合 references/javascript-patterns.md；若任务需要更深的 ES 语言机制、异步模式、元编程或性能优化，使用 references/javascript-advanced.md；若涉及 Node/运行时容器工作，配合 docker-development。
- 按技能中有序的指导、清单和判定规则执行，而不是摘取孤立代码片段。
- 产出交付物时，明确说明假设、风险与后续工作。
适用场景
为 PHP 后端项目编写前端 JavaScript、评审已有 JS 代码、重构遗留脚本、制定迁移计划，以及在浏览器端建立可维护的模块架构。技能假定使用者已具备变量、循环和函数的熟练基础。
质量与反模式
输出应面向执行、简洁，并与仓库既有工程标准一致；除非技能明确要求更严格标准，否则保持与现有项目约定兼容；优先可确定、可评审的步骤，而非模糊建议或特定工具魔法。反模式包括：不加检查适配性、约束与失效模式就把示例当作可复制粘贴的真理；默认加载全部参考文件而非使用渐进式披露。
产出证据
技能可产出具体交付物，例如实现指导、评审发现、架构决策、模板或生成产物。示例产物包括：正确性类别的 JavaScript 模块测试计划（Markdown 文档，覆盖异步、生成器、Proxy 与模块边界测试，如 docs/web/js-module-tests.md）。当无法仅凭现有上下文完成任务时，应明确假设、权衡或未解决的缺口；当参考资料、配套技能或后续动作能实质提升执行效果时，一并列出。
限制
本技能的具体许可、收费、价格或平台信息暂未提供。