Communitygithub.com

AaronAsAChimp/skills

バイブスコードされたアプリケーションを評価する際に使用します。Go/No-Go の判断を支援し、今後の進め方について推奨事項を提供します。

skills とは?

このスキルは、いわゆる「バイブスコード」(Vibe Coding)で開発されたアプリケーションのコードベースをレビューし、Go/No-Go の判断と改善推奨事項を提供します。セキュリティ、信頼性、パフォーマンス、UI/UX、アクセシビリティの5つの品質の柱に基づいて、体系的なレビュープロセスを実施します。まず、PRODUCT.mdやREADME.mdなどの製品ドキュメントを収集し、不足している情報をユーザーへの質問で補完します。その後、各品質の柱ごとに独立したサブエージェントを起動してコードをレビューし、具体的な問題とその影響度(Showstopper、Critical、Moderate、Nice to have)を特定します。最終的には、これらの結果を統合した詳細なHTMLレポートを生成し、ブラウザで表示します。Claude CodeやCursor、CodexなどのAIエージェントプラットフォーム上で、特に初期段階のアプリケーション評価や外部レビュー依頼に有用です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronAsAChimp/skills/tree/HEAD/skills/immaculate-vibes

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

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

ドキュメント

バイブスの完全性

あなたは、このバイブスコードされたコードベースをレビューするよう依頼されています。見つけた問題を修正するよう求められているわけではなく、推奨事項を示すだけです。

プロセス

大まかなプロセスは次のとおりです。

  1. 利用可能なすべての製品ドキュメントを収集する。
  2. ユーザーに質問して、アプリケーションへの理解を深める。
  3. 品質の柱に基づいてコードをレビューする。
  4. 調査結果を含むレポートを作成する。

品質の柱

これらは高品質なソフトウェアを書くための柱です。重要度の高い順に並んでいます。このプロジェクトを評価するレンズとして使用してください。

  • セキュリティ - 認証、権限、データの露出、安全でないブラウザの動作。
  • 信頼性 - クリティカルフロー、ルートの健全性、アサーション、コンソールエラー、壊れた状態。
  • パフォーマンス - 読み込み動作、レスポンシブネス、高コストなアセット、ユーザーが認識するレイテンシ。
  • UI/UX - ナビゲーション、明瞭さ、バリデーション、コンテンツの期待、視覚的な一貫性。
  • アクセシビリティ - キーボード操作、セマンティクス、ラベル、ARIA、コントラスト、支援技術へのシグナル。

プロセスの詳細

1. 利用可能な製品ドキュメントを収集する

このフェーズでは、利用可能な製品ドキュメントを探します。これがレビューの基礎となるため、品質の柱に関連する可能性のあるものはすべて見つけてください。

よく探す場所:

  • PRODUCT.md
  • PRD.md
  • README.md
  • docs/

2. ユーザーに質問する

製品ドキュメントは不完全であったり、現在のアプリケーションの状態と同期していない場合があります。プロジェクトとその要件への理解を深めるために、ユーザーに質問してください。質問ツールが利用可能な場合はそれを使用し、そうでない場合はユーザーとチャットしてください。

質問の例:

  • このアプリケーションにアクセスする必要があるのは誰ですか?
  • 継続的なメンテナンスの計画はありますか?
  • このアプリケーションをどのように監視し、パフォーマンスと信頼性を検証しますか?
  • このアプリケーションはどこにホストされる予定ですか?

3. コードをレビューする

収集した情報を使用して、各品質の柱についてコードをレビューするサブエージェントを起動します。コンテキストの混入を避けるために、それらを分離してください。各サブエージェントには、問題を見つけ、それぞれの品質の柱に基づいてGo/No-Go評価を提供するタスクを割り当てます。

各問題:

  • 具体的で実行可能な問題であるべき
  • 問題の影響評価を含む
    • 各問題に次の影響レベルのいずれかを割り当てる:Showstopper、Critical、Moderate、Nice to have
  • 問題の明確な説明と、関連するファイル名と行番号(ある場合)を含む
  • 解決策の推奨事項を提供する

4. レポートを作成する

最後に、サブエージェントからのすべての結果を収集し、詳細なHTMLベースのレポートを作成し、チャットでハイレベルな要約を提供します。ユーザーが確認できるように、ブラウザでHTMLレポートを開きます。

レポートの主要機能:

  • Go/No-Goの推奨事項
  • 要件:製品とそのコア要件のハイレベルな要約
  • 問題:影響レベルの高い順(最も深刻なものから)に並べられた問題のリスト
  • その他の情報:レビュー担当者が知っておくべきその他の重要な発見事項

レポートの例:

推奨事項: No-Go

Fourgroundsコーヒーランキングは、Fourgroundsコーヒーショップの顧客がお気に入りのコーヒー飲料をランク付けできる公開アプリケーションです。

コア要件:

  • ユーザーにFourgroundsで現在提供されている飲料のリストが表示される必要がある
  • ユーザーはドラッグして飲料を並べ替え、好みのランキングを作成できる必要がある
  • ユーザーはランキングを送信し、選択した無料のベーカリーアイテムのリワードを受け取れる必要がある
  • ユーザーはランキングを1回のみ送信できる必要がある

問題:

ユーザーは木曜日に複数回送信できる

影響:CRITICAL - ユーザーは無料リワードを複数累積できる。

date.js 42行目の日付解析エラーにより、未処理の例外が発生すると、check-reward.js 16行目で以前の送信チェックがスキップされる可能性がある。

推奨事項:組み込みの日付パーサーを使用し、日付解析をtry/catchでラップして、例外がアプリケーションの他の領域に影響を及ぼさないようにする。

その他の情報:

  • coffee-products.jsonファイルは毎日生成されます。製品が日中に変更された場合、このファイルが古くなっている可能性があります。ランキングの外部コンシューマーは、製品の存在を検証するように注意する必要があります。

Individual skills in this repo

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

関連スキル