Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:39:29 +08:00
commit f2613ae15b
26 changed files with 5240 additions and 0 deletions

102
commands/verify-phase.md Normal file
View File

@@ -0,0 +1,102 @@
---
argument-hint: <taskname> <phase番号>
allowed-tools: SlashCommand(/sdd:verify:docs:*), SlashCommand(/sdd:verify:requirements:*), SlashCommand(/sdd:verify:quality:*)
---
# Phase統合検証ドキュメント・要件・品質の一括検証
指定したPhaseの検証を統合的に実行します。以下の3つのコマンドを順次実行し、総合的な検証レポートを生成します。
【引数】
$ARGUMENTS
## 引数の形式
- `<taskname>` - タスク名specs/[taskname]/ディレクトリ)
- `<phase番号>` - 検証対象のPhase番号1, 2, 3...
## 実行内容
このコマンドは以下の3つのコマンドを順次実行します
### 1. `/sdd:verify:docs {taskname} {phase番号}`
Phase計画書とドキュメントの検証
- タスク完了状況
- Phase完了条件
- overview.mdとの整合性
- 次Phaseへの引き継ぎ事項
- Phase間のドキュメント整合性
### 2. `/sdd:verify:requirements {taskname} {phase番号}`
要件と実装の整合性検証:
- specification.mdとの整合性機能要件・非機能要件
- technical-details.mdとの整合性技術スタック・データ設計・API設計
- Phase間の実装整合性成果物の存在・使用状況・インターフェース
- 機能レベルの実装検証
### 3. `/sdd:verify:quality {taskname} {phase番号}`
品質検証:
- コーディング規約any型禁止、barrel禁止、interface使用
- テストの存在と実行
- 品質チェックコマンドlint、type-check、build
- Phase間の実装品質
## 検証手順
1. **引数の確認**
- タスク名とPhase番号が指定されているか確認
- 未指定の場合はAskUserQuestionで確認
2. **3つのコマンドを順次実行**
- 各コマンドの実行結果を内部で記録
- エラーが発生した場合も継続して次のコマンドを実行
3. **検証結果の内部処理と報告**
- 3つのコマンドの結果を内部で統合
- 総合評価を決定すべて✅なら✅、1つでも❌なら❌、それ以外は⚠
- **検証レポートはspecファイルに書かず、ユーザーに直接表示**
## 問題への対応
統合検証の結果、問題が見つかった場合:
- 各検証コマンドが個別に対応方針を確認
- 統合レポートではすべての問題をまとめて表示
- ユーザーが個別に再検証するか、全体を再検証するかを選択可能
## overview.md更新提案
総合評価が ✅ の場合のみ、AskUserQuestionで確認
- 「overview.mdのPhase状態を『完了』に更新しますか
- 承認された場合、overview.mdの該当Phaseの状態を「完了」に更新
## 完了報告
```
✅ Phase {N} の統合検証が完了しました
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 対象: specs/{taskname}/ - Phase {N}
📊 総合評価: {✅/⚠️/❌}
💡 次のアクション:
- Phase完了可能: `/sdd:implement-phase {taskname} {N+1}.1`
- 問題あり: 個別再検証または修正
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```
## 注意事項
- 3つの検証コマンドを順次実行する統合コマンド
- 各検証で問題が見つかっても、すべての検証を完了してから報告
- 問題の対応は各検証コマンドで個別に行うか、統合検証後にまとめて対応
## 内部品質チェック
**重要**: 以下のチェックはコマンド内部で実施し、**検証レポートはspecファイルに書きません**。
### 矛盾チェック(内部処理)
Phase検証後、内部的に仕様書間の矛盾を確認
- Phase完了状態とタスク完了状態の整合性
- ドキュメント間の整合性
- 実装と仕様の整合性
矛盾がある場合のみユーザーに警告を表示。問題がなければ何も出力しない。