frontend-review-triage について
フロントエンドのコンサルティング案件でDay 0の初期評価を行うスキルです。アプリを分類し、リポジトリに基づく評価表を作成して、修正案を示さずに優先リスクと確認事項を明らかにします。
主な機能
- 01アプリ種別とドメイン背景の分類
- 02リポジトリの初期監査
- 03プロジェクト情報とワークフローの確認
- 04アプリ種別ごとの優先度ルール適用
- 05簡潔な現状評価表の作成
活用シーン
- 01フロントエンドプロジェクトのDay 0基準作成
- 02詳細レビュー前の主要リスク特定
- 03Week 1レビュー計画の優先事項設定
- 04顧客への確認事項の記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mizchi/ skills --skill frontend-review-triageインストール後、Claude Code で/frontend-review-triageを入力して読み込まれたか確認します。
同梱ファイルREADME.md
詳細
フロントエンドレビュー — トリアージ
フロントエンドコンサルティング案件の Day 0 トリアージを実施します。あなたの役割は、修正を推奨するのではなく、リポジトリの現状を簡潔かつ正直に評価するスコアカードを作成することです。推奨事項は、後からほかの frontend-review-* スキルで提示します。
手順
- スクリプトを実行する前に、アプリを分類します。
- 該当するアプリの種類をユーザーに尋ねるか、README/package.json から推測します。
admin/toc/btob-saas/ec/fintech/healthcare/iot-ops/media - 規制上のコンテキスト(GDPR、PCI DSS、HIPAA、…)と認証要件を記録します。
checklist/00-app-classification.mdの Step 3 を読み、このアプリの種類でどのセキュリティ、パフォーマンス、TypeScript の厳格さ、lint、カバレッジ目標、依存関係の最新性のチェックが P0/P1/対象外となるかを判断します。- 結果を
<client-repo>/.frontend-review/kpi/app-classification.jsonに保存します。
- 該当するアプリの種類をユーザーに尋ねるか、README/package.json から推測します。
scripts/audit-triage.sh --repo <client-repo>を実行します。<client-repo>はユーザーのリポジトリの絶対パスです。<client-repo>/.frontend-review/report/latest/raw/triage.jsonにある生成済み JSON を読みます。- 次の項目も手早く確認します。
package.json— 依存関係、スクリプト、エンジンREADME.md— 最新の内容か、実行方法が記載されているか.github/workflows/— 存在するワークフローgh issue list --state open --limit 20 --json number,title,labels— すでに指摘されている事項
- 「既知の問題」の収集手順について、
checklist/12-known-issues.mdと照合します。
出力
<client-repo>/.frontend-review/report/latest/md/triage-scorecard.md に次の内容を含む Markdown レポートを作成します。
- アプリの分類 — 種類 ID と主要なドメイン上の注意点(1~3 行)
- 優先度の上書き — このアプリの種類に適用される P0 のセキュリティ/パフォーマンスチェック
- スコアカード表(
raw/triage.jsonからコピーして注釈を追加) - 主なリスク 3 件 — 何を最初に修正しますか?分類マトリクスに基づき、それぞれが P0 か P1 かを明記します。
- 未解決の質問 — クライアントに確認する事項(コードから判断できないこと)
- 次のフェーズ — Week 1 の計画で対象とする
checklist/項目を、分類上の優先度順に記載します。
レポート全体を 400 行未満にしてください。それ以上書いている場合は、トリアージではなく分析になっています。
制約
- 簡潔な「主なリスク 3 件」のセクション以外で、修正を提案しないでください。各リスクは 1 文にしてください。
- ほかの
audit-*.shスクリプトは実行しないでください。各ドメイン固有のスキルに任せてください。 <client-repo>/.frontend-review/の外にあるファイルは変更しないでください。- クライアントのリポジトリにコミットをプッシュしたり、PR を作成したりしないでください。
参照資料
- チェックリスト:
checklist/00-app-classification.md、checklist/12-known-issues.md、checklist/01-package-manager.md、checklist/02-dependencies.md - フェーズ:
phase/day-0-triage.md
コメント
Markdown 対応