UI Refine

用于改进已有产品界面信息组织、视觉层级与交互一致性的 Agent Skill。

An agent skill for refining information hierarchy and interaction consistency in existing product interfaces.

下载 v0.1.0 · 所有版本 · 技能正文 · 变更记录

适用场景

• 页面信息主次不清，需要根据用户任务重新组织。
• 多个页面的同类信息和操作缺乏一致性。
• 一行包含导航、选择、复制等多个动作，容易误触。

**边界：**面向已有产品，沿用项目实际设计规范和组件体系；不默认从零建立品牌或完整设计系统，不凭界面外观改写业务含义。

安装

下载完整技能

1. 下载上面的 ZIP 安装包并解压，得到 ui-refine/ 文件夹。
2. 将整个文件夹放入你的 Agent 客户端支持的技能目录。
3. 按客户端要求刷新技能列表或重新启动，确认出现 ui-refine。

保留文件夹内全部文件，尤其是相对引用的参考资源和 LICENSE。若使用 GitHub 的 Source code ZIP，解压后将仓库文件夹改名为 ui-refine；安装目录名与技能内部名称保持一致。

使用 Git

在你选择的技能父目录中执行以下命令；若目标目录已存在，先检查本地修改，不要直接覆盖。

git clone --branch v0.1.0 --depth 1 https://github.com/ChanMo/skill-ui-refine.git ui-refine

客户端适配

技能采用 SKILL.md 与 YAML 元数据组织，面向支持 Agent Skills 的客户端。安装位置、技能选择方式和可用工具取决于客户端；此项目不提供模型或工具运行时。

• Codex：当前官方文档列出个人目录 ~/.agents/skills 和项目目录 .agents/skills；部分已有环境使用 ~/.codex/skills。选择当前环境实际识别的一处，避免重复安装。参见官方技能说明。CLI/IDE 可用 $ui-refine 显式调用。
• 其他 Agent 客户端：按其技能文档选择安装目录与调用方式。尚未进行逐客户端运行验证，不承诺所有客户端直接兼容。

使用示例

先通过客户端选择本技能，再描述目标和范围；下面也可作为自然语言提示。

使用 ui-refine：改进这个列表页的信息层级和行内操作，沿用现有设计规范。

使用 ui-refine：检查这两个页面的交互一致性，保留业务任务造成的合理布局差异。

文件与能力要求

• SKILL.md
• references/interaction-review.md

技能本身以指令为主，无需安装专用运行时或第三方库。实际任务可能需要项目文件访问、搜索、浏览器或测试工具；缺少这些能力时，应报告相应验证限制。

验证范围

首版完成文件结构、元数据、相对引用和下载包完整性检查。核心内容源自维护者的本地技能；尚未开展独立的跨模型、跨客户端行为评估。

修改规则时，建议用真实任务检查以下行为，记录客户端、模型、技能版本及实际结果：

• 小型样式修改不会扩展成全站重构。
• 行内子操作、文本选择和父级导航不会互相误触。
• 空结果、加载失败和缺失数据按实际业务语义区分。

这些是维护验证场景，不是已通过的跨客户端测试结果。技能指导模型决策，不保证每次输出完全一致。

更新与维护

• 本仓库是该技能的源码维护入口，安装副本不自动更新。
• 更新前保留本地定制，对照变更记录，再用完整新版本替换该技能目录；回退时使用旧版本安装包。
• 三个技能独立版本化，不需要一起升级。main 用于日常迭代，稳定版本通过 tag 与 Release 分发。
• 提交反馈时说明技能版本、客户端和模型、最小复现场景、预期及实际行为，去除项目私密内容。
• 修改应保持技能适用边界；行为变化同时更新变更记录。保持 SKILL.md 为唯一执行规则来源。

维护者创建新 tag 后，可从对应版本生成安装包（替换版本号）：

mkdir -p dist
git archive --format=zip --prefix=ui-refine/ --output=dist/ui-refine-v0.1.0.zip v0.1.0

相关技能

• Discuss：用于问题分析、需求澄清与方案取舍的 Agent Skill。
• Code Slim：用于减少代码复杂度、清晰化执行路径，并默认保持现有行为的 Agent Skill。

许可证

MIT © 2026 ChanMo。复制与分发时保留许可及版权声明。