使用者輸入
$ARGUMENTS
在繼續之前,你必須考慮使用者輸入(如果不為空)。
前置執行檢查
檢查擴展掛鉤(在任務轉換為 Issues 之前):
- 檢查專案根目錄是否存在
.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 時,才繼續下一步。
- 獲取現有 Issues 以進行去重:在建立任何內容之前,從
tasks.md建構你即將處理的任務 ID 集合(每個 ID 是T後接至少三位數字,例如T001——/speckit-converge使用T{M+1:03d}分配新 ID,這是一個下限而非上限,因此一旦文件中的任務超過 999 個,ID 就會變成四位或更長)。然後使用 GitHub MCP 伺服器的list_issues工具查找已涵蓋這些 ID 的 Issues。不要傳遞state值,因為省略它會使工具同時返回開啟和關閉的 Issues。請求perPage: 100以減少調用次數,並且由於該工具使用基於游標的分頁,請使用after參數(使用前一個響應中的endCursor)請求頁面。對於每個 Issue 標題,將其與任務 ID 模式\bT\d{3,}\b進行匹配({3,}接受四位及更長的 ID——使用\d{3}時,包含T1000的標題根本無法匹配,因為結尾的\b不能在兩個數字之間,因此該任務會靜默地既不被去重也不被建立;單詞邊界仍會阻止像ST001這樣的 Token 匹配,並強制消耗整個數字串,因此T100永遠無法匹配T1000內部;這也識別寫為T001 ...、T001: ...或[T001] ...的標題),當它匹配到你的任務 ID 之一時,將該 ID 標記為已有 Issue。一旦每個任務 ID 都已匹配,或沒有更多頁面時,停止分頁,這樣一旦所有任務 ID 都被考慮到,就不會繼續獲取整個倉庫的 Issue 歷史。這限制了在具有大量 Issue 歷史的倉庫上的調用次數,並且在tasks.md重新產生或技能被重新調用後重新運行命令時,仍然可以防止重複。 - 對於清單中的每個任務,使用 GitHub MCP 伺服器在代表 Git 遠端的倉庫中建立一個新的 Issue。
tasks.md中的任務行以 Markdown 複選框開頭,因此首先去除前導的- [ ](以及任何[P]/[US#]標記)以恢復任務 ID 及其描述。使用T001: <描述>形式的單一規範標題建立 Issue,其中 ID 寫一次,後接任務描述(例如,行- [ ] T001 建立專案結構變成標題T001: 建立專案結構)。- 跳過任何其 ID 已存在於上一步現有 Issues 集合中的任務,並報告它(例如,
T001 已有一個 Issue,跳過)。 - 僅為尚未有匹配 Issue 的任務建立 Issues。
- 跳過任何其 ID 已存在於上一步現有 Issues 集合中的任務,並報告它(例如,
[!CAUTION] 在任何情況下,都不得在與遠端 URL 不匹配的倉庫中建立 Issues。
後置執行檢查
檢查擴展掛鉤(在任務轉換為 Issues 之後):
檢查專案根目錄是否存在 .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不存在,則靜默跳過。