formatting-audits
Design document review format definition with 100-point scoring system. Provides quality evaluation criteria, scoring items, and pass/fail logic for SOW/Spec documents. Combined with confidence markers (✓/→/?) to clarify evaluation evidence. Triggers: SOW review, Spec review, document review, design review, ドキュメントレビュー, 設計レビュー, 90 points, scoring, grading, 品質評価, スコアリング, 合否判定.
When & Why to Use This Skill
This Claude skill provides a professional 100-point scoring system for auditing technical design documents, such as SOWs and Specifications. It standardizes the quality evaluation process by assessing documents across four critical dimensions: accuracy, completeness, relevance, and feasibility. By utilizing evidence-based confidence markers and clear pass/fail logic, it ensures that project documentation is rigorous, actionable, and ready for the implementation phase.
Use Cases
- Standardizing the review of Statement of Work (SOW) documents to ensure all client requirements are captured and risks are mitigated.
- Evaluating technical specifications (Specs) for logical consistency and completeness before the coding phase begins.
- Providing structured feedback to engineering teams on architecture designs using a consistent grading rubric and actionable improvement steps.
- Verifying the alignment between high-level business goals and technical solution designs to prevent scope creep and ensure project feasibility.
| name | formatting-audits |
|---|---|
| description | > |
| トリガー | SOW review, Spec review, document review, design review, |
| allowed-tools | Read, Grep, Glob |
レビュー形式 - 設計ドキュメント採点
SOW/Specドキュメント品質評価のための100点満点採点形式。
採点システム
| 項目 | スコア | フォーカス | 基準 |
|---|---|---|---|
| 正確性 | 0-25 | 事実 vs 推論 | ✓/→/?マーカー、証拠パス |
| 完全性 | 0-25 | カバレッジ | テスト可能な基準、リスク、依存関係 |
| 関連性 | 0-25 | 整合性 | 目標 ↔ ソリューション、スコープ、YAGNI |
| 実行可能性 | 0-25 | 実装可能性 | 具体的なステップ、実現可能性、次のアクション |
判定基準
| スコア | 判定 | アクション |
|---|---|---|
| 90-100 | ✅ PASS | 次のフェーズへ進行 |
| 70-89 | ⚠️ CONDITIONAL | 修正後に再レビュー |
| 0-69 | ❌ FAIL | 大幅な修正が必要 |
スコアガイドライン
| スコア範囲 | 品質レベル |
|---|---|
| 23-25 | 優秀 - すべての主張に証拠あり |
| 18-22 | 許容 - ほとんどの主張が検証済み |
| 13-17 | 要改善 - 複数のギャップ |
| 0-12 | 不十分 - 重大な問題 |
出力形式
## 📋 設計ドキュメントレビュー結果
### 合計スコア: {total}/100 {✅/⚠️/❌}
| 項目 | スコア | マーカー |
|------|-------|--------|
| 正確性 | /25 | ✓/→/? |
| 完全性 | /25 | ✓/→/? |
| 関連性 | /25 | ✓/→/? |
| 実行可能性 | /25 | ✓/→/? |
### 🔗 SOW ↔ Spec整合性
| チェック | ステータス |
|-------|--------|
| 受け入れ基準 → FR | ✓/→/? |
| リスク → 緩和策 | ✓/→/? |
| 依存関係 | ✓/→/? |
| テストカバレッジ | ✓/→/? |
### 📝 要求される修正
🔴 必須: [リスト]
🟡 推奨: [リスト]
### 次のアクション
✅ PASS: /code
⚠️ CONDITIONAL: 修正して再レビュー
❌ FAIL: /thinkで再計画
参照
関連スキル
reviewing-readability- 可読性レビュースキル
関連エージェント
sow-spec-reviewer- SOW/Spec検証エージェント
使用コマンド
/think- SOW/Spec生成/audit- コードレビューオーケストレーション