ユーザー入力
$ARGUMENTS
手順を進める前に、ユーザー入力(空でない場合)を必ず考慮してください。
実行前チェック
拡張フックの確認(実装前):
- プロジェクトルートに
.specify/extensions.ymlが存在するか確認します。 - 存在する場合は、それを読み込み、
hooks.before_implementキー配下のエントリを探します。 - 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/check-prerequisites.sh --json --require-tasks --include-tasksを実行し、FEATURE_DIRとAVAILABLE_DOCSリストをパースします。すべてのパスは絶対パスでなければなりません。引数に "I'm Groot" のようなシングルクォートが含まれる場合は、エスケープ構文(例: 'I'''m Groot'、または可能であればダブルクォート "I'm Groot")を使用してください。 -
チェックリストの状態を確認(
FEATURE_DIR/checklists/が存在する場合):-
チェックリストのマーカーは読み取り専用のゲートとして扱います: チェックボックスの状態をスキャンし、ステータスを報告し、必要に応じて進む前に確認を求めます。チェックリストファイルやマーカーは変更しないでください。
-
checklists/requirements.mdは/speckit-specifyと/speckit-clarifyによって管理される組み込みの仕様品質チェックリストです。/speckit-checklistによって生成されるカスタムチェックリストは、レビュー担当者が所有する要件品質レビューの成果物です。 -
カスタムチェックリストの場合、
[x]はレビュー担当者が要件品質の基準を満たしていると判断したことを意味します。実装作業が完了したことを意味するわけではありません。 -
checklists/ディレクトリ内のすべてのチェックリストファイルをスキャンします。 -
各チェックリストについて、以下をカウントします:
- 全項目:
- [ ]または- [X]または- [x]に一致するすべての行 - チェック済み項目:
- [X]または- [x]に一致する行 - 未チェック項目:
- [ ]に一致する行
- 全項目:
-
ステータス表を作成します:
| チェックリスト | 全項目 | チェック済み | 未チェック | ステータス | |----------------|--------|-------------|-----------|----------| | ux.md | 12 | 12 | 0 | ✓ PASS | | test.md | 8 | 5 | 3 | ✗ FAIL | | security.md | 6 | 6 | 0 | ✓ PASS | -
全体のステータスを計算:
- PASS: すべてのチェックリストで未チェック項目が 0
- FAIL: 1 つ以上のチェックリストに未チェック項目がある
-
いずれかのチェックリストに未チェック項目がある場合:
- 未チェック項目数の表を表示します
- 停止し、ユーザーに確認します: 「いくつかのチェックリストに未チェック項目があります。それでも実装を続行しますか?(yes/no)」
- 続行する前にユーザーの応答を待ちます
- ユーザーが "no"、"wait"、"stop" のいずれかを答えた場合、実行を停止します
- ユーザーが "yes"、"proceed"、"continue" のいずれかを答えた場合、ステップ 3 に進みます
-
すべてのチェックリストがチェック済みの場合:
- すべてのチェックリストが合格したことを示す表を表示します
- 自動的にステップ 3 に進みます
-
-
実装コンテキストをロードして分析します:
- 必須: tasks.md を読み込み、完全なタスクリストと実行計画を取得します
- 必須: plan.md を読み込み、技術スタック、アーキテクチャ、ファイル構造を取得します
- 存在する場合: data-model.md を読み込み、エンティティとリレーションシップを取得します
- 存在する場合: contracts/ を読み込み、API 仕様とテスト要件を取得します
- 存在する場合: research.md を読み込み、技術的な決定事項と制約を取得します
- 存在する場合: .specify/memory/constitution.md を読み込み、ガバナンス制約を取得します
- 存在する場合: quickstart.md を読み込み、統合シナリオを取得します
-
プロジェクトセットアップの検証:
- 必須: 実際のプロジェクトセットアップに基づいて、無視ファイルを作成/検証します:
検出および作成ロジック:
-
以下のコマンドが成功するかどうかを確認し、リポジトリが git リポジトリであるかどうかを判断します(その場合、.gitignore を作成/検証します):
git rev-parse --git-dir 2>/dev/null -
Dockerfile* が存在するか、plan.md に Docker の記載があるか確認 → .dockerignore を作成/検証
-
.eslintrc* が存在するか確認 → .eslintignore を作成/検証
-
eslint.config.* が存在するか確認 → 設定の
ignoresエントリが必須パターンをカバーしていることを確認 -
.prettierrc* が存在するか確認 → .prettierignore を作成/検証
-
.npmrc または package.json が存在するか確認 → .npmignore を作成/検証(公開する場合)
-
terraform ファイル (*.tf) が存在するか確認 → .terraformignore を作成/検証
-
.helmignore が必要か確認(Helm チャートが存在する場合)→ .helmignore を作成/検証
無視ファイルが既に存在する場合: 必須パターンが含まれていることを確認し、不足している重要なパターンのみを追加します 無視ファイルが存在しない場合: 検出されたテクノロジーに対応する完全なパターンセットで作成します
テクノロジー別の共通パターン(plan.md の技術スタックに基づく):
- Node.js/JavaScript/TypeScript:
node_modules/,dist/,build/,*.log,.env* - Python:
__pycache__/,*.pyc,.venv/,venv/,dist/,*.egg-info/ - Java:
target/,*.class,*.jar,.gradle/,build/ - C#/.NET:
bin/,obj/,*.user,*.suo,packages/ - Go:
*.exe,*.test,vendor/,*.out - Ruby:
.bundle/,log/,tmp/,*.gem,vendor/bundle/ - PHP:
vendor/,*.log,*.cache,*.env - Rust:
target/,debug/,release/,*.rs.bk,*.rlib,*.prof*,.idea/,*.log,.env* - Kotlin:
build/,out/,.gradle/,.idea/,*.class,*.jar,*.iml,*.log,.env* - C++:
build/,bin/,obj/,out/,*.o,*.so,*.a,*.exe,*.dll,.idea/,*.log,.env* - C:
build/,bin/,obj/,out/,*.o,*.a,*.so,*.exe,*.dll,autom4te.cache/,config.status,config.log,.idea/,*.log,.env* - Swift:
.build/,DerivedData/,*.swiftpm/,Packages/ - R:
.Rproj.user/,.Rhistory,.RData,.Ruserdata,*.Rproj,packrat/,renv/ - ユニバーサル:
.DS_Store,Thumbs.db,*.tmp,*.swp,.vscode/,.idea/
ツール固有のパターン:
- Docker:
node_modules/,.git/,Dockerfile*,.dockerignore,*.log*,.env*,coverage/ - ESLint:
node_modules/,dist/,build/,coverage/,*.min.js - Prettier:
node_modules/,dist/,build/,coverage/,package-lock.json,yarn.lock,pnpm-lock.yaml - Terraform:
.terraform/,*.tfstate*,*.tfvars,.terraform.lock.hcl - Kubernetes/k8s:
*.secret.yaml,secrets/,.kube/,kubeconfig*,*.key,*.crt
-
tasks.md の構造を解析し、以下を抽出します:
- タスクフェーズ: セットアップ、テスト、コア、統合、仕上げ
- タスク依存関係: 逐次実行と並列実行のルール
- タスク詳細: ID、説明、ファイルパス、並列マーカー [P]
- 実行フロー: 順序と依存関係の要件
-
タスク計画に従って実装を実行します:
- フェーズごとの実行: 各フェーズを完了してから次のフェーズに進みます
- 依存関係を尊重: 逐次タスクは順番に実行し、並列タスク [P] は一緒に実行できます
- TDD アプローチに従う: 対応する実装タスクの前にテストタスクを実行します
- ファイルベースの調整: 同じファイルに影響するタスクは逐次実行する必要があります
- 検証チェックポイント: 各フェーズの完了を確認してから先に進みます
-
実装実行ルール:
- セットアップを最初に: プロジェクト構造、依存関係、設定を初期化します
- コードより先にテスト: コントラクト、エンティティ、統合シナリオのテストを作成する必要がある場合
- コア開発: モデル、サービス、CLI コマンド、エンドポイントを実装します
- 統合作業: データベース接続、ミドルウェア、ロギング、外部サービス
- 仕上げと検証: 単体テスト、パフォーマンス最適化、ドキュメント
-
進捗状況の追跡とエラー処理:
- 各タスク完了後に進捗を報告します
- 非並列タスクが失敗した場合は実行を停止します
- 並列タスク [P] の場合は、成功したタスクを続行し、失敗したタスクを報告します
- デバッグ用のコンテキストを含む明確なエラーメッセージを提供します
- 実装を続行できない場合、次のステップを提案します
- 重要: 完了したタスクについては、tasks ファイルでタスクを
[X]としてマークしてください。
-
完了検証:
- すべての必須タスクが完了したことを確認します
- 実装された機能が元の仕様と一致することを確認します
- テストが合格し、カバレッジが要件を満たしていることを検証します
- 実装が技術計画に従っていることを確認します
注: このコマンドは、tasks.md に完全なタスクの内訳が存在することを前提としています。タスクが不完全または欠落している場合は、/speckit-tasks を実行してタスクリストを再生成することを提案します。
必須の実行後フック
完了をユーザーに報告する前に、このセクションを必ず完了してください。
プロジェクトルートに .specify/extensions.yml が存在するか確認します。
- 存在しない場合、または
hooks.after_implementキー配下にフックが登録されていない場合は、完了報告にスキップします。 - 存在する場合は、それを読み込み、
hooks.after_implementキー配下のエントリを探します。 - 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 のすべてのタスクが完了し、
[X]でマークされている - 実装が仕様、計画、テストカバレッジに対して検証されている
- 上記「必須の実行後フック」のルールに従って、拡張フックがディスパッチまたはスキップされている
- 完了した作業の概要とともにユーザーに完了が報告されている