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. 03clean、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を入力して読み込まれたか確認します。

詳細

2 段階レビューの 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 文ずつの 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 で探索したりしている場合は、指示から外れています。

コメント