SuperAPI AI 工具集

review

测试与质量

查看项目

更新于 10-15 18:07

技能介绍

用途 Review 是一个应用审查编排器,也是所有应用审查的单一入口。它的作用是对需要审查的内容进行分诊(triage),然后运行一个或多个领域审查,并把这些审查合并成一份统一报告。每个领域定义在 references/<domain>.md 中,只有在被选中时才会加载。

适用时机

  • 用户想做审查,但不确定该做哪种审查。
  • 上线前就绪评估。
  • 事后复盘(post-incident)的审查规划。
  • 针对某个具体领域的定向请求(例如“检查我的应用安全性”“审查 SEO”)。

模式

  • Triage(默认,/review):询问上下文问题,推荐计划,然后执行。
  • Full suite(/review --all):运行所有适用的领域。
  • Targeted(/review <domain>):直接进入某个领域,跳过 triage。例如 /review security、/review seo。可接受可选的深度标志(--quick / --thorough)。

领域 每一行对应一个参考文件,只有在该领域被选中时才加载该文件。

  • security → references/security.md,在以下情况运行:认证/登录变更、敏感数据、OWASP、headers/CORS/CSP、供应链。
  • privacy → references/privacy.md,在以下情况运行:收集 PII、跟踪/分析、同意横幅、GDPR/CCPA。
  • compliance → references/compliance.md,在以下情况运行:受监管行业、审计准备、HIPAA/SOC 2/PCI-DSS/GDPR、支付或健康数据。
  • design → references/design.md,在以下情况运行:没有设计师的 UI 发布、响应式、无障碍、排版、i18n。
  • resilience → references/resilience.md,在以下情况运行:错误处理、网络/API 失败、空/边界状态、降级。
  • performance → references/performance.md,在以下情况运行:页面缓慢、Core Web Vitals、包体积、运行时/渲染性能。
  • seo → references/seo.md,在以下情况运行:公开站点、meta 标签、结构化数据、可抓取性、站点地图。
  • geo → references/geo.md,在以下情况运行:通过 AI 助手被发现、LLM 引用就绪度、llms.txt、实体清晰度。

共享约定(阶段、评分、置信度、严重程度、输出路径)位于 references/report-format.md,每个领域都遵循这些约定。

步骤

  1. 收集上下文:读取项目(技术栈、框架、package.json、路由、组件);检查 git diff 中的最近改动;查找 shiplight/reports/ 中已有报告;自动检测合规标记(HIPAA/PHI、PCI/支付字段、GDPR/cookie 同意)。若以 /review <domain> 调用,则直接跳到第 4 步处理该领域。
  2. 提问(最多 4 个):一次一个,并带自动检测的默认值——应用类型(SaaS、医疗、金融科技、电商、内部工具、营销站点、纯 API);触发本次审查的原因(上线前、新功能、依赖更新、安全事件、审计准备、例行);是否有合规要求(无、HIPAA、SOC2、PCI-DSS、GDPR、多个),可从代码库自动检测;具体关注点(开放式,可选)。
  3. 生成审查计划:将每个适用领域归类为 CRITICAL(必须运行)、RECOMMENDED(有意义价值)或 OPTIONAL(锦上添花),并给出预估深度(quick / standard / thorough)。按产品类型对 SEO 与 GEO 进行优先级排序:开发者工具、API 产品、SaaS 中 SEO 为 RECOMMENDED、GEO 为 CRITICAL;电商、本地业务、市场中 SEO 为 CRITICAL、GEO 为 OPTIONAL;内容/媒体、文档、博客中两者均为 CRITICAL;内部工具两者均不适用。随后呈现决策矩阵(审查项、优先级、理由、深度)。
  4. 执行:询问“现在运行所有 CRITICAL 审查吗?[Y/n] 或选择特定的审查项。”;对每个选中的领域,读取 references/<domain>.md 并遵循其五个阶段,同时应用 references/report-format.md 进行评分、严重程度与输出路径;领域按顺序运行,每个完成后先显示简要摘要再继续。
  5. 统一报告:所选领域完成后,将各领域报告合并为一份,保存到 shiplight/reports/review-{date}.md,内容包括:总体就绪度评分(0–10)及各领域评分;按严重程度排列的全部领域前 5 项发现;回归测试摘要(生成的 YAML 测试总数,位于 shiplight/tests/)。

提示

  • 每次重大上线前运行 /review。
  • 当你已经知道自己需要什么时,/review <domain> 是快速路径。
  • 报告会累积在 shiplight/reports/,编排器可展示趋势。
  • 来自审查的 YAML 回归测试会累积在 shiplight/tests/。

限制 资料未提供除上述领域与流程之外的其他能力、收费、价格、平台或效果信息。