Communitygithub.com

レビューループ

同一セッション内で作業とレビューを反復するサイクルです。批評サブエージェントを起動して1〜10のスコアと実用的なフィードバックを得て、品質ゲートを満たすまで修正を繰り返します。機能実装、仕様作成、既存コードのレビューなど、速度よりも品質が重要なタスクに使用します。

レビューループ とは?

このスキルは、単一のAIエージェントセッション内で反復的なワーカー・レビューサイクルを実装します。主エージェントが作業を実行し、独立した批評サブエージェントを起動して1〜10のスコアと具体的で実用的なフィードバックを提供し、事前に定義された品質ゲート(デフォルトは8/10)を満たすまでフィードバックに基づいて改訂を繰り返します。このスキルは、Claude Code、Cursor、Codexなどのサブエージェント起動をサポートするエージェント向けに設計されていますが、サブエージェント機能のないプラットフォームでは、新しいチャットコンテキストを開いて過去の推論なしにワークプロダクトのみを貼り付けることでシミュレートできます。主な利点は、初回のドラフトが最終版になることはなく、反復的な批評が単一パスよりも優れた成果を生み出すという原則にあります。このスキルは、実用的なフィードバックとスコアリング基準を提供する詳細なレビュアープロンプトテンプレートを提供し、最小/最大ループ数、品質ゲート、レビュアーモル研のパラメーターをユーザーがインラインで上書きできるようにします。また、モデル選択に関する重要なガイドラインも含まれており、レビュアーは常にワーカーと同等以上であるべきであり、複雑なロジックや微妙な退行を適切に批評できるようにします。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/review-loop

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

レビューループ (Review Loop)

同一セッション内で反復的なワーカー・レビューサイクルを実行します。作業を行い、レビュー用のサブエージェントを起動して批評を受け、フィードバックに基づいて修正し、品質ゲートを満たすまで繰り返します。

核となる原則: 初稿が最終稿になることはありません。反復的な批評は、1回のパスよりも優れた成果を生み出します。

プラットフォームに関する注意: このスキルは、サブエージェントの起動をサポートするエージェントで最も効果的に機能します。 その機能がないプラットフォームでは、新しいチャットコンテキストを開き、過去の推論を含めずにワークプロダクトのみを貼り付け、1〜10のスコアと具体的なフィードバックを求めることで、レビュアーのステップをシミュレートできます。

クイックスタート

  1. 「Xを実装して、review-loopを使って」または「今書いたファイルに対してreview-loopを実行して」と指示します。
  2. エージェントが作業を実行(または既存の作業を読み込み)します。
  3. 別の批評サブエージェントが1〜10のスコアと具体的なフィードバックを提供します。
  4. エージェントが修正し、スコアが8以上(デフォルトの品質ゲート)になるまで繰り返します。
  5. ループのサマリーが最終出力とともに提供されます。

使用すべき場面

  • ユーザーが「use review-loop」、「polish this」、「iterate on this」、「/review-loop」と言った場合
  • 速度よりも品質が重要な複雑な実装
  • 設計書、仕様書、技術文書
  • 堅牢性が求められるコード(セキュリティ、データパイプライン、金融ロジック)
  • ユーザーがプロセスに批判的な批評を組み込むことを望む場合

使用すべきでない場面

  • 単純な修正、クイック編集、1行の変更
  • テストが品質ゲートとなるタスク(代わりにTDD + CIを使用)
  • ユーザーがとにかく素早く終わらせたい場合
  • 学習が目的であり、リリースが目的ではない探索的/スパイク的な作業
  • 明確な受け入れ基準がないタスク — 最初にそれらを定義してから、review-loopを使用します

デフォルト設定

設定項目デフォルト値
最小ループ数2
最大ループ数4
品質ゲート8/10
ワーカーモデル(現在のモデル)
レビュアーモデル(現在のモデル、または高速/バランスの取れた代替)

モデル選択

レビュアーのタスクはロジックと制約を評価することです。ワーカーのタスクはコードを書き、修正することです。それに応じてサブエージェントの能力を選択してください。

重要なルール: レビュアーは常にワーカーと同等以上でなければなりません。レビュアーがワーカーよりも弱い場合、複雑なロジックを適切に批評したり、微妙な退行を見つけたりすることができません。

タスクの複雑さワーカーの能力レビュアーの能力根拠
単純/機械的 (CRUD、フォーマット、ボイラープレート)高速 / 軽量バランス型軽量ワーカーは高速、バランス型レビュアーで問題を容易に発見可能
標準 (機能、リファクタリング、ドキュメント)バランス型バランス型コスト、速度、品質のバランスが良い
複雑 (マルチファイル、統合、設計)バランス型高度 / 推論型高度レビュアーが微妙なアーキテクチャ問題を発見、バランス型ワーカーが実装可能
非常に複雑 (セキュリティ、量子、分散システム)高度 / 推論型高度 / 推論型両方に完全なコンテキストと推論能力が必要。レビュアーはワーカーの能力に一致する必要がある

黄金律: ワーカーはレビュアーのフィードバックに基づいて行動できるほど賢くなければなりません。レビュアーが「チャネルベースのセマフォで競合状態を修正してください」と言ったのに、ワーカーが並行処理について推論できない場合、ループは収束しません。

エスカレーションシグナル: 同じフィードバックで2回連続のループでスコアが改善しない場合、ワーカーモデルが弱すぎます。エスカレーション方法:

  • オプションA: ユーザーにより高性能なモデルに切り替えるよう依頼する
  • オプションB: 一時的に品質ゲートを下げ、その差をユーザーに伝える
  • オプションC: タスクをより小さなサブタスクに分割し、それぞれでreview-loopを実行する

デフォルトの動作: あなた(メインエージェント)はワーカーであるため、現在の能力に基づいて、タスクに応じてレビューサブエージェントを起動します:

  • ほとんどのタスク → 標準/バランス型レビュアー
  • 特殊/難しいタスク → 高度/推論型レビュアー
  • クイックチェック → 高速/軽量レビュアー (軽量ワーカーとしても動作する場合のみ)

ユーザーによる上書き

ユーザーはリクエスト内で任意のデフォルトをインラインで上書きできます。これらを自然に解析してください:

「Xを実装して、review-loopを使用、品質ゲート9、レビューにはアドバンストモデルを使用、最大5ループ」
「polish this、最小2ループ、ゲート8」
「fastレビュアーでreview-loopを実行、最大2ループ」
「review-loopを使用、推論型レビュアー、品質ゲート9、最小3最大6」

解析ルール:

  • 「quality gate N」または「gate N」 → quality_gate = N
  • 「[model] reviewer」または「review with [model]」 → レビュアーモデルの上書き
  • 「max N loops」 → max_loops = N
  • 「min N loops」 → min_loops = N
  • ユーザーが指定しない場合はデフォルトを使用
  • ユーザーが「thorough」または「strict」と言った場合 → quality_gate 8, min_loops 2 と解釈
  • ユーザーが「quick」または「fast」と言った場合 → max_loops 2, quality_gate 6 と解釈

プロセス

flowchart TD
    A[作業を実行] --> B[レビューサブエージェントを起動]
    B --> C{最小ループ数に達したか?}
    C -- いいえ、常に続行 --> E[フィードバックに基づいて修正]
    C -- はい --> D{スコア >= 品質ゲート?}
    D -- はい --> F[最終ポリッシュパス]
    D -- いいえ --> G{最大ループ数に達したか?}
    G -- はい、そこで停止 --> F
    G -- いいえ --> E
    E --> B
    F --> H([完了])

ステップバイステップ

ステップ 1: 作業を実行

通常通りタスクを完了します。コードを書き、仕様を作成し、機能を実装します。ためらわずに、最善の初回アプローチを生成してください。

ステップ 2: レビューサブエージェントを起動

エージェントツールを使用してレビュアーを派遣します。レビュアーは以下を満たす必要があります:

  • 独立したサブエージェントであること(新しいコンテキスト、あなたの推論に影響されない)
  • ワークプロダクト(ファイル、差分)のみを受け取ること — あなたの思考プロセスは渡さない
  • 1〜10のスコアと具体的で実用的なフィードバックを提供すること
  • デフォルトではバランス型/標準モデルを使用すること(複雑/特殊なタスクでは高度推論モデルを使用してもよい)

レビュアープロンプトテンプレート:

あなたは批評的なレビュアーです。以下の作業を1〜10でスコア付けし、具体的で実用的なフィードバックを提供してください。

## 行われたこと
{タスクの簡単な説明}

## レビュー基準
{タスク固有の基準 — このタスクで重要なこと}

適切に書かれた基準の例:
  REST APIエンドポイントの場合:
    - 正しいHTTPステータスコードが使用されている
    - すべてのパラメータに入力バリデーションが存在する
    - 認証が適用されている; 認証されていないアクセスがない
    - N+1クエリパターンがない

  設計文書の場合:
    - 問題の記述が曖昧でない
    - 代替案がトレードオフとともに検討されている
    - 実装の複雑さについてごまかしていない
    - 成功指標が測定可能である

  データパイプラインの場合:
    - べき等性がある — 再実行しても安全
    - スキーマ変更が適切に処理される
    - 障害モードが文書化されている
    - PIIの取り扱いが対処されている

## 指示
1. 作業を注意深く読んでください
2. 1〜10でスコア付け:
   - 1-3: 根本的に壊れているか、主要な要件が欠落している
   - 4-6: 動作するが重大な問題がある
   - 7-8: 良い、軽微な問題のみ
   - 9-10: 優秀、出荷準備完了
3. 該当する場合はファイル:行参照とともに具体的な問題をリストアップ
4. 各問題について、**なぜ**それが重要で、**何を**修正すべきかを説明
5. 礼儀正しくしないでください — 正直かつ率直に
6. スコアを「Score: N/10」と明確に記述

## レビューするファイル
{ファイルの内容を貼り付けるか、関連する抜粋とともにファイルパスをリストアップ}

ステップ 3: フィードバックを解析

レビュアーの応答から以下を抽出:

  • スコア (数値)
  • 問題点 (重大 / 重要 / 軽微 に分類)
  • 具体的な修正 (何を変更すべきか)

ユーザーに報告:

ループ {N}/{max}: スコア {X}/10
- {主要なフィードバックポイントのサマリー}

ステップ 4: 停止条件を確認

以下の順序で:

  1. 完了したループ数 < 最小ループ数 → 継続 (常に)
  2. スコア >= 品質ゲート → 停止、最終ポリッシュへ
  3. 完了したループ数 >= 最大ループ数 → 停止、最終ポリッシュへ
  4. それ以外 → 修正してループ

ステップ 5: 修正

レビュアーのフィードバックに対応します。重大および重要な問題を修正します。軽微な問題は任意です。その後、ステップ2に戻ります。

重要: 各修正は的を絞ったものにしてください。すべてを書き直さないでください — レビュアーが指摘した箇所を修正します。以前のすべてのフィードバックを頭の中でリスト化し、退行を防ぎます。

ステップ 6: 最終ポリッシュ

ループが終了したら(品質ゲートに達するか最大ループ数に達した場合):

  • 残っている軽微な問題があれば、簡単に修正可能なものに対処
  • 最終出力に一貫性があることを確認(修正サイクルによるアーティファクトがないこと)
  • 最終スコアとループ数をユーザーに報告

タスクタイプ別のレビュー基準の適応

タスクタイプレビュアーが注力すべき点
コード正確性、エッジケース、エラー処理、可読性、セキュリティ問題がないこと
仕様/設計完全性、実現可能性、ごまかしがないこと、実装可能性
リファクタリング動作変更なし、退行なし、以前よりクリーンであること
文書作成明確さ、構成、対象読者に適切、冗長でないこと
バグ修正根本原因に対処、退行テストあり、副作用なし
インフラ/IaCべき等性、最小権限、ハードコードされたシークレットなし、破棄の安全性
データベースマイグレーション可逆性、インデックス戦略、データ損失リスク、大規模時のパフォーマンス
API設計後方互換性、認証、バージョニング、エラーコントラクト
テストスイートエッジケースカバレッジ、テスト間の依存なし、意味のあるアサーション

2つの運用モード

モード A: 「実行とレビュー」 (フルサイクル)

ユーザーがタスクを与え、review-loopの使用を指示します。作業を実行し、レビューループも実行します。

ユーザー: 「キャッシュレイヤーを実装して。review-loopを使って、品質ゲート8。」

あなた:
1. キャッシュレイヤーを実装
2. レビュアーを起動 → スコア 6、フィードバック: 削除機構がない、TTLがない
3. 修正: 削除機構とTTLを追加
4. レビュアーを起動 → スコア 8、フィードバック: 軽微な命名に関する指摘
5. 最終ポリッシュ、完了

モード B: 「既存のものをレビュー」 (レビューのみ)

ユーザーが既に作業を行ったか、あなたが既に作業を行いました。既存のものに対してレビューループを実行するだけです。

ユーザー: 「今書いた認証モジュールに対してreview-loopを実行して」

あなた:
1. 認証モジュールを読み込む
2. レビュアーを起動 → スコア 5、フィードバック: SQLインジェクション、レート制限なし
3. 修正: クエリをパラメータ化、レート制限を追加
4. レビュアーを起動 → スコア 8、承認
5. 完了

レッドフラグ

絶対に避けるべきこと:

  • サブエージェントを起動せずに自己レビュー(アンカリングバイアス)
  • 正当な理由なく「フィードバックが間違っている」と修正サイクルをスキップ
  • 自分のスコアを水増しする(「これは実際には9だと思う」)
  • ユーザーの同意なしに最大ループ数を超えて継続
  • 完全な推論/履歴をレビュアーに渡す(レビュアーはあなたの意図ではなく、WORKをレビューすべき)

レビュアーが間違っている場合:

  • 証拠を示して反論する(フィードバックを否定するコード/テストを示す)
  • 修正時にその特定のポイントをスキップする
  • ユーザーへの報告にその旨を記す
  • 品質の基準を下げて補償しない

レポート形式の例

--- レビューループ: {タスク名} ---

ループ 1/4: スコア 6/10
  レビュアー: 入力バリデーション欠如、ネットワークタイムアウトのエラー処理なし、
            関数が長すぎる(80行)。
  アクション: 3つの問題すべてを修正中。

ループ 2/4: スコア 8/10
  レビュアー: クリーン。軽微: 変数名 `d` はより説明的にすべき。
  アクション: 品質ゲート達成 (8 >= 8)。最終ポリッシュ。

結果: 2ループで8/10。完了。

既知の制限

  • レビューサブエージェントは以前のループの記憶を持ちません — 解決済みの問題を繰り返し指摘されないように、各レビュアープロンプトに以前のフィードバックコンテキストを明示的に含めてください
  • レビュアープロンプトの基準があいまいすぎると、スコアのインフレが発生する可能性があります — 具体的で測定可能な基準を書くことに時間を投資してください
  • このスキルは、セキュリティクリティカルまたはコンプライアンスに敏感なコードに対する人間によるコードレビューを代替しません。出力は強力な最初のパスとして扱ってください
  • タスクの指定が不十分な場合、ループの収束は保証されません — 開始前に明確な受け入れ基準を定義してください

コストと速度

  • 各ループ = 1回のレビューサブエージェント呼び出し
  • 3ループのフルサイクルでは、単一実装パスの約1〜2倍の時間を見積もってください
  • これは、バグのあるコードをリリースしたり、あいまいな仕様を作成したり、後期のレビューサイクルを引き起こしたりするよりも安上がりです
  • ほとんどのレビューにはデフォルト/標準モデルを使用してください。特殊なドメイン(セキュリティ監査、分散システム、クオンツファイナンス)にのみ、高度推論モデルにアップグレードしてください

ライセンス

MIT — どのAIツールやプラットフォームでも自由に使用、適応、再配布できます。帰属表示をいただければ幸いです。コントリビューションを歓迎します。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

関連スキル