ユーザー入力
$ARGUMENTS
処理を進める前に、ユーザー入力(空でない場合)を必ず考慮してください。
事前実行チェック
(タスク→Issue変換前の)拡張フックの確認:
- プロジェクトルートに
.specify/extensions.ymlが存在するか確認します。 - 存在する場合は、そのファイルを読み込み、
hooks.before_taskstoissuesキーのエントリを探します。 - 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")を使用してください。 - 存在する場合: プロジェクトの原則とガバナンス制約について
.specify/memory/constitution.mdを読み込みます。 - 実行したスクリプトから、タスクへのパスを抽出します。
- 以下のコマンドを実行して Git リモートを取得します:
git config --get remote.origin.url
[!CAUTION] リモートが GITHUB URL である場合にのみ、次のステップに進んでください。
- 既存のIssueを重複排除のために取得する: 何かを作成する前に、
tasks.mdから処理しようとしているタスクIDのセットを構築します(各IDはTの後に少なくとも3桁の数字が続きます。例:T001—/speckit-convergeはT{M+1:03d}形式で新しいIDを割り当てます。これは上限ではなく下限であるため、ファイルに999を超えるタスクがある場合、IDは4桁以上になります)。次に、GitHub MCP サーバーのlist_issuesツールを使用して、それらのIDを既にカバーしているIssueを探します。state値を渡さないでください(省略すると、ツールはオープンなIssueとクローズされたIssueの両方を返します)。リクエストにはperPage: 100を指定して呼び出し回数を抑え、ツールがカーソルベースのページネーションを使用するため、前のレスポンスのendCursorを使ってafterパラメータでページをリクエストします。各Issueのタイトルについて、タスクIDパターン\bT\d{3,}\b({3,}は4桁以上のIDも受け入れます —\d{3}の場合、タイトルにT1000が含まれていてもまったく一致しません。なぜなら末尾の\bが2桁の数字の間に位置できないため、そのタスクは黙って重複排除も作成もされません。ワード境界は依然としてST001のようなトークンが一致するのを防ぎ、数字の連続全体を消費するためT100がT1000内で一致することはありません。これにより、T001 ...、T001: ...、[T001] ...のように書かれたタイトルも認識されます)と照合し、タスクIDのいずれかに一致した場合、そのIDは既にIssueがあるものとしてマークします。すべてのタスクIDが一致した時点、またはそれ以上ページがない時点でページネーションを停止し、すべてのタスクIDが確認された後はリポジトリ全体のIssue履歴を取得し続けないようにします。これにより、Issue履歴が大量にあるリポジトリでの呼び出し回数が制限され、tasks.mdが再生成されたりスキルが再呼び出しされたりした場合でも重複を防ぐことができます。 - リスト内の各タスクについて、GitHub MCP サーバーを使用して、Git リモートを表すリポジトリに新しいIssueを作成します。
tasks.mdのタスク行は Markdown チェックボックスで始まるため、まず先頭の- [ ](および任意の[P]/[US#]マーカー)を取り除き、タスクIDとその説明を復元します。IssueはT001: <説明>の形式の単一の正規タイトルで作成します。IDは1回記述し、その後にタスクの説明を続けます(例:- [ ] T001 Create project structureという行は、タイトルT001: Create project structureになります)。- 前のステップの既存IssueセットにIDが既に存在するタスクはスキップし、その旨を報告します(例:
T001 は既にIssueが存在するためスキップします)。 - 一致するIssueがまだ存在しないタスクに対してのみIssueを作成します。
- 前のステップの既存IssueセットにIDが既に存在するタスクはスキップし、その旨を報告します(例:
[!CAUTION] リモートURLと一致しないリポジトリにIssueを作成することは、決して行わないでください。
事後実行チェック
(タスク→Issue変換後の)拡張フックの確認:
プロジェクトルートに .specify/extensions.yml が存在するか確認します。
- 存在する場合は、そのファイルを読み込み、
hooks.after_taskstoissuesキーのエントリを探します。 - 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が存在しない場合は、黙ってスキップします。