7.1 KiB
7.1 KiB
argument-hint
| argument-hint |
|---|
| <taskname> |
次に実行すべきステップを提案
現在のタスクの状態を分析して、次に実行すべきコマンドを提案します。
【引数】 $ARGUMENTS
引数の形式
<taskname>- タスク名（省略時: specs/配下から選択）
実行手順
1. タスクの特定
引数が指定されている場合
specs/{taskname}/ディレクトリの存在を確認- 存在しない場合はエラーメッセージとspecs/配下のタスク一覧を表示
引数が指定されていない場合
specs/配下のタスクをリスト表示- AskUserQuestionで選択
2. タスクの状態分析
以下のファイルとディレクトリを確認して、タスクの進捗状況を判定：
仕様書ファイルの存在確認
specs/{taskname}/overview.mdspecs/{taskname}/specification.mdspecs/{taskname}/technical-details.md
仕様書の完成度チェック
- 「不明」マークの有無
- 複数の案（案A、案B等）の有無
- Phase概要と依存関係セクションの有無
Phase計画書の存在確認
specs/{taskname}/tasks/ディレクトリの存在- Phase計画書ファイル（
phase{N}-*.md）の存在
Phase進捗の確認
各Phase計画書から：
- タスクの状態（未着手/進行中/完了）
- Phase状態（未着手/進行中/完了）
- Phase完了条件のチェック状況
overview.mdのPhase状態
- 各Phaseの状態
- 依存関係の満たし方
3. 状態に基づく判定
分析結果から、タスクがどの段階にあるかを判定：
状態1: 仕様書が存在しない
→ 新規タスクの作成段階
状態2: 仕様書は存在するが不完全
- 「不明」マークがある
- 複数の案が残っている → 仕様の明確化が必要
状態3: 仕様書は完成しているがPhase計画書がない
→ Phase分割計画が必要
状態4: Phase計画書は存在するが未着手
→ 実装開始が必要
状態5: Phase実装中
- 進行中または完了したタスクがある
- すべてのタスクは完了していない → 実装継続または仕様書同期が必要
状態6: Phase完了（Phase完了条件未チェック）
- すべてのタスクが完了
- Phase完了条件がチェックされていない → Phase検証が必要
状態7: Phase検証済み（次Phaseあり）
- Phase完了条件がすべてチェック済み
- overview.mdで次Phaseが定義されている → 次Phaseの実装開始
状態8: すべてのPhase完了
- すべてのPhaseが完了状態 → タスク完了
4. 提案の表示
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎯 次のステップ提案
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 タスク: {taskname}
## 現在の状態
{状態の詳細説明}
### 仕様書の状態
- overview.md: {存在/不完全/完成}
- specification.md: {存在/不完全/完成}
- technical-details.md: {存在/不完全/完成}
- 不明点: {数}箇所
- 複数案: {数}箇所
### Phase進捗
- Phase 1: {状態} - タスク完了: {completed}/{total}
- Phase 2: {状態} - タスク完了: {completed}/{total}
- ...
### Phase完了条件
- Phase 1: {checked}/{total} 項目
- Phase 2: {checked}/{total} 項目
- ...
## 💡 次に実行すべきコマンド
### 推奨: {コマンド名}
**コマンド**:
{実行すべきコマンド}
**理由**:
{なぜこのコマンドを実行すべきか}
**実行後**:
{このコマンド実行後に何が得られるか}
---
### 代替案（オプション）
**1. {代替コマンド名}**
{代替コマンド}
{理由と実行後の状態}
**2. {代替コマンド名}**
{代替コマンド}
{理由と実行後の状態}
---
## 📚 ワークフロー全体を確認したい場合
/sdd:help
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
5. 状態別の提案例
状態1の場合（仕様書が存在しない）
推奨: /sdd:create-specs
- 理由: タスクの仕様書がまだ作成されていません
- 実行後: overview.md、specification.md、technical-details.mdが生成されます
状態2の場合（仕様書は存在するが不完全）
推奨: /sdd:clarify-spec {taskname}
- 理由: 仕様書に{N}箇所の不明点があります
- 実行後: 不明点が明確化され、仕様が確定します
代替案:
/sdd:contradiction-check {taskname}- 仕様の整合性を先に確認/sdd:validate-feasibility {taskname}- 実現可能性を先に検証
状態3の場合（仕様書は完成しているがPhase計画書がない）
推奨: /sdd:break-down-phase {taskname}
- 理由: 仕様書は完成していますが、Phase別の実装計画がありません
- 実行後: specs/{taskname}/tasks/配下にPhase計画書が生成されます
状態4の場合（Phase計画書は存在するが未着手）
推奨: /sdd:implement-phase {taskname}
- 理由: Phase計画書は作成されていますが、実装が開始されていません
- 実行後: Phase 1のタスク1から実装が開始されます
状態5の場合（Phase実装中）
推奨: /sdd:implement-phase {taskname} {current_phase}.{next_task}
- 理由: Phase {current_phase}の実装が進行中です（{completed}/{total}タスク完了）
- 実行後: 次のタスク{next_task}の実装を続けます
代替案:
/sdd:sync-specs- 作業を中断する前に現在の進捗を仕様書に記録
状態6の場合（Phase完了、検証待ち）
推奨: /sdd:verify-phase {taskname} {phase}
- 理由: Phase {phase}のすべてのタスクが完了しましたが、検証がまだです
- 実行後: Phase完了条件が検証され、問題があれば指摘されます
状態7の場合（Phase検証済み、次Phaseあり）
推奨: /sdd:implement-phase {taskname} {next_phase}.1
- 理由: Phase {current_phase}が完了し、次のPhase {next_phase}に進めます
- 実行後: Phase {next_phase}の実装が開始されます
状態8の場合（すべてのPhase完了）
🎉 おめでとうございます！
タスク「{taskname}」のすべてのPhaseが完了しました。
## 完了したPhase
- Phase 1: {name} ✅
- Phase 2: {name} ✅
- Phase 3: {name} ✅
...
## 次のアクション
- プロジェクトのデプロイやリリース準備
- 新しいタスクの開始: `/sdd:create-specs`
注意事項
- ⚠️ 重要: このコマンドは提案のみを行い、実際のコマンドは実行しません
- ⚠️ 重要: 提案は現在のファイル状態から推測したものであり、必ずしも最適とは限りません
- 複数の選択肢がある場合、プロジェクトの状況に応じて判断してください
- Phase順序や依存関係を考慮して提案しますが、並行作業が可能な場合もあります