ユーザー入力
$ARGUMENTS
先に進む前に、ユーザーの入力を考慮する必要があります(空でない場合)。
実行前チェック
拡張フックの確認(仕様書作成前):
- プロジェクトルートに
.specify/extensions.ymlが存在するか確認します。 - 存在する場合は読み取り、
hooks.before_specifyキー以下のエントリを探します。 - 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が存在しない場合は、黙ってスキップします。
アウトライン
トリガーメッセージでユーザーが /speckit-specify の後に入力したテキストが機能説明です。この会話では $ARGUMENTS がリテラルに表示されている場合でも、常に利用可能であると想定します。ユーザーが空のコマンドを提供した場合を除き、入力を繰り返すように求めないでください。
その機能説明に基づいて、以下の手順を実行します:
-
簡潔な短い名前を生成します(2〜4語):
- 機能説明を分析し、最も意味のあるキーワードを抽出します。
- 機能の本質を捉えた2〜4語の短い名前を作成します。
- 可能な場合は「アクション-名詞」形式を使用します(例: "add-user-auth", "fix-payment-bug")。
- 技術用語や頭字語(OAuth2、API、JWTなど)はそのまま保持します。
- 簡潔でありながら、機能をひと目で理解できる程度に説明的であること。
- 例:
- "ユーザー認証を追加したい" → "user-auth"
- "APIにOAuth2統合を実装する" → "oauth2-api-integration"
- "分析用のダッシュボードを作成する" → "analytics-dashboard"
- "支払い処理のタイムアウトバグを修正する" → "fix-payment-timeout"
-
ブランチ作成(フック経由、オプション):
上記の実行前チェックで
before_specifyフックが正常に実行された場合、gitブランチを作成/切り替え、BRANCH_NAMEとFEATURE_NUMを含むJSONを出力します。これらの値は参考のために記録しますが、ブランチ名がスペックディレクトリ名を決定するわけではありません。ユーザーが明示的に
GIT_BRANCH_NAMEを指定した場合は、その値をそのままフックに渡し、ブランチスクリプトがその正確な値をブランチ名として使用するようにします(すべてのプレフィックス/サフィックス生成をバイパスします)。 -
スペック機能ディレクトリを作成します:
ユーザーが明示的に
SPECIFY_FEATURE_DIRECTORYを指定しない限り、スペックはデフォルトのspecs/ディレクトリに配置されます。SPECIFY_FEATURE_DIRECTORYの解決順序:- ユーザーが明示的に
SPECIFY_FEATURE_DIRECTORYを指定した場合(例:環境変数、引数、設定)、その値を使用します。 - それ以外の場合は、
specs/配下に自動生成します:.specify/init-options.jsonでfeature_numbering(推奨)またはbranch_numbering(非推奨、移行のみ—将来のリリースで削除されます)を確認します。"timestamp"の場合: プレフィックスはYYYYMMDD-HHMMSS(現在のタイムスタンプ)です。"sequential"または指定がない場合: プレフィックスはNNN(specs/内の既存ディレクトリをスキャンした後の次に利用可能な3桁の数字)です。- ディレクトリ名を
<プレフィックス>-<短い名前>として構築します(例:003-user-authまたは20260319-143022-user-auth)。 SPECIFY_FEATURE_DIRECTORYをspecs/<ディレクトリ名>に設定します。branch_numberingが使用されていて(かつfeature_numberingがない場合)、1行の警告を出力します: "⚠️ init-options.json のbranch_numberingは非推奨です。feature_numberingに名前を変更してください。"
ディレクトリとスペックファイルを作成します:
mkdir -p SPECIFY_FEATURE_DIRECTORY- Spec Kitのプリセット/テンプレート解決スタックを介してアクティブな
spec-templateを解決します(specify preset resolve spec-templateと同等)。 - 解決された
spec-templateファイルをSPECIFY_FEATURE_DIRECTORY/spec.mdに開始点としてコピーします。 SPEC_FILEをSPECIFY_FEATURE_DIRECTORY/spec.mdに設定します。- 解決されたパスを
.specify/feature.jsonに永続化します:実際の解決されたディレクトリパス値(例:{ "feature_directory": "<解決された機能ディレクトリ>" }specs/003-user-auth)を書き込みます。リテラル文字列SPECIFY_FEATURE_DIRECTORYではありません。 これにより、ダウンストリームコマンド(/speckit-plan,/speckit-tasksなど)がgitブランチ名の規則に依存せずに機能ディレクトリを特定できるようになります。
重要:
/speckit-specifyの呼び出しごとに1つの機能のみ作成する必要があります。- スペックディレクトリ名とgitブランチ名は独立しています—同じであっても構いませんが、それはユーザーの選択です。
- スペックディレクトリとファイルは常にこのコマンドによって作成され、フックによって作成されることはありません。
- ユーザーが明示的に
-
解決されたアクティブな
spec-templateファイルを読み込み、必須セクションを理解します。 -
存在する場合: プロジェクトの原則とガバナンスの制約について
.specify/memory/constitution.mdを読み込みます。 -
以下の実行フローに従います:
- 引数からユーザーの説明を解析します。 空の場合: エラー 「機能説明が指定されていません」
- 説明から主要な概念を抽出します。 特定: アクター、アクション、データ、制約
- 不明瞭な点について:
- 文脈と業界標準に基づいて、十分な情報に基づいた推測を行います。
- 以下の場合にのみ [NEEDS CLARIFICATION: 具体的な質問] でマークします:
- 選択が機能の範囲やユーザー体験に大きく影響する場合
- 結果が異なる複数の合理的な解釈が存在する場合
- 合理的なデフォルトが存在しない場合
- 制限: [NEEDS CLARIFICATION] マーカーは合計で最大3つ
- 明確化の優先順位は影響度に基づく: 範囲 > セキュリティ/プライバシー > ユーザー体験 > 技術詳細
- ユーザーシナリオとテストのセクションを埋めます。 明確なユーザーフローがない場合: エラー 「ユーザーシナリオを決定できません」
- 機能要件を生成します。 各要件はテスト可能である必要があります。 指定されていない詳細については合理的なデフォルトを使用します(前提条件セクションに文書化)。
- 成功基準を定義します。 測定可能で、技術に依存しない成果を作成します。 定量的な指標(時間、パフォーマンス、ボリューム)と定性的な尺度(ユーザー満足度、タスク完了度)の両方を含めます。 各基準は実装の詳細なしで検証可能である必要があります。
- 主要エンティティを特定します(データが関係する場合)。
- 結果を返す: 成功(計画の準備ができた仕様)
-
テンプレート構造を使用して仕様を
SPEC_FILEに書き込み、プレースホルダーを機能説明(引数)から導出された具体的な詳細に置き換えながら、セクションの順序と見出しを維持します。 -
仕様品質の検証: 初期仕様を記述した後、品質基準に対して検証します:
a. 仕様品質チェックリストの作成: チェックリストテンプレート構造を使用して、
SPECIFY_FEATURE_DIRECTORY/checklists/requirements.mdにチェックリストファイルを生成します。検証項目は以下の通り:# 仕様品質チェックリスト: [機能名] **目的**: 計画に進む前に仕様の完全性と品質を検証します **作成日**: [日付] **機能**: [spec.mdへのリンク] ## コンテンツ品質 - [ ] 実装の詳細(言語、フレームワーク、API)がない - [ ] ユーザー価値とビジネスニーズに焦点を当てている - [ ] 非技術的な利害関係者向けに記述されている - [ ] すべての必須セクションが完了している ## 要件の完全性 - [ ] [NEEDS CLARIFICATION] マーカーが残っていない - [ ] 要件はテスト可能で曖昧さがない - [ ] 成功基準は測定可能である - [ ] 成功基準は技術に依存しない(実装の詳細がない) - [ ] すべての受け入れシナリオが定義されている - [ ] エッジケースが特定されている - [ ] 範囲が明確に境界づけられている - [ ] 依存関係と前提条件が特定されている ## 機能の準備状態 - [ ] すべての機能要件に明確な受け入れ基準がある - [ ] ユーザーシナリオが主要なフローをカバーしている - [ ] 機能が成功基準で定義された測定可能な成果を満たしている - [ ] 実装の詳細が仕様に漏れていない ## メモ - 未完了とマークされた項目は、`/speckit-clarify` または `/speckit-plan` の前に仕様の更新が必要ですb. 検証チェックの実行: 各チェックリスト項目に対して仕様をレビューします:
- 各項目について、合格か不合格かを判断します。
- 見つかった具体的な問題を文書化します(関連する仕様セクションを引用)。
c. 検証結果の処理:
-
すべての項目に合格した場合: チェックリストを完了としてマークし、必須の実行後フックセクションに進みます。
-
不合格の項目がある場合([NEEDS CLARIFICATION] を除く):
- 不合格の項目と具体的な問題をリストアップします。
- 各問題に対処するために仕様を更新します。
- すべての項目に合格するまで検証を再実行します(最大3回)。
- 3回の反復後もまだ合格しない場合は、残りの問題をチェックリストのメモに文書化し、ユーザーに警告します。
-
[NEEDS CLARIFICATION] マーカーが残っている場合:
-
仕様からすべての [NEEDS CLARIFICATION: ...] マーカーを抽出します。
-
制限チェック: マーカーが3つを超える場合は、最も重要な3つ(範囲/セキュリティ/UXへの影響に基づく)のみを保持し、残りについては十分な情報に基づいた推測を行います。
-
必要な明確化ごとに(最大3つ)、以下の形式でオプションをユーザーに提示します:
## 質問 [N]: [トピック] **コンテキスト**: [関連する仕様セクションを引用] **把握すべきこと**: [NEEDS CLARIFICATION マーカーからの具体的な質問] **提案される回答**: | オプション | 回答 | 影響 | |------------|------|------| | A | [最初の提案回答] | [機能にとっての意味] | | B | [2番目の提案回答] | [機能にとっての意味] | | C | [3番目の提案回答] | [機能にとっての意味] | | カスタム | 独自の回答を提供 | [カスタム入力の提供方法を説明] | **あなたの選択**: _[ユーザーの応答を待つ]_ -
重要 - テーブル形式: マークダウンテーブルが適切にフォーマットされていることを確認します:
- パイプを揃えた一貫したスペーシングを使用します。
- 各セルには内容の周りにスペースを入れます:
| コンテンツ |ではなく|コンテンツ| - ヘッダー区切りには少なくとも3つのダッシュが必要です:
|--------| - テーブルがマークダウンプレビューで正しくレンダリングされることをテストします。
-
質問に順番に番号を付けます(Q1、Q2、Q3 - 合計最大3つ)。
-
応答を待つ前に、すべての質問を一緒に提示します。
-
ユーザーがすべての質問に対する選択を応答するのを待ちます(例: 「Q1: A、Q2: カスタム - [詳細]、Q3: B」)。
-
各 [NEEDS CLARIFICATION] マーカーをユーザーが選択または提供した回答で置き換えて、仕様を更新します。
-
すべての明確化が解決された後、検証を再実行します。
-
d. チェックリストの更新: 各検証反復の後、チェックリストファイルを現在の合格/不合格ステータスで更新します。
必須の実行後フック
ユーザーに完了を報告する前に、このセクションを完了する必要があります。
プロジェクトルートに .specify/extensions.yml が存在するか確認します。
- 存在しない場合、または
hooks.after_specifyの下にフックが登録されていない場合は、完了報告にスキップします。 - 存在する場合は読み取り、
hooks.after_specifyキー以下のエントリを探します。 - 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} [truncated for translation]
- 必須フック (