rs-review について
rs-reviewは、選定されたスクリーンショットを製品・デザイン仕様と照らして評価するLLMベースの視覚レビュー用スキルです。結果は助言として扱い、`rootspec/review-status.json` の `llmFindings` キーだけに記録します。
主な機能
- 01選定されたスクリーンショットの確認
- 02製品やデザインの背景に沿った視覚評価
- 03clean、needs_review、brokenでの判定
- 04`llmFindings`への観察結果のみの記録
- 05静的レビュー結果や他の項目の保持
活用シーン
- 01静的レビュー後の画面表示の確認
- 02ビルドを阻止せずスクリーンショット所見を記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ rootspec/ rootspec --skill rs-reviewインストール後、Claude Code で/rs-reviewを入力して読み込まれたか確認します。
詳細
2 段階レビューの 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 文ずつの observations を 1~5 件記述してください。例:
- 「ホームページのヒーロー部分は中央揃えですが、狭いビューポートでは 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 で探索したりしている場合は、指示から外れています。