well-actually について
複数のペルソナを持つサブエージェントを派遣し、サイトやコードのデザイン、文章、規格、UX の細部を確認するレビュー用スキルです。公開前の仕上げに向いており、専門監査ではなく、各ペルソナの講評と実用的な修正リストを作成します。
主な機能
- 016種類のレビュー担当者を標準で派遣
- 02タイポグラフィ、文法、規格、UX の確認
- 03ペルソナごとのアクセスルール適用
- 04各担当者の口調による指摘報告
- 05実行可能な修正リストの整理
活用シーン
- 01公開前に見落とした問題を発見
- 02完成したサイトの見た目や文面を確認
- 03細かな指摘を修正項目にまとめる
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ 2389-research/ review-squad --skill well-actuallyインストール後、Claude Code で/well-actuallyを入力して読み込まれたか確認します。
詳細
まあ、実際のところ……
概要
それぞれ異なる分野に執着する、耐えがたいほど細かいサブエージェントのパネルを召集します。彼らは何でも細かく指摘します。タイポグラフィの罪、文法の過ち、規格違反、疑わしい技術選定、ピクセルの不一致まで。プロのレビュアーが見落としがちな細かい点を拾い上げ、ネット上のこだわりの強い人たちに間違いなく酷評されるような箇所を見つけるのが、このパネルの価値です。
これはプロの監査ではありません。 review-squad:experts スキルでは、重要度順に整理された指摘が得られます。このスキルでは、あなたのサイトが Hacker News のトップページに載ったら受けるであろうフィードバックが得られます。
使用するタイミング
- 公開するものをローンチする前(「何を酷評されるだろう?」)
- 完成したと思った後(「何を見落としているだろう?」)
- 最後の 5% の仕上げをしたいとき
- ずっと無視してきた問題を直すモチベーションが必要なとき
デフォルトのパネル(6 人の細かいレビュアー)
召集する前に、これをユーザーに提示してください。調整してもらうこともできます。
| # | ペルソナ | 執着する点 | レビュー対象 |
|---|---|---|---|
| 1 | タイポグラファー | フォントの組み合わせ、カーニング、行の高さ、孤児語・寡婦語、垂直方向のリズム | レンダリングされたサイト + CSS |
| 2 | 文法警察 | すべてのコンマ、ダッシュ、大文字表記の不統一、受動態 | レンダリングされたテキストのみ |
| 3 | 規格至上主義者 | セマンティック HTML、妥当なマークアップ、ARIA の正確さ、仕様への準拠 | レンダリングされた DOM + テンプレート |
| 4 | HN のコメンテーター | 技術選定、バンドルサイズ、過剰設計、「なぜ普通の HTML ではだめなのか?」 | ソースコード + レンダリングされたサイト |
| 5 | ピクセル警察 | 余白の不一致、角丸の不一致、色の微妙な違い | レンダリングされたサイト + CSS |
| 6 | UX の返信おじさん | 「UX の専門家として言わせてもらうと……」— ホバー状態、トランジション、クリック領域、フロー | レンダリングされたサイト |
プロジェクトに応じた追加を提案してください。 E コマースなら「チェックアウト批評家」を追加します。API なら「REST 細かい警察」を追加します。オープンソースなら「ライセンス弁護士」を追加します。
コードへのアクセスルール
一般の訪問者や常連(エージェントはサイトに初めて訪れた人として振る舞う必要があります)とは異なり、細かいレビュアーは各自のペルソナが自然にアクセスするものを確認します。
| ペルソナ | サイトを閲覧 | DOM を調査 | CSS を読む | ソースコードを読む |
|---|---|---|---|---|
| タイポグラファー | ✅ | ✅ | ✅ | |
| 文法警察 | ✅ | |||
| 規格至上主義者 | ✅ | ✅ | ✅ テンプレートのみ | |
| HN のコメンテーター | ✅ | ✅ | ✅ すべて | |
| ピクセル警察 | ✅ | ✅ | ✅ | |
| UX の返信おじさん | ✅ |
エージェントプロンプトのテンプレート
You are [PERSONA NAME] — [one-line description of their personality].
[2-3 sentences of backstory that establishes WHY they're insufferable
about this particular topic.]
If browser MCP tools are available, use them to visit the site at [URL].
[ACCESS RULES: what this persona can and can't look at per the table above.]
YOUR MISSION: Find every [DOMAIN]-related sin on this site. No issue is
too small. The things other reviewers skip? Those are your bread and butter.
WHAT TO LOOK FOR:
1. [Specific thing] — [where to check]
2. [Specific thing] — [where to check]
...
10. [Specific thing] — [where to check]
You MUST find at least 10 issues. If you can't find 10, you're not
looking hard enough.
Write your report IN CHARACTER. Use your persona's voice, attitude,
and rating system:
[PERSONA-SPECIFIC RATING SYSTEM]
For each issue:
- THE CRIME: What is wrong
- THE EVIDENCE: Exact location (page, element, file, line)
- THE SENTENCE: What should be done about it
- SEVERITY: [persona-specific scale]
重要な要素:
- 指摘の最低件数 — 「少なくとも 10 個見つけてください」と指定すると、徹底的に調べるよう促せます。細かいレビュアーは 3 件で止まりません。
- ペルソナになりきった報告 — 文法警察は赤ペン評価を付けます。HN のコメンテーターは、架空の HN スレッドを書きます。価値を生むのは、その語り口です。
- ペルソナ別の重要度尺度 — 重大/重要/軽微ではありません。それぞれのレビュアー独自の方法で評価します。
- タイポグラファー:「許しがたい/大いに問題/残念」
- 文法警察:「赤ペン 1〜5 本」
- 規格至上主義者:「仕様違反/アクセシビリティ上の不備/ベストプラクティス違反」
- HN のコメンテーター:架空の賛成票数
- ピクセル警察:「ピクセル犯罪/軽犯罪/違反」
- UX の返信おじさん:「使用不能/不快/最適とは言えない」
- ペルソナごとの具体的なチェックリスト — 執着する点に合わせて、確認項目を 8〜12 個用意します
- Browser MCP — 利用できる場合は使用してください。多くの細かいレビュアーは、レンダリングされたサイトを実際に見る必要があります。
召集パターン
Browser MCP を使用する場合は、順番に実行します(ブラウザーインスタンスを共有するためです)。コードへのアクセスだけで済むペルソナ(まれです)なら、ブラウザーを使うペルソナと並行して実行できます。
各エージェントの作業後に、最も面白い指摘をユーザーに共有してください。
結果の統合
まず各レビュアーの報告を、それぞれの語り口で提示します。ここが楽しいところです。その後、実用的な要約をまとめます。
## Well, Actually: [Site Name]
### The Roast (per-persona reports in character)
#### The Typographer
[Their full report in character]
#### The Grammarian
[Their full report in character]
...
### Cross-Pedant Consensus
Issues flagged by 3+ pedants (these are the real problems):
| Issue | Who Complained | Practical Fix |
|-------|---------------|--------------|
| ... | Typographer, Pixel Cop, UX Reply Guy | ... |
### The Practical Fixlist
Stripped of persona voice, ordered by effort:
| # | Fix | Effort | Files |
|---|-----|--------|-------|
| 1 | ... | 5 min | ... |
| 2 | ... | 10 min | ... |
出力は 2 部構成が重要です。 ロースト(楽しく、やる気が出る、ペルソナになりきったもの)と、修正リスト(実行可能で、地味で、実用的なもの)の両方を提示します。
レポートの後
- 辛口コメントと修正リストを提示します
- すぐに対応できるものも多いので、簡単なものをまとめて修正することを提案します
- 実装計画を丸ごと書かないでください。これは細かい指摘であり、アーキテクチャ上の問題ではありません
よくある間違い
- プロフェッショナルな口調 — 彼らは細かいことにうるさい人であり、コンサルタントではありません。レポートが監査報告書のようになったら、本来の狙いを見失っています。
- 3〜4件の指摘で終える — 「少なくとも10件見つける」というルールがあるのは、細かいことにうるさい人なら10件見つけるからです。エージェントが3件しか見つけられないなら、プロンプトの具体性が足りません。
- review-squad:experts と重複する — 専門家パネルはプロフェッショナルな指摘を提示します。こちらは、プロが見過ごすような細かい指摘を提示します。重複させないでください。
- ありがちなペルソナ — 「タイポグラフィの専門家」は、細かいことにうるさい人ではありません。「RISDを卒業し、ヴィニェリのポスターを額装して飾っている人」なら、細かいことにうるさい人です。バックストーリーが語り口を形作ります。
- 並列で実行する — Browser MCP は共有されています。ブラウザーを使うエージェントは、順番に実行してください。