ユーザー入力
$ARGUMENTS
続行する前に、ユーザー入力を必ず考慮しなければなりません(空でない場合)。
事前実行チェック
(タスク生成前の)拡張フックのチェック:
- プロジェクトルートに
.specify/extensions.ymlが存在するか確認します。 - 存在する場合、それを読み込み、
hooks.before_tasksキーのエントリを探します。 - YAML がパースできない、または無効な場合は、黙ってスキップせず、
.specify/extensions.ymlが読み取れなかったこと(パーサーエラーを含む)と、そこで登録されている必須(optional: false)フックを含むどのフックもチェックされなかったことをユーザーに伝え、その後通常通り続行します。 enabledが明示的にfalseに設定されているフックを除外します。enabledフィールドがないフックはデフォルトで有効として扱います。- 残りの各フックについて、フックの
condition式を解釈または評価しようとは試みないでください:- フックに
conditionフィールドがない、または null/空の場合は、そのフックを実行可能として扱います。 - フックが空でない
conditionを定義している場合は、そのフックをスキップし、条件評価は HookExecutor の実装に委ねます。
- フックに
- フックのコマンド名からコマンド呼び出しを構築する際は、ドット(
.)をハイフン(-)に置き換えます。例:speckit.git.commit→/speckit-git-commit。 - 実行可能な各フックについて、その
optionalフラグに基づいて以下を出力します:- オプショナルフック(
optional: true):## 拡張フック **オプショナルプリフック**: {extension} コマンド: `/{command}` 説明: {description} プロンプト: {prompt} 実行方法: `/{command}` - 必須フック(
optional: false):
上記ブロックを出力した後、実際にフックを呼び出し、その終了を待ってから続行しなければなりません。このエージェント/セッションで自分自身がコマンドを実行するのと同じ方法で実行します(呼び出し方法は上記のリテラルな## 拡張フック **自動プリフック**: {extension} 実行中: `/{command}` EXECUTE_COMMAND: {command} フックコマンドの結果を待ってからアウトラインに進んでください。{command}ID と異なる場合があります。例:スキルモードのエージェントでは/skill:speckit-...や$speckit-...として実行します)。ブロックを出力するだけではフックは実行されません。
- オプショナルフック(
- フックが登録されていないか、
.specify/extensions.ymlが存在しない場合は、黙ってスキップします。
アウトライン
-
セットアップ: リポジトリルートから
.specify/scripts/bash/setup-tasks.sh --jsonを実行し、FEATURE_DIR、TASKS_TEMPLATE_CONTENT、TASKS_TEMPLATE、AVAILABLE_DOCS リストをパースします。FEATURE_DIRとTASKS_TEMPLATEは指定されている場合、絶対パスでなければなりません。AVAILABLE_DOCSはFEATURE_DIR配下で利用可能なドキュメント名/相対パスのリストです(例:research.mdやcontracts/)。"I'm Groot"のように引数にシングルクォートが含まれる場合は、エスケープ構文を使用します:例 'I'''m Groot'(可能であればダブルクォート "I'm Groot" を使用)。 -
デザインドキュメントの読み込み: FEATURE_DIR から以下を読み込みます:
- 必須: plan.md(技術スタック、ライブラリ、構造)、spec.md(優先度付きユーザーストーリー)
- オプション: data-model.md(エンティティ)、contracts/(インターフェースコントラクト)、research.md(決定事項)、quickstart.md(テストシナリオ)
- 存在する場合:
.specify/memory/constitution.mdからプロジェクトの原則とガバナンス制約を読み込む - 注:すべてのプロジェクトにすべてのドキュメントがあるわけではありません。利用可能なものに基づいてタスクを生成します。
-
タスク生成ワークフローの実行:
- plan.md を読み込み、技術スタック、ライブラリ、プロジェクト構造を抽出します。
- spec.md を読み込み、優先度(P1、P2、P3など)付きのユーザーストーリーを抽出します。
- data-model.md が存在する場合:エンティティを抽出し、ユーザーストーリーにマッピングします。
- contracts/ が存在する場合:インターフェースコントラクトをユーザーストーリーにマッピングします。
- research.md が存在する場合:セットアップタスクのための決定事項を抽出します。
- ユーザーストーリーごとに整理されたタスクを生成します(以下のタスク生成ルールを参照)。
- ユーザーストーリーの完了順序を示す依存関係グラフを生成します。
- ユーザーストーリーごとに並列実行の例を作成します。
- タスクの完全性を検証します(各ユーザーストーリーに必要なタスクがすべて含まれ、独立してテスト可能であること)。
-
tasks.md の生成: 上記 JSON 出力からの TASKS_TEMPLATE_CONTENT を構造として使用します。TASKS_TEMPLATE_CONTENT を省略する古いセットアップスクリプトとの互換性のため、代わりに TASKS_TEMPLATE を読み込みます。以下を記入します:
- plan.md からの正しい機能名
- フェーズ 1: セットアップタスク(プロジェクト初期化)
- フェーズ 2: 基盤タスク(すべてのユーザーストーリーのブロッキング前提条件)
- フェーズ 3+: ユーザーストーリーごとに1フェーズ(spec.md の優先度順)
- 各フェーズに含まれるもの: ストーリー目標、独立テスト基準、テスト(リクエストがあれば)、実装タスク
- 最終フェーズ: 洗練 & 横断的関心事
- すべてのタスクは厳格なチェックリスト形式に従う必要があります(以下のタスク生成ルールを参照)
- 各タスクの明確なファイルパス
- ストーリー完了順を示す依存関係セクション
- ストーリーごとの並列実行例
- 実装戦略セクション(MVP 優先、段階的デリバリー)
必須の事後実行フック
完了をユーザーに報告する前に、このセクションを必ず完了しなければなりません。
プロジェクトルートに .specify/extensions.yml が存在するか確認します。
- 存在しない場合、または
hooks.after_tasksキーの下にフックが登録されていない場合は、完了レポートに進みます。 - 存在する場合、それを読み込み、
hooks.after_tasksキーのエントリを探します。 - YAML がパースできない、または無効な場合は、黙ってスキップせず、
.specify/extensions.ymlが読み取れなかったこと(パーサーエラーを含む)と、そこで登録されている必須(optional: false)フックを含むどのフックもチェックされなかったことをユーザーに伝え、その後完了レポートに進みます。 enabledが明示的にfalseに設定されているフックを除外します。enabledフィールドがないフックはデフォルトで有効として扱います。- 残りの各フックについて、フックの
condition式を解釈または評価しようとは試みないでください:- フックに
conditionフィールドがない、または null/空の場合は、そのフックを実行可能として扱います。 - フックが空でない
conditionを定義している場合は、そのフックをスキップし、条件評価は HookExecutor の実装に委ねます。
- フックに
- フックのコマンド名からコマンド呼び出しを構築する際は、ドット(
.)をハイフン(-)に置き換えます。例:speckit.git.commit→/speckit-git-commit。 - 実行可能な各フックについて、その
optionalフラグに基づいて以下を出力します:- 必須フック(
optional: false) — 各必須フックに対してEXECUTE_COMMAND:を必ず出力しなければなりません:
上記ブロックを出力した後、実際にフックを呼び出し、その終了を待ってから続行しなければなりません。このエージェント/セッションで自分自身がコマンドを実行するのと同じ方法で実行します(呼び出し方法は上記のリテラルな## 拡張フック **自動フック**: {extension} 実行中: `/{command}` EXECUTE_COMMAND: {command}{command}ID と異なる場合があります。例:スキルモードのエージェントでは/skill:speckit-...や$speckit-...として実行します)。ブロックを出力するだけではフックは実行されません。 - オプショナルフック(
optional: true):## 拡張フック **オプショナルフック**: {extension} コマンド: `/{command}` 説明: {description} プロンプト: {prompt} 実行方法: `/{command}`
- 必須フック(
完了レポート
生成された tasks.md へのパスとサマリーを出力します:
- タスク総数
- ユーザーストーリーごとのタスク数
- 特定された並列化の機会
- 各ストーリーの独立テスト基準
- 提案される MVP スコープ(通常はユーザーストーリー 1 のみ)
- フォーマット検証: すべてのタスクがチェックリスト形式(チェックボックス、ID、ラベル、ファイルパス)に従っていることを確認
タスク生成のコンテキスト: $ARGUMENTS
tasks.md は即座に実行可能でなければなりません - 各タスクは、LLM が追加の文脈なしで完了できるほど具体的である必要があります。
タスク生成ルール
重要: 独立した実装とテストを可能にするため、タスクはユーザーストーリーごとに整理しなければなりません。
テストはオプション: 機能仕様で明示的に要求された場合、またはユーザーが TDD アプローチを要求した場合にのみ、テストタスクを生成します。
チェックリスト形式(必須)
すべてのタスクは厳密に以下の形式に従わなければなりません:
- [ ] [TaskID] [P?] [Story?] 説明(ファイルパスを含む)
形式の構成要素:
- チェックボックス: 常に
- [ ](マークダウンチェックボックス)で始めます - タスク ID: 実行順の連番(T001、T002、T003...)
- [P] マーカー: タスクが並列化可能な場合(異なるファイル、未完了のタスクに依存しない)にのみ含めます
- [Story] ラベル: ユーザーストーリーフェーズのタスクにのみ必須
- 形式: [US1]、[US2]、[US3]など(spec.md のユーザーストーリーに対応)
- セットアップフェーズ: ストーリーラベルなし
- 基盤フェーズ: ストーリーラベルなし
- ユーザーストーリーフェーズ: ストーリーラベル必須
- 洗練フェーズ: ストーリーラベルなし
- 説明: 正確なファイルパスを含む明確なアクション
例:
- ✅ 正しい:
- [ ] T001 実装計画に従ってプロジェクト構造を作成 - ✅ 正しい:
- [ ] T005 [P] src/middleware/auth.py に認証ミドルウェアを実装 - ✅ 正しい:
- [ ] T012 [P] [US1] src/models/user.py に User モデルを作成 - ✅ 正しい:
- [ ] T014 [US1] src/services/user_service.py に UserService を実装 - ❌ 間違い:
- [ ] User モデルを作成(ID とストーリーラベルが欠落) - ❌ 間違い:
T001 [US1] モデルを作成(チェックボックスが欠落) - ❌ 間違い:
- [ ] [US1] User モデルを作成(タスク ID が欠落) - ❌ 間違い:
- [ ] T001 [US1] モデルを作成(ファイルパスが欠落)
タスクの整理
-
ユーザーストーリー(spec.md)から - 主要な整理方法:
- 各ユーザーストーリー(P1、P2、P3...)は独自のフェーズを持つ
- 関連するすべてのコンポーネントをそのストーリーにマッピング:
- そのストーリーに必要なモデル
- そのストーリーに必要なサービス
- そのストーリーに必要なインターフェース/UI
- テストが要求された場合: そのストーリーに固有のテスト
- ストーリーの依存関係をマーク(ほとんどのストーリーは独立しているべき)
-
コントラクトから:
- 各インターフェースコントラクトを → それが提供するユーザーストーリーにマッピング
- テストが要求された場合: 各インターフェースコントラクト → そのストーリーフェーズの実装前のコントラクトテストタスク [P]
-
データモデルから:
- 各エンティティを、それを必要とするユーザーストーリーにマッピング
- エンティティが複数のストーリーにまたがる場合: 最も早いストーリーまたはセットアップフェーズに配置
- リレーションシップ → 適切なストーリーフェーズのサービス層タスク
- data-model.md に制約(最大長、null 許容/必須、enum 値、バリデーションルール)があるフィールドについては、タスクの説明に制約をそのまま引用し、実装時の裁量に委ねないようにします。
-
セットアップ/インフラから:
- 共有インフラ → セットアップフェーズ(フェーズ 1)
- 基盤/ブロッキングタスク → 基盤フェーズ(フェーズ 2)
- ストーリー固有のセットアップ → そのストーリーのフェーズ内
フェーズ構造
- フェーズ 1: セットアップ(プロジェクト初期化)
- フェーズ 2: 基盤(ブロッキング前提条件 - ユーザーストーリーの前に必ず完了する必要がある)
- フェーズ 3+: 優先度順のユーザーストーリー(P1、P2、P3...)
- 各ストーリー内: テスト(要求された場合)→ モデル → サービス → エンドポイント → 統合
- 各フェーズは完全で、独立してテスト可能なインクリメントである必要がある
- 最終フェーズ: 洗練 & 横断的関心事
完了条件
- すべてのフェーズ、タスク ID、ファイルパスを含む tasks.md が生成された
- 拡張フックが上記「必須の事後実行フック」のルールに従ってディスパッチまたはスキップされた
- タスク数、ストーリー内訳、MVP スコープを含む完了レポートがユーザーに報告された