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, 品質評価, スコアリング, 合否判定.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

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.
nameformatting-audits
description>
トリガーSOW review, Spec review, document review, design review,
allowed-toolsRead, 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 - コードレビューオーケストレーション