Web 界面指南审查技能
自动审查 UI 代码是否符合 Web 界面指南,提升可访问性与最佳实践。
该技能要求每次评审时从外部URL获取最新指南,可能引入不可信内容,且未提供用户确认或权限隔离。它为读取文件和网络请求申请权限,但未明确最小权限原则或对敏感数据的处理。评分8分,扣除17分:未披露数据流、未提供回滚或隔离、来源不可验证(外部获取的规则不可审计)。
技能指令自我一致性低:指南获取步骤描述模糊(如'获取最新指南'),且对网络不可用或文件不存在等异常缺少错误处理。静态审查无法执行关键路径,且未提供测试证据。评分2分,扣除8分:未提供可复现的测试或故障诊断机制,失败反馈不明确。
技能场景明确:审查UI代码,但触发条件可能与实际能力不匹配(需要外部网络和特定工具)。非适应范围未声明,且未考虑中国大陆网络可达性(依赖raw.githubusercontent.com,可能不可达)。评分5分,扣除10分:边界定义不清晰,环境适配证据不足。
文档简短,未提供安装/依赖说明、版本更新日志、维护责任或已知限制。元数据提供了版本和作者,但缺少变更历史和来源验证。评分3分,扣除12分:缺乏分层文档、示例和故障排查指南。
无法验证技能是否能完成用户任务:依赖外部获取的指南格式,且输出格式未被本文件明确。静态审查无法测试,且未提供示例。评分1分,扣除14分:价值主张无法验证,输出直接可用性证据不足。
无测试或第三方执行证据。所有关键声明(如获取指南、应用规则)均基于作者描述,无法独立验证。评分1分,扣除9分:缺乏可审计的测试结果或交叉验证。
- 该技能依赖从raw.githubusercontent.com获取外部内容,在中国大陆可能无法访问,建议使用镜像或预置规则。
- 技能未提供用户确认机制,执行时可能自动读取文件和网络请求,需谨慎使用。
- 外部获取的指南内容不可审计,可能包含恶意或不准确指令,建议审查其来源。
这个 Skill 能做什么,适合哪些场景?
该技能用于审查 UI 代码是否符合 Web 界面指南。它从指定 URL 获取最新指南,读取用户指定的文件,将规则应用于代码,并以简洁的 `file:line` 格式输出发现的问题。集成在 Multica 平台中,作为其可复用技能集合的一部分,支持代码审查和设计审计工作流。
获取最新版 Web 界面指南(来源:vercel-labs/web-interface-guidelines 的 command.md);读取用户指定的文件或目录;逐条对照指南中的规则检查代码;以 file:line 格式报告不符合项;无文件参数时提示用户输入文件或模式。
- 前端开发者想快速检查当前 UI 代码是否符合最新的 Web 可访问性最佳实践。
- 设计系统维护者希望在合并前审查组件库代码的规范符合性。
- QA 工程师在发布前对页面进行设计审计,发现潜在的可访问性问题。
- 技术负责人使用该技能将设计规范检查自动化,集成到代码审查流程中。
- 开发者收到“检查我的 UI”或“审查 UX”的请求时,可调用此技能快速给出结构化反馈。
这个 Skill 有哪些优点和局限?
- 自动获取最新指南,确保审查基于最新规则。
- 输出格式简洁,便于集成到 CI/CD 或代码审查工具中。
- 支持通过文件或模式灵活指定审查范围。
- 作为 Multica 技能集合的一部分,与其他技能协同工作。
- 依赖外部 URL,如果网络不可用或 URL 失效,技能无法工作。
- 没有内置测试套件,错误处理能力未知。
- 仅提供 `file:line` 输出,可能缺少详细的修复建议。
- 未明确支持特定框架或语言,可能对非 Web 代码无效。
- 技能描述中引用的作者为 vercel,但实际维护情况不明确。
如何安装这个 Skill?
该技能位于 Multica 仓库的 .agents/skills/web-design-guidelines/ 目录。安装 Multica 平台后,技能默认包含在集合中。具体独立安装步骤未在源文档中说明。
如何使用这个 Skill?
调用技能时,提供要审查的文件或模式参数,例如“审查 src/components/Button.tsx”。技能会先获取最新指南,然后读取指定文件,应用规则,并输出 file:line 格式的发现。如果未提供文件,技能会询问用户要审查哪些文件。