sdd-checklist

要件品質チェックリスト

--strict 検証で証明できるのは、仕様の形式が正しいことです。仕様が十分に明確であることまでは証明できません。 このスキルは、変更に合わせたチェックリストを生成し、それに照らして変更を評価します。これにより、明確さや網羅性の不足をコードを書く前に明らかにできます。レビュー時に初めて見つかることはありません。

使用するタイミング

• sdd-feature-flow の人による承認ゲートで、仕様を承認するか判断するとき。
• /opsx:apply の実行前、または重要な変更の実装を開始する前。

手順

1. 変更内容を読む：openspec/changes/<id>/proposal.md、design.md、tasks.md、および差分仕様書を確認します。openspec/project.md（憲章）が存在する場合は、それも確認します。
2. チェックリストを生成する：変更箇所に合わせて作成します。少なくとも次の項目を網羅してください。
   • 完全性 — 明記されたすべての要件が、設計とタスクの両方で扱われていますか？正常系だけでなく、エラー、空の状態、境界ケースも仕様化されていますか？対象外の項目は明示されていますか？
   • 明確さ — 各要件は検証可能で、曖昧さがありませんか（SHALL／MUST、具体的な値）？実質的な判断を隠す「おそらく～すべき」「TBD」「など」はありませんか？
   • 一貫性 — 提案、設計、タスク、差分仕様の内容は一致していますか？範囲、データモデル、命名に矛盾はありませんか？憲章に違反する項目はありませんか？
   • テスト可能性 — 要件が満たされなかった場合に失敗するシナリオまたはタスクが、それぞれにありますか？検証方法は具体的ですか？
   • 前提条件 — 重大な影響を及ぼす前提条件はすべて確認済み、または未解決の質問として明示されていますか（暗黙のまま組み込まれていませんか）？
3. 各項目を評価する：合格／不合格／該当なしとし、理由を1行で記載します。不合格項目を先に並べます。
4. 推奨事項を示す：そのまま承認、記載した修正を条件に承認、または修正のため差し戻しのいずれかを推奨します。

出力

コンパクトな表（項目・判定・理由）を作成します。不合格項目を先に並べ、その後に1行で推奨事項を示します。 読み取り専用です。このスキルはファイルを変更せず、チェックリストと判定を出力します。