用途:在已进入显式 UI 规划、实现或验证路径,宿主全局模式下的 UI 任务,或已初始化项目涉及整页新建、跨组件视觉重做、设计系统改造、需要截图验收时使用。标准模式且项目未初始化时的普通 UI 请求,以及修复 bug、调整文案、改业务逻辑等不涉及视觉变更的任务,不读取本技能。
主要能力:按优先级执行设计契约,依次为当前活跃方案包 plan.md 或 PRD 中已确认的 UI 决策、.helloagents/DESIGN.md、本技能的具体 UI 审美与实现规则;缺少上层产物时才依赖下层规则。处理可选 UI 契约:启用 ui.styleAdvisor 时复用当前会话 artifacts/advisor.json 记录设计方向复查证据,启用 ui.visualValidation 时用当前会话 artifacts/visual.json 记录视觉验收证据。将设计映射到代码结构,明确 token 落点、组件边界、状态矩阵、主题适配与验收证据。做视觉验收闭环,优先用截图或浏览器工具检查桌面与移动端,无工具时做结构化视觉自检,并按 scripts/visual-state.mjs write 写 visual.json。只把跨 feature 稳定成立的设计系统规则同步回 DESIGN.md。
使用方式:进入真实 UI 任务先读取 .helloagents/DESIGN.md;已通过方案包或 PRD 确认设计方向的按确认方向执行。整页新建、设计系统改造或跨多组件视觉重做且 DESIGN.md 不存在时,先按 templates/DESIGN.md 创建最小设计契约,再继续大规模实现。编码前明确设计简报,包括目的、美学方向、记忆点、设计 token、约束与真实内容。实现前明确 token 落点、组件边界、状态矩阵、主题与适配、验收证据。
限制:本技能不是 UI 质量的唯一来源,已加载的 HelloAGENTS UI 质量基线负责基础水准。.helloagents/ 按项目级存储路径理解,会话证据使用当前 state_path 所在目录下的 artifacts/*.json;若 project_store_mode=repo-shared,DESIGN.md 与方案包按当前上下文中已注入的项目知识或方案目录解析。不得用通用审美覆盖已确认的项目契约。其余平台、价格与效果信息暂未提供。