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

126
commands/init-task.md Normal file
View File

@@ -0,0 +1,126 @@
---
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の開発原則との一致
問題がある場合のみユーザーに修正を促す。準拠している場合は何も出力しない。