ユーザー入力
$ARGUMENTS
続行する前に、ユーザー入力を必ず考慮してください(空でない場合)。
実行前チェック
拡張フックの確認(分析前):
- プロジェクトルートに
.specify/extensions.ymlが存在するか確認します。 - 存在する場合、それを読み込み、
hooks.before_analyzeキー配下のエントリを探します。 - 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が存在しない場合は、黙ってスキップします。
目標
実装前に、3つの中核アーティファクト(spec.md、plan.md、tasks.md)間の不整合、重複、曖昧さ、および未定義項目を特定します。このコマンドは、/speckit-tasksが完全なtasks.mdを生成した後にのみ実行する必要があります。
運用制約
厳密に読み取り専用: ファイルを一切変更しません。構造化された分析レポートを出力します。オプションの修正計画を提供します(ユーザーが明示的に承認した場合にのみ、フォローアップの編集コマンドが手動で呼び出されます)。
憲法の権威: プロジェクト憲法(.specify/memory/constitution.md)は、この分析範囲内では交渉不可です。憲法の競合は自動的にCRITICALとなり、仕様、計画、またはタスクの調整が必要です。原則の希釈、再解釈、または黙殺は許可されません。原則自体を変更する必要がある場合、それは/speckit-analyzeとは別の、独立した明示的な憲法更新で行う必要があります。
実行手順
1. 分析コンテキストの初期化
リポジトリルートから.specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasksを1回実行し、JSONを解析してFEATURE_DIRとAVAILABLE_DOCSを取得します。絶対パスを導出します:
- SPEC = FEATURE_DIR/spec.md
- PLAN = FEATURE_DIR/plan.md
- TASKS = FEATURE_DIR/tasks.md
必要なファイルが不足している場合は、エラーメッセージを表示して中断します(不足している前提条件コマンドを実行するようユーザーに指示します)。 "I'm Groot"のような引数にシングルクォートが含まれる場合は、エスケープ構文(例:'I'''m Groot')を使用するか、可能であればダブルクォート("I'm Groot")を使用します。
2. アーティファクトの読み込み(段階的開示)
各アーティファクトから必要最小限のコンテキストのみを読み込みます:
spec.mdから:
- 概要/コンテキスト
- 機能要件
- 成功基準(測定可能な成果 — 例:パフォーマンス、セキュリティ、可用性、ユーザー成功、ビジネスインパクト)
- ユーザーストーリー
- エッジケース(存在する場合)
plan.mdから:
- アーキテクチャ/スタックの選択
- データモデルの参照
- フェーズ
- 技術的制約
tasks.mdから:
- タスクID
- 説明
- フェーズグループ化
- 並行マーカー [P]
- 参照ファイルパス
憲法から:
- 原則の検証のために
.specify/memory/constitution.mdを読み込みます
3. セマンティックモデルの構築
内部表現を作成します(出力には生のアーティファクトを含めません):
- 要件インベントリ: 各機能要件(FR-###)および成功基準(SC-###)について、安定したキーを記録します。明示的なFR-/SC-識別子が存在する場合はそれを主キーとして使用し、必要に応じて可読性のために命令句スラグも導出します(例:「ユーザーはファイルをアップロードできる」→
user-can-upload-file)。構築作業が必要な成功基準項目のみを含め(例:ロードテストインフラ、セキュリティ監査ツール)、ローンチ後の成果指標やビジネスKPI(例:「サポートチケットを50%削減」)は除外します。 - ユーザーストーリー/アクションインベントリ: 受け入れ基準を伴う個別のユーザーアクション
- タスクカバレッジマッピング: 各タスクを1つ以上の要件またはストーリーにマッピングします(キーワード/明示的な参照パターン(IDやキーフレーズなど)による推論)
- 憲法ルールセット: 原則名とMUST/SHOULD規範ステートメントを抽出します
4. 検出パス(トークン効率的な分析)
シグナルの強い発見に焦点を当てます。発見は合計50件に制限し、残りはオーバーフローサマリーに集約します。
A. 重複検出
- ほぼ同一の要件を特定します
- 統合のための低品質な表現をマークします
B. 曖昧さ検出
- 測定基準のない曖昧な形容詞(高速、スケーラブル、安全、直感的、堅牢など)にフラグを立てます
- 未解決のプレースホルダー(TODO、TKTK、???、
<placeholder>など)にフラグを立てます
C. 未定義
- 動詞があるが目的語や測定可能な結果がない要件
- 受け入れ基準の整合性がないユーザーストーリー
- spec/planで定義されていないファイルやコンポーネントを参照するタスク
D. 憲法との整合性
- MUST原則と矛盾する要件や計画要素
- 憲法で義務付けられているセクションや品質ゲートの欠落
E. カバレッジギャップ
- 関連タスクがゼロの要件
- マッピングされた要件/ストーリーがないタスク
- タスクに反映されていない、構築作業が必要な成功基準(パフォーマンス、セキュリティ、可用性)
F. 不整合
- 用語のずれ(同じ概念がファイル間で異なる名前で呼ばれている)
- 計画で参照されているがspecに存在しない(またはその逆)データエンティティ
- タスク順序の矛盾(例:依存関係のメモなしに基盤セットアップタスクより前の統合タスク)
- 競合する要件(例:ある要件はNext.jsを要求し、別の要件はVueを指定している)
5. 重要度の割り当て
以下のヒューリスティックを使用して発見事項に優先順位を付けます:
- CRITICAL: 憲法MUST違反、コアspecアーティファクトの欠落、またはベースライン機能をブロックするカバレッジゼロの要件
- HIGH: 重複または競合する要件、曖昧なセキュリティ/パフォーマンス属性、テスト不可能な受け入れ基準
- MEDIUM: 用語のずれ、欠落している非機能タスクカバレッジ、未定義のエッジケース
- LOW: スタイル/表現の改善、実行順序に影響しない軽微な冗長性
6. 簡潔な分析レポートの生成
以下の構造でMarkdownレポートを出力します(ファイル書き込みなし):
仕様分析レポート
| ID | カテゴリ | 重要度 | 場所 | 概要 | 推奨事項 |
|---|---|---|---|---|---|
| A1 | 重複 | HIGH | spec.md:L120-134 | 2つの類似した要件... | 表現を統合し、より明確なバージョンを維持 |
(発見ごとに1行追加。カテゴリの頭文字をプレフィックスとした安定したIDを生成します。)
カバレッジサマリーテーブル:
| 要件キー | タスクあり? | タスクID | 備考 |
|---|
憲法整合性の問題:(存在する場合)
マッピングされていないタスク:(存在する場合)
メトリクス:
- 総要件数
- 総タスク数
- カバレッジ率(>=1タスクがある要件)
- 曖昧さの数
- 重複の数
- クリティカルな問題の数
7. 次のアクションの提供
レポートの最後に、簡潔な「次のアクション」ブロックを出力します:
- CRITICALな問題が存在する場合:
/speckit-implementの前に解決することを推奨します - LOW/MEDIUMのみの場合: ユーザーは続行できますが、改善提案を提供します
- 明示的なコマンド提案を提供します: 例:「改善のために
/speckit-specifyを実行」、「アーキテクチャを調整するために/speckit-planを実行」、「tasks.mdを手動で編集して'performance-metrics'のカバレッジを追加」
8. 修正案の提供
ユーザーに尋ねます:「上位N件の問題について、具体的な修正編集を提案しましょうか?」(自動的に適用はしません。)
9. 拡張フックの確認
レポート後、プロジェクトルートに.specify/extensions.ymlが存在するか確認します。
- 存在する場合、それを読み込み、
hooks.after_analyzeキー配下のエントリを探します。 - 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が存在しない場合は、黙ってスキップします。
運用原則
コンテキスト効率
- 最小限の高シグナルトークン: 網羅的なドキュメントではなく、実用的な発見に焦点を当てます
- 段階的開示: アーティファクトを段階的に読み込みます。すべての内容を分析にダンプしません
- トークン効率的な出力: 発見テーブルを50行に制限し、超過分は要約します
- 決定論的な結果: 変更なしで再実行すると、一貫したIDとカウントが生成されるべきです
分析ガイドライン
- 決してファイルを変更しない(これは読み取り専用分析です)
- 欠落しているセクションを決して捏造しない(存在しない場合は、正確に報告します)
- 憲法違反を優先する(これらは常にCRITICALです)
- 網羅的なルールよりも例を使用する(一般的なパターンではなく、特定のインスタンスを引用します)
- 問題がゼロの場合は適切に報告する(カバレッジ統計を含む成功レポートを出力します)
コンテキスト
$ARGUMENTS