review-spec について
review-specは、仕様書を関連するコードベースと照合するコードレビュー用スキルです。設計や実現可能性、安全性、テスト上の懸念を見つけ、優先度付きの改善案を提示します。
主な機能
- 01仕様書とコードの照合
- 02アーキテクチャと実現可能性の確認
- 03信頼性・セキュリティ・性能の評価
- 04エッジケースとテスト不足の特定
- 05優先度付きの改善案
活用シーン
- 01実装計画のレビュー
- 02仕様と既存コードの整合性確認
- 03開発前の安全性や信頼性リスクの発見
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/review-specを入力して読み込まれたか確認します。
詳細
指定された仕様書と参照されているコードベースの両方を分析して、仕様書をレビューしてください。
手順
- 仕様書を読む - 目標、フェーズ、提案されている変更を理解します
- コードベースを調査する - 仕様書で言及されているファイルとコードを読みます
- パターンを分析する - 既存のパターン、規約、アーキテクチャを特定します
- 計画を検証する - 提案がコードベースの実情に合っていることを確認します
- 問題点を特定する - 不足点、リスク、改善の機会を見つけます
レビュー項目
以下の領域を評価します（関連する項目を重視してください）。
- アーキテクチャ：コンポーネントの境界、データフロー、API コントラクト、関心の分離
- 実現可能性：実装の複雑さ、技術的なトレードオフ、工数の見積もり
- 信頼性：エラー処理、再試行、冪等性、グレースフルデグラデーション
- パフォーマンス：ボトルネック、キャッシュ、クエリパターン、スケーリングの方針
- セキュリティ：認証、データ保護、入力検証、監査ログ
- エッジケース：null の処理、上限、タイムアウト、競合状態、部分的な障害
- テスト：テスト容易性、統合戦略、ロールバックの考慮事項
出力形式
各指摘事項について：
### [Finding Title]
**Category**: Architecture | Feasibility | Reliability | Performance | Security | Edge Case | Testing
**Severity**: Critical | High | Medium | Low
**Section**: [Spec section or phase]
**Issue**: [Clear problem description]
**Recommendation**: [Specific, actionable change]
**Rationale**: [Technical justification]
ガイドライン
- コードに照らして検証する - 仕様書を鵜呑みにせず、実際の実装を確認します
- 既存のパターンに従う - 推奨事項はコードベースの規約に沿ったものにします
- 具体的にする - 正確なファイル、関数、行番号を示します
- 優先順位を付ける - 重大度と影響度の高い順に指摘事項を並べます
- 前提に疑問を呈する - 根拠のない判断に疑問を呈します
コメント
Markdown 対応