关于 rs-review
rs-review 是一项基于 LLM 的视觉审查技能,用精选截图对照产品和设计规范评估界面。其结论仅供参考,只写入 `rootspec/review-status.json` 的 `llmFindings` 字段。
主要功能
- 01审查精选截图
- 02依据产品和设计背景检查视觉效果
- 03将结果分为 clean、needs_review 或 broken
- 04仅向 `llmFindings` 写入观察结果
- 05不改动静态审查结果及其他字段
适用场景
- 01静态审查后检查渲染界面
- 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 轮)
并行读取以下内容:
rootspec/review-status.json— 现有文件。注意llmInputs.screenshots——这是精选列表。llmInputs.screenshots中列出的每个路径——这些就是截图。SEED.md— 产品定位,用于了解预期效果。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 探查,就说明你偏离了指示。