make-interfaces-feel-better 教程：先做只报告审查
这个仓库不是前端组件库，也没有运行时服务。它是一套给编码代理阅读的 Markdown/YAML 规则，重点检查圆角、光学对齐、阴影、排版、图标、点击区域、动画和性能。真正的文件读写与浏览器操作由宿主代理完成。
35545ea，需要可重现结果时应固定提交。1. 安装前先读规则
入口 SKILL.md 会引用 typography、surfaces、animations、icons 和 performance 五份文档。先确认它没有超出团队设计系统，也没有要求不合适的固定动画或尺寸。官方 AGENTS.md 说明仓库没有构建、lint 或测试工具。
2. 分清技能与宿主权限
技能文件本身不保存凭据，也不监听端口。安装命令会通过 npx skills CLI 从 GitHub 下载内容；安装后，能否读代码、改文件、运行命令或操控浏览器，完全取决于宿主代理。评估时要记录这些权限。
npx skills add jakubkrehel/make-interfaces-feel-better
3. 第一次使用 quick 模式
选一个可回滚组件，只要求报告，不授权修改。quick 模式聚焦主要路径，只列最多 5 条 HIGH 或 MEDIUM 问题。报告应包含文件与行号、修改前后、原因、考虑但未采用的方案，以及没有执行的验证。
4. 核对一条建议
确认建议沿用项目现有 Tailwind、CSS 或 CSS-in-JS，不应为了润色引入第二套样式系统。随后只改一处，在浏览器中走完 hover、focus、active、loading 与 empty 状态。涉及动画时还要看 10% 慢速和 reduced-motion。
5. 明确它不覆盖的内容
官方范围不扩展成完整的可访问性、布局、色彩系统或 UX 文案审计。44×44 点击区、动画时长和固定比例是候选规则，仍需结合桌面密度、语义、设计 token 与用户测试。
与 Vercel Web Interface Guidelines 对比
Vercel 的 Web Interface Guidelines 覆盖可访问性、表单、导航、国际化、性能、内容和常见反模式，范围更广。make-interfaces-feel-better 更集中于圆角、光学对齐、阴影、图标和动画等细节，并规定 quick/full 的证据输出。发布前广审可用 Vercel 指南，局部润色复核再用本技能。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合在已有前端项目中检查交互细节、动画、排版、图标和表面层级。它不是完整的可访问性、布局、色彩系统或 UX 文案审计，也不能凭文字规则证明界面真的顺滑；动画仍需在真实浏览器和 reduced-motion 设置下检查。
采用建议
实际使用应先读固定提交、以只报告的 quick 模式验证，再让宿主代理做可回滚的小改；它负责界面细节，不能替代完整质量与可访问性检查。
原教程未展开的系统信息
核心功能
界面细节规则
覆盖同心圆角、光学对齐、阴影、文字换行、图标粗细、点击区域和克制动画。
quick 与 full 审查
quick 聚焦主要路径并限制 5 条中高问题；full 默认覆盖五类内容并限制 15 条。
证据化输出
要求给出文件和行号、修改前后、原因、未采纳候选、实际验证及最终 verdict。
技术栈和运行条件
语言
Markdown/YAML 文档
框架
Agent Skills 目录约定
关键依赖
- Node.js/npx 仅用于 skills CLI 安装
- 支持技能的编码代理
- 待审查前端项目与其现有样式系统
运行环境
技能自身没有端口、凭据或后端；安装会下载 GitHub 内容，后续读写和浏览器能力完全取决于宿主代理
核验与使用边界
优势与限制
优势
- 规则具体且包含适用边界
- 要求沿用现有样式体系
- 审查结果带位置、证据和 verdict
限制
- 没有版本 Release，main 内容会变化
- 安装命令依赖外部 npx skills CLI 与网络
- 技能的实际读写能力继承宿主代理
排错时先核对版本、运行环境和未覆盖范围。这里没有执行过的步骤不会写成实测结论。
常见问题
make-interfaces-feel-better 有正式版本号吗？
没有。截至 2026-09-23，官方 Releases 页面没有正式发行版；安装前应阅读 main，重现性要求高时固定提交 35545ea。
这个技能安装后会运行自己的程序吗？
仓库本身只有 Markdown/YAML，没有构建、测试或运行时服务；npx skills 负责下载和安装，之后的文件与浏览器操作由宿主代理执行。
quick 模式和 full 模式有什么区别？
quick 只看主要路径并最多报告 5 条 HIGH/MEDIUM 问题；full 是默认模式，覆盖五类细节并最多报告 15 条，LOW 问题只在 full 出现。
这个技能能代替可访问性审计吗？
不能。官方范围明确不扩展成完整可访问性、布局、色彩系统或 UX 文案审计；键盘、读屏、对比度和真实用户测试仍需单独完成。