zhongwei/gh-masseater-claude-code-plugin-sdd

Fork 0

Files

Zhongwei Li f2613ae15b Initial commit

2025-11-30 08:39:29 +08:00

5.4 KiB

Raw Permalink Blame History

argument-hint, description, allowed-tools

argument-hint

description

allowed-tools

<計画の説明>

タスクの基本骨格を作成（ディレクトリとoverview.mdのみ）

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. ディレクトリの確認と作成

現在のディレクトリに specs/ フォルダが存在するか確認
存在しない場合は、AskUserQuestionツールで「specs/ フォルダを作成してもよろしいですか？」と確認
確認が取れたら specs/[taskname]/ ディレクトリを作成

4. overview.mdの生成

specs/[taskname]/overview.md を生成：

# [タスク名]

## 目的
[計画内容から「何を達成したいのか」を1-3行で記述]

## スコープ
### 含まれるもの
- [計画内容から抽出]

### 含まれないもの
- [計画内容から明示的に除外されているもの]
- [ステアリングドキュメント（product.md）のNon-Goalsから関連するもの]

## 想定される成果物
- [成果物1]
- [成果物2]
- [成果物3]

---

**次のステップ**: `/sdd:plan-implementation [taskname]` で実装概要と調査項目を特定してください

生成時の注意点:

計画内容が曖昧な場合でも、無理に詳細化しない
不明な点は「不明」と明記
ステアリングドキュメントの情報を積極的に活用
実装概要、調査項目、技術スタックは含めない（plan-implementationで追加）

5. 完了報告

✅ タスクの基本骨格を作成しました
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 作成先: specs/[taskname]/
📝 作成ファイル: overview.md

💡 次のアクション:
   - 実装概要と調査項目の特定: `/sdd:plan-implementation [taskname]`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

注意事項

⚠️ 重要: このコマンドは最小限の情報（目的、スコープ、成果物）のみ作成します
⚠️ 重要: 実装概要と調査項目は /sdd:plan-implementation で追加してください
⚠️ 重要: ステアリングドキュメント（specs/_steering/）を必ず読み込み、プロジェクトのコンテキストを反映してください
⚠️ 重要 不明なところは勝手に決めずに「不明」と明記すること
「将来的に必要になる」「今後〜が必要」といった適当な推測に基づいた記述は禁止
現時点で明確に必要なことのみを記載すること

内部品質チェック

重要: 以下のチェックはコマンド内部で実施し、生成されるspecファイルには結果を記載しません。

ステアリングドキュメントレビュー（内部処理）

ドキュメント生成後、内部的にステアリングドキュメントとの整合性を確認：

product.mdのビジネス目標とタスク目的の整合性
structure.mdのプロジェクト構造との整合性
principles.mdの開発原則との一致

問題がある場合のみユーザーに修正を促す。準拠している場合は何も出力しない。

5.4 KiB Raw Permalink Blame History Unescape Escape