quality-advisor

quality-advisor

目的

SDD 成果物の作成中に、その場で積極的に品質に関するガイダンスを提供し、作成後の検証ではなく作成中に問題を検出します。セクションの完成度を採点し、ドキュメントのアンチパターンを検出し、累積タグ付けを確認し、命名を検証したうえで、実行可能な推奨事項を返します。

使用するタイミング

次の場合は quality-advisor を使用します。

• 新しい成果物を作成し、リアルタイムのフィードバックを得たい場合。
• 提出前に成果物をレビューする場合。
• 1つのドキュメントについて、テンプレート要件、タグ、命名の準拠状況を確認する場合。

完全な双方向トレーサビリティやプロジェクト全体の検証（../doc-validator/SKILL.md を使用）、またはSDD以外のドキュメントには使用しないでください。

動作

成果物の内容、その種類、任意のチェックレベル（quick／standard／strict）を指定すると、このスキルは次を行います。

1. 成果物のレイヤーに応じたテンプレート要件を読み込みます。${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml から必須セクション、タグの最小数、特別なルール（例：PRD の KPI は定量的であること、EARS の WHEN-THE-SHALL 構文、SPEC の YAML 形式）を読み込みます。コードは IPLAN の下流にある実行対象であり、ドキュメント成果物ではありません。
2. セクションの完成度を採点します。必須セクションを検出し、欠落または一部のみのセクションを指摘して、具体的な問題とともに完成度スコアを報告します。
3. アンチパターンを検出します。Document Control の欠落、プレースホルダーテキスト、曖昧な受け入れ基準、トレーサビリティタグの欠落、リンク切れ、ID 形式違反、空のセクション、孤立した成果物、件数／相互参照の不一致、未定義の略語、混在した ID 表記、存在しないドキュメントへの前方参照を検出し、それぞれに重大度と修正案を示します。
4. 累積タグ付けを検証します。成果物に、そのレイヤーで必要な上流のタグファミリーだけが正確に付与されていること（BRD 0 → … → IPLAN 7）、欠落がなく、下流のタグがないことを確認します。
5. 命名を確認します。ドキュメント ID TYPE-NN、要素 ID TYPE.NN.SS.xxxx、しきい値タグ、ファイル名スラッグを確認し、../doc-naming/SKILL.md および ${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md に従います。従来のパターンがあれば指摘します。
6. 品質レポートを生成します。全体のステータスとスコア、エラー／警告／情報の件数、領域ごとの結果、優先順位を付けた推奨事項と次のステップ（通常は、まずエラーを修正し、その後 ../doc-validator/SKILL.md を実行）を示します。

このフレームワークにはランタイムコードは含まれていません。このスキル自体がチェッカーであり、仕様に対して上記の宣言的なチェックを適用します。

関連リソース

• レイヤーレジストリとタグルール：${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml
• ID とタグの標準：${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md
• レイヤーの README：${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/README.md · ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/README.md
• 命名：../doc-naming/SKILL.md
• 作成後の検証：../doc-validator/SKILL.md · レイヤーの -audit スキル （例：../doc-prd-audit/SKILL.md）
• ルーティングと次のステップ：../doc-flow/SKILL.md