224 lines
6.7 KiB
Markdown
224 lines
6.7 KiB
Markdown
---
|
||
description: すべてのspecの一覧とステータスを表示し、specs/status.mdに保存
|
||
---
|
||
|
||
# spec一覧とステータスの表示・保存
|
||
|
||
`specs/` ディレクトリ配下のすべてのタスクを走査し、各タスクの進捗状況を集計して `specs/status.md` に保存します。
|
||
|
||
## 実行手順
|
||
|
||
### 1. specs/ディレクトリの確認
|
||
|
||
- `specs/` ディレクトリの存在を確認
|
||
- 存在しない場合は、空のステータスファイルを作成して終了
|
||
|
||
### 2. タスク情報の収集
|
||
|
||
各タスクディレクトリ（`specs/*/`）について、以下の情報を収集：
|
||
|
||
**⚠️ 重要**: `specs/_archived/` 配下のタスクは完全に無視します（アーカイブ済みタスクはノイズ）
|
||
|
||
#### 2.1 基本情報の取得
|
||
- タスク名（ディレクトリ名）
|
||
- 最終更新日時（ディレクトリ内のすべてのファイルの最新mtime）
|
||
|
||
#### 2.2 仕様書の存在確認
|
||
- `overview.md` の存在
|
||
- `specification.md` の存在
|
||
- `technical-details.md` の存在
|
||
|
||
#### 2.3 Phase情報の取得
|
||
|
||
**overview.mdから**:
|
||
- プロジェクト概要（「## プロジェクト概要」セクションの「目的と背景」または最初の数行を簡潔に取得）
|
||
- Phase数
|
||
- 各Phaseの名前
|
||
- 各Phaseの状態（未着手/進行中/完了）
|
||
|
||
**tasks/ディレクトリから**:
|
||
- Phase計画書（`phase{N}-*.md`）の存在確認
|
||
|
||
#### 2.4 Phase進捗の集計
|
||
|
||
各Phase計画書（`specs/{taskname}/tasks/phase{N}-*.md`）から：
|
||
|
||
**タスク進捗**:
|
||
```markdown
|
||
## タスク一覧
|
||
|
||
| # | タスク名 | 状態 | TDD | 説明 |
|
||
|---|---------|------|-----|------|
|
||
| 1 | ... | ✅完了 | Green | ... |
|
||
| 2 | ... | 🔄進行中 | Red | ... |
|
||
| 3 | ... | ⬜未着手 | - | ... |
|
||
```
|
||
|
||
- 各タスクの状態を集計
|
||
- ✅完了: 完了カウント +1
|
||
- 🔄進行中: 進行中カウント +1
|
||
- ⬜未着手: 未着手カウント +1
|
||
|
||
#### 2.5 タスク全体のステータス判定
|
||
|
||
以下のロジックでタスクのステータスを判定：
|
||
|
||
```
|
||
if 仕様書が存在しない:
|
||
ステータス = "未着手"
|
||
else if すべてのPhaseが完了状態:
|
||
ステータス = "完了"
|
||
else if いずれかのPhaseが進行中または完了:
|
||
ステータス = "進行中"
|
||
else:
|
||
ステータス = "未着手"
|
||
```
|
||
|
||
#### 2.6 次に実行すべきコマンドの判定
|
||
|
||
`/sdd:next-step` コマンドと同様のロジックで判定：
|
||
|
||
- 仕様書が存在しない → `/sdd:create-specs`
|
||
- 仕様書に「**不明**」がある → `/sdd:clarify-spec {taskname}`
|
||
- Phase計画書がない → `/sdd:break-down-phase {taskname}`
|
||
- Phase未着手 → `/sdd:implement-phase {taskname}`
|
||
- Phase進行中 → `/sdd:implement-phase {taskname} {phase}.{next_task}`
|
||
- Phase完了、未検証 → `/sdd:verify-phase {taskname} {phase}`
|
||
- Phase検証済み、次Phaseあり → `/sdd:implement-phase {taskname} {next_phase}.1`
|
||
- すべて完了 → `/sdd:archive-spec`
|
||
|
||
### 3. ステータスファイルの生成
|
||
|
||
#### 3.1 データのソート
|
||
|
||
1. ステータスでグループ化（未着手 → 進行中 → 完了）
|
||
2. 各グループ内で更新日時順（新しい順）にソート
|
||
|
||
#### 3.2 Markdown生成
|
||
|
||
以下のような形式でstatus.mdを生成します。
|
||
|
||
**フォーマット:**
|
||
```markdown
|
||
# SDD Spec Status
|
||
|
||
最終更新: {現在日時}
|
||
|
||
## 次に実施すべきこと
|
||
|
||
{進行中タスクがある場合: 進行中タスクの次のコマンド}
|
||
{進行中タスクがない場合: 最初の未着手タスクの次のコマンド}
|
||
{全て完了の場合: アーカイブを促すメッセージ}
|
||
|
||
## タスク一覧
|
||
|
||
### 🔄 進行中
|
||
|
||
| タスク名 | Phase進捗 | 最終更新 | 次のコマンド |
|
||
|---------|----------|---------|-------------|
|
||
| {taskname} | Phase {N} ({completed}/{total}) | YYYY-MM-DD | `/sdd:implement-phase {taskname} {phase}.{task}` |
|
||
|
||
### ⬜ 未着手
|
||
|
||
| タスク名 | 最終更新 | 次のコマンド |
|
||
|---------|---------|-------------|
|
||
| {taskname} | YYYY-MM-DD | `/sdd:create-specs` |
|
||
|
||
### ✅ 完了
|
||
|
||
| タスク名 | 最終更新 | 次のコマンド |
|
||
|---------|---------|-------------|
|
||
| {taskname} | YYYY-MM-DD | `/sdd:archive-spec` |
|
||
```
|
||
|
||
**作成例:**
|
||
```markdown
|
||
# SDD Spec Status
|
||
|
||
最終更新: 2025-10-31 14:30:00
|
||
|
||
## 次に実施すべきこと
|
||
|
||
`/sdd:implement-phase user-authentication 1.4`
|
||
|
||
## タスク一覧
|
||
|
||
### 🔄 進行中
|
||
|
||
| タスク名 | Phase進捗 | 最終更新 | 次のコマンド |
|
||
|---------|----------|---------|-------------|
|
||
| user-authentication | Phase 1 (3/5) | 2025-10-30 | `/sdd:implement-phase user-authentication 1.4` |
|
||
| payment-integration | Phase 2 (2/7) | 2025-10-29 | `/sdd:implement-phase payment-integration 2.3` |
|
||
|
||
### ⬜ 未着手
|
||
|
||
| タスク名 | 最終更新 | 次のコマンド |
|
||
|---------|---------|-------------|
|
||
| admin-dashboard | 2025-10-28 | `/sdd:create-specs` |
|
||
|
||
### ✅ 完了
|
||
|
||
| タスク名 | 最終更新 | 次のコマンド |
|
||
|---------|---------|-------------|
|
||
| database-setup | 2025-10-27 | `/sdd:archive-spec` |
|
||
```
|
||
|
||
### 4. ファイルの保存
|
||
|
||
- `specs/status.md` に保存
|
||
- `specs/` ディレクトリが存在しない場合は作成
|
||
|
||
### 5. 完了メッセージの表示
|
||
|
||
```
|
||
✅ Specステータスを更新しました
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
📍 保存先: specs/status.md
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
## エラーハンドリング
|
||
|
||
### specs/ディレクトリが存在しない場合
|
||
|
||
```markdown
|
||
⚠️ specs/ディレクトリが見つかりません。
|
||
|
||
specs/ディレクトリを作成して、空のステータスファイルを生成します。
|
||
```
|
||
|
||
→ 空のステータスファイルを作成
|
||
|
||
```markdown
|
||
# SDD Spec Status
|
||
|
||
最終更新: {現在日時}
|
||
|
||
## タスク一覧
|
||
|
||
タスクがまだ作成されていません。
|
||
|
||
新しいタスクを作成するには:
|
||
\```
|
||
/sdd:create-specs
|
||
\```
|
||
```
|
||
|
||
### タスクディレクトリが空の場合
|
||
|
||
- ステータス: "未着手"
|
||
- 次のコマンド: `/sdd:create-specs`
|
||
|
||
### overview.mdが破損している場合
|
||
|
||
- エラーを記録しつつ、他のファイルから可能な限り情報を取得
|
||
- 次のコマンド: `/sdd:clarify-spec {taskname}` （修復を促す）
|
||
|
||
## 注意事項
|
||
|
||
- **⚠️ 重要**: このコマンドは読み取り専用です。既存のspecファイルは変更しません
|
||
- ステータスファイルは完全に再生成されます（手動編集は上書きされます）
|
||
- Phase進捗は各Phase計画書から自動計算されます
|
||
- 「次のコマンド」は推測であり、必ずしも最適とは限りません
|
||
- ファイルのmtimeを基に最終更新日時を判定するため、ファイルコピー時は正確でない場合があります
|