Communitygithub.com

anfrageozmarketing/unslop-audit

為應用程式進行 0-36 分的全面審計,涵蓋九個維度(身份、入職、核心循環、設定、狀態、結構、文案、視覺、元件),列出「AI 結構跡象」及檔案證據,並生成優先級報告。

unslop-audit 是什麼?

此技能旨在對軟體專案進行結構化審計,特別針對由 AI 輔助生成的應用程式,評估其成熟度與設計品質。它從程式碼及運行的應用程式中蒐集證據(包括路由、元件、API 端點、資料庫表格、環境變數、容器配置),並根據九個維度的評分標準(每個維度 0-4 分)進行打分,總分 36 分。除了評分,技能還會識別出常見的「AI 結構跡象」(如單一巨型元件、缺少驗證、虛假佔位內容),並根據嚴重程度將發現的問題排序為封鎖者、缺口、粗糙、打磨等層級。最終生成一份包含封鎖事項、缺口、粗糙點、打磨點及分數明細的優先級報告,協助開發者明確改進方向。支援 Claude Code、Cursor、Codex 等開發工具平台,適合在任何「檢查應用程式」、「審查此產品」或「缺少什麼」的請求上首次使用,並可在變更後再次執行以顯示分數變化。

相容平台~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 分的定義
身分與存取登入、登出、重設、邀請、後端強制角色、資料所有權、速率限制
入職首次運行解釋循環、收集產品所需的資訊、以首次成功結束
核心循環開始、進度、結果、重試、取消、匯出都存在且可連結
設定個人資料、團隊、通知、整合、資料匯出與刪除;重要事項不應僅存在於環境變數中
狀態每個畫面都有空白、載入、錯誤、部分資料、離線、無權限、限制狀態
結構真實路由、每個實體的深層連結、分頁、篩選器、一致的導航
文案具體、人性化、無原始錯誤訊息、無空洞用語、統一語氣
視覺使用間距/色彩/排版令牌、低調的 chrome、一個刻意突出的焦點元素、支援行動裝置
元件每個畫面都有一個根據其資料形狀選擇的代表性元件;沒有表格/KPI 卡片/表單的預設;先讀取,編輯再深入一層

總分 /36。低於 14:原型。14-23:可內部使用。24-31:可出貨。32+:精心設計。

結構跡象(AI 建構的應用程式)

  • 一個 800+ 行的元件渲染整個產品;無路由器。
  • 驗證僅存在於 proxy 配置或已被註解;API 開放。
  • 確認文字包含「for all users」或資料無擁有者。
  • 設定僅以環境變數存在或根本不存在。
  • UI 在每次重新整理時重新擷取所有項目(客戶端 N+1 問題)。
  • 「Coming soon」、佔位頁面、無效按鈕、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.

相關技能