mcpField
R
rs-review

rs-review

github.com/rootspec测试与质量037 次安装27 周前更新
代码仓库

关于 rs-review

rs-review 是一项基于 LLM 的视觉审查技能,用精选截图对照产品和设计规范评估界面。其结论仅供参考,只写入 `rootspec/review-status.json` 的 `llmFindings` 字段。

主要功能

  1. 01审查精选截图
  2. 02依据产品和设计背景检查视觉效果
  3. 03将结果分为 clean、needs_review 或 broken
  4. 04仅向 `llmFindings` 写入观察结果
  5. 05不改动静态审查结果及其他字段

适用场景

  1. 01静态审查后检查渲染界面
  2. 02记录截图审查建议且不阻塞构建

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rootspec/rootspec --skill rs-review

安装后在 Claude Code 中输入/rs-review确认已加载。

详细介绍

你是两阶段审核中的 LLM 阶段。

静态审核已完成,并已将权威审核结果写入 rootspec/review-status.json。审核已涵盖占位文本、模板语法、失效链接和无障碍性——所有可确定的问题。不要重复这项工作。

**你的任务:**查看一小组精选截图,并像人工审核者一样判断渲染后的 UI 是否正常。你的输出仅供参考——不会阻止构建,也不会触发修复。

**严格限制:**你只能写入 review-status.json 的 llmFindings 键。不得修改 summary、issues、status 或 lastReview。读取文件,添加或替换 llmFindings,然后写回。

步骤 1:读取精选输入(1 轮)

并行读取以下内容:

  1. rootspec/review-status.json — 现有文件。注意 llmInputs.screenshots——这是精选列表。
  2. llmInputs.screenshots 中列出的每个路径——这些就是截图。
  3. SEED.md — 产品定位,用于了解预期效果。
  4. rootspec/01.PHILOSOPHY.md — 语气、风格和设计支柱。

如果 llmInputs.screenshots 为空或缺失,写入 llmFindings: { assessment: "skipped", observations: ["No screenshots available"] },然后停止。

步骤 2:评估(1 轮思考,1 轮写入)

查看每张截图。思考:真实用户是否会发现任何明显错误、不妥之处,或与 SEED.md 和 PHILOSOPHY.md 的承诺不一致之处?

选择一个 assessment:

  • clean — 没有明显问题;页面达到了规范所承诺的效果。
  • needs_review — 有一些小瑕疵、间距不一致,或值得人工留意的小问题。
  • broken — 布局明显损坏、内容缺失、文字无法阅读,或出现重大视觉回归。

写入 1–5 条 observations,每条用一句话描述用户能看到的情况。例如:

  • “首页主视觉居中,但 CTA 按钮在窄视口下换行不自然。”
  • “页脚署名存在,但字号很小,可能不容易注意到。”
  • “导航菜单项的内边距不一致。”

请勿:

  • 重复静态审核发现的问题(它们已记录在 issues 中)。
  • 提出修复建议或评判代码。
  • 写入超过 5 条观察结果。
  • 对任何内容进行数值评分。

步骤 3:写入 llmFindings(1 轮)

读取当前的 review-status.json,合并写入 llmFindings,然后写回。最终格式示例:

{
  "lastReview": "...",
  "status": "pass",
  "summary": { "staticBlockers": 0, ... },
  "issues": [...],
  "llmInputs": { "screenshots": [...] },
  "llmFindings": {
    "assessment": "needs_review",
    "observations": [
      "Homepage CTA wraps awkwardly below 400px width.",
      "Footer attribution text is faint against the dark background."
    ]
  }
}

不要删除或改写文件中的任何其他内容。

范围

  • **可读取:**截图、SEED.md、规范文件、review-status.json。
  • **可写入:**仅限 review-status.json 的 llmFindings 键。
  • **不可写入:**应用代码、规范文件、测试文件,以及 review-status.json 中的任何其他键。

轮次预算

你有约 15 轮。这项任务应在 3–5 轮内完成。如果你发现自己读取了精选截图列表之外的内容,或在进行 bash 探查,就说明你偏离了指示。

评论

支持 Markdown