Communitygithub.com

anfrageozmarketing/unslop-audit

对应用进行0-36分评估,覆盖九个维度(身份与访问、引导、核心循环、设置、状态、结构、文案、视觉、组件),列出“AI结构特征”并附带文件证据,输出优先级报告。

unslop-audit 是什么?

这是一个用于审查和评估AI构建的应用质量的技能,主要面向开发者、产品审阅者或质量保证人员。它通过九个维度对应用进行系统性评分(0-36分),每个维度0-4分,从身份验证、引导流程、核心循环、设置功能、状态处理、结构设计、文案质量、视觉设计到组件合理性,逐一评估应用的完整性和“产品意识”。技能会从代码和运行中的应用中收集证据(如路由、API端点、数据库表、环境变量),并特别关注“AI结构特征”——即典型AI生成应用中常见的结构缺陷,例如无路由的单组件、仅存在于环境变量中的设置、缺乏权限检查的API、N+1客户端请求、占位页面等。审阅结果按严重程度排序(阻塞性问题、缺口、粗糙点、打磨项),并生成一个可直接复制粘贴的报告模板,包含评分、发现项、优先级和每个维度的打分理由。该技能旨在帮助团队在早期发现AI应用中的结构性问题,避免“看起来能用但内部混乱”的情况,尤其适合在“检查应用”、“审查产品”或“寻找缺失项”的请求中优先使用,并在改动后重新运行以查看分数变化。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/anfrageozmarketing/unslopUI/tree/HEAD/skills/unslop-audit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

unslop-audit 是做什么的?

过程

  1. 从代码和(如有可能)运行中的应用收集证据:路由、组件、API端点、数据库表、环境变量、compose/proxy配置。
  2. 使用以下评分标准对每个维度进行0-4分评分。每个分数需要附带理由,并引用文件或路由。
  3. 从结构特征中列出特征。每行一个,附上位置。
  4. 对发现项进行排序:阻塞性问题(安全、数据丢失、法律、外部副作用)→ 缺口(整个流程缺失)→ 粗糙点(不一致或不完整)→ 打磨项。
  5. 从底部模板生成报告。

评分标准(0 = 缺失,2 = 可用但薄弱,4 = 精心设计)

维度4分意味着
身份与访问登录、登出、重置、邀请、角色在后台强制实施、数据所有权、速率限制
引导首次运行解释核心循环、收集产品所需信息、以第一次成功结束
核心循环开始、进度、结果、重试、取消、导出都存在且可链接
设置个人资料、团队、通知、集成、数据导出和删除;没有重要的内容仅存在于环境变量中
状态每个屏幕都有空状态、加载状态、错误状态、部分状态、离线状态、无权限状态、限制状态
结构真实的路由、每个实体的深层链接、分页、筛选、一致的导航
文案具体、人性化、无原始错误、无泛泛之词、一致的语气
视觉间距/颜色/字体的象征值、安静的装饰元素、一个有意的主焦点、移动端可用
组件每个屏幕有一个根据数据形态选择的标志性组件;没有默认的表格/KPI卡片/表单;优先读取,编辑操作向下一层

总分 /36。低于14分:原型。14-23分:内部可用。24-31分:可发布。32+分:精心设计。

结构特征(AI构建的应用)

  • 一个800行以上的组件渲染整个产品;没有路由。
  • 身份验证仅在代理配置中或注释掉;API对外开放。
  • 确认文本说“面向所有用户”或数据没有所有者。
  • 设置仅作为环境变量存在,或根本不存在。
  • UI每次刷新都重新获取所有项目(客户端N+1)。
  • “即将推出”、占位页面、死按钮、lorem ipsum、模拟数据显示为真实数据。
  • 错误文本中承诺提供支持,但无联系方式。
  • 状态无解释;同一状态有三种命名方式。
  • 没有404/403/500页面;SPA回退为每个路径显示外壳。
  • 出站邮件或Webhook无预览、测试发送、历史、速率限制或退出选项。
  • 仪表板由虚荣指标卡片组成,背后无任何操作。
  • 屏幕基于默认轮廓构建:标题、一行KPI卡片、带编辑控制的单元格表格、表单(参见unslop-components)。

报告模板

# 审计:<应用> - <日期>
得分:<n>/36 (<等级>)
## 阻塞性问题
- <发现项> - <文件/路由> - <为什么重要> - <最小修复>
## 缺口
## 粗糙点
## 打磨项
## 得分
| 维度 | 分数 | 理由 |
## 未检查

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能