127 lines
5.4 KiB
Markdown
127 lines
5.4 KiB
Markdown
---
|
||
argument-hint: <計画の説明>
|
||
description: タスクの基本骨格を作成（ディレクトリとoverview.mdのみ）
|
||
allowed-tools: ["Read", "Write", "Task"]
|
||
---
|
||
|
||
# タスクの基本骨格を作成します
|
||
|
||
計画の説明をもとに、タスクの基本骨格（ディレクトリとoverview.md）を作成します。
|
||
|
||
**重要**: このコマンドは最小限の情報のみ作成します。実装概要と調査項目は `/sdd:plan-implementation` で追加してください。
|
||
|
||
【計画内容】
|
||
$ARGUMENTS
|
||
|
||
## 実行手順
|
||
|
||
### 0. ステアリングドキュメントの読み込み
|
||
|
||
以下のステアリングドキュメントを読み込み、プロジェクトのコンテキストを把握：
|
||
|
||
- `specs/_steering/product.md` - プロダクト方針
|
||
- `specs/_steering/tech.md` - 技術スタック
|
||
- `specs/_steering/structure.md` - プロジェクト構造
|
||
- `specs/_steering/principles.md` - 開発原則
|
||
|
||
**ステアリングドキュメントが存在しない場合**:
|
||
- 警告メッセージを表示: 「⚠️ ステアリングドキュメントが見つかりません。先に `/sdd:steering` を実行することを推奨します。」
|
||
- AskUserQuestionツールで確認:
|
||
- 「ステアリングドキュメントなしで続行しますか？」
|
||
- 選択肢: 「はい（続行）」「いいえ（中断して /sdd:steering を実行）」
|
||
- 「いいえ」の場合は処理を中断
|
||
|
||
### 1. 引数チェック
|
||
|
||
`$ARGUMENTS` が空の場合：
|
||
- `specs/` ディレクトリ配下の既存タスク一覧（ディレクトリ名）を取得
|
||
- タスクが存在する場合、AskUserQuestionツールで「どのタスクに着手しますか？」と質問し、選択させる
|
||
- タスクが存在しない場合、「specs/配下にタスクがありません。計画内容を入力してください」とユーザーに伝える
|
||
- 選択されたタスクは既存のため、処理を終了（既存タスクの初期化は不要）
|
||
|
||
`$ARGUMENTS` が指定されている場合：
|
||
- タスク名生成（手順2）へ進む
|
||
|
||
### 2. タスク名の生成
|
||
|
||
計画内容から適切なタスク名（ディレクトリ名）を生成：
|
||
|
||
- プロジェクト内容を端的に表す英数字とハイフンのみの名前
|
||
- 例: `user-authentication`, `payment-integration`, `admin-dashboard`, `api-v2-migration`
|
||
- 生成したタスク名をユーザーに提示し、**AskUserQuestionツールで確認**を取る
|
||
|
||
### 3. ディレクトリの確認と作成
|
||
|
||
1. 現在のディレクトリに `specs/` フォルダが存在するか確認
|
||
2. 存在しない場合は、**AskUserQuestionツールで**「specs/ フォルダを作成してもよろしいですか？」と確認
|
||
3. 確認が取れたら `specs/[taskname]/` ディレクトリを作成
|
||
|
||
### 4. overview.mdの生成
|
||
|
||
`specs/[taskname]/overview.md` を生成：
|
||
|
||
```markdown
|
||
# [タスク名]
|
||
|
||
## 目的
|
||
[計画内容から「何を達成したいのか」を1-3行で記述]
|
||
|
||
## スコープ
|
||
### 含まれるもの
|
||
- [計画内容から抽出]
|
||
|
||
### 含まれないもの
|
||
- [計画内容から明示的に除外されているもの]
|
||
- [ステアリングドキュメント（product.md）のNon-Goalsから関連するもの]
|
||
|
||
## 想定される成果物
|
||
- [成果物1]
|
||
- [成果物2]
|
||
- [成果物3]
|
||
|
||
---
|
||
|
||
**次のステップ**: `/sdd:plan-implementation [taskname]` で実装概要と調査項目を特定してください
|
||
```
|
||
|
||
**生成時の注意点**:
|
||
- 計画内容が曖昧な場合でも、無理に詳細化しない
|
||
- 不明な点は「**不明**」と明記
|
||
- ステアリングドキュメントの情報を積極的に活用
|
||
- **実装概要、調査項目、技術スタックは含めない**（plan-implementationで追加）
|
||
|
||
### 5. 完了報告
|
||
|
||
```markdown
|
||
✅ タスクの基本骨格を作成しました
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
📍 作成先: specs/[taskname]/
|
||
📝 作成ファイル: overview.md
|
||
|
||
💡 次のアクション:
|
||
- 実装概要と調査項目の特定: `/sdd:plan-implementation [taskname]`
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
```
|
||
|
||
## 注意事項
|
||
|
||
- **⚠️ 重要**: このコマンドは最小限の情報（目的、スコープ、成果物）のみ作成します
|
||
- **⚠️ 重要**: 実装概要と調査項目は `/sdd:plan-implementation` で追加してください
|
||
- **⚠️ 重要**: ステアリングドキュメント（`specs/_steering/`）を必ず読み込み、プロジェクトのコンテキストを反映してください
|
||
- **⚠️ 重要** 不明なところは勝手に決めずに「**不明**」と明記すること
|
||
- 「将来的に必要になる」「今後〜が必要」といった適当な推測に基づいた記述は禁止
|
||
- 現時点で明確に必要なことのみを記載すること
|
||
|
||
## 内部品質チェック
|
||
|
||
**重要**: 以下のチェックはコマンド内部で実施し、**生成されるspecファイルには結果を記載しません**。
|
||
|
||
### ステアリングドキュメントレビュー（内部処理）
|
||
|
||
ドキュメント生成後、内部的にステアリングドキュメントとの整合性を確認：
|
||
- product.mdのビジネス目標とタスク目的の整合性
|
||
- structure.mdのプロジェクト構造との整合性
|
||
- principles.mdの開発原則との一致
|
||
|
||
問題がある場合のみユーザーに修正を促す。準拠している場合は何も出力しない。
|