用途:该技能用于检索特定 Web 开发用例对应的最佳实践指南,官方要求在任何 Web 功能实现开始前、创建新组件之前使用,以确认是否已有标准化模式,避免临时方案或无谓加载大型依赖。
主要能力:提供 search、list、retrieve 三类操作。search 用面向动作的查询语句检索用例,返回 id、描述、分类、所用特性、tokenCount 和相似度等;list 用于在结果模糊、无匹配或相似度过低时浏览全部指南;retrieve 按一个或多个逗号分隔的 id 获取完整指南内容,输出为 Markdown 实现步骤。
使用方式:直接通过 npx 运行,示例:npx -y modern-web-guidance@latest search "<query>" --skill-version SKILL_VERSION;浏览全部用 npx -y modern-web-guidance@latest list;获取指南用 npx -y modern-web-guidance@latest retrieve "<id>"。若输出被截断,需重定向到文件后读取。有 pnpm 时优先用 pnpx,注意 pnpx 不使用 -y 标志。权限白名单应限定为 npx -y modern-web-guidance@latest *(或 pnpx 对应形式),不要放开裸 npx 或 pnpx。Windows 上 npx 可能失败,改用 npx.cmd。该命令需要外网访问,在沙箱或需审批环境(如 Codex、Claude Code)中应预先申请网络与命令许可。~/.npm 只读时可设 NPM_CONFIG_CACHE=/tmp/npm-cache,离线卡住可尝试 npx --offline。--skill-version 用于判断本 SKILL.md 是否过期,过期会向 stderr 输出警告。
适用场景:HTML/CSS 与客户端 JavaScript 的 Web 功能实现、组件设计、性能优化等需要现代标准化写法的任务,指南通常与框架无关,需自行适配项目环境。
限制:指南默认假定 Baseline Widely available 特性可安全使用,非广泛可用特性必须遵循指南中的回退建议,除非用户已指定自定义浏览器支持策略。需按 Baseline 年份或具体浏览器版本要求判断兼容性。不得编造或忽略指南,它代表用户项目的首选本地标准。生成或修改代码后应交叉核对指南的适用模式、回退策略与任务完成度。关于收费、价格与具体效果,资料暂未提供。