使用者輸入
$ARGUMENTS
在繼續之前,你必須考慮使用者輸入(若非空白)。
執行前檢查
檢查擴充套件鉤子(任務產生前):
- 檢查專案根目錄是否存在
.specify/extensions.yml。 - 若存在,讀取其內容並尋找
hooks.before_tasks鍵下的條目。 - 若 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/setup-tasks.sh --json,並解析 FEATURE_DIR、TASKS_TEMPLATE_CONTENT、TASKS_TEMPLATE 和 AVAILABLE_DOCS 清單。FEATURE_DIR和TASKS_TEMPLATE在提供時必須是絕對路徑。AVAILABLE_DOCS是FEATURE_DIR下可用的文件名稱/相對路徑清單(例如research.md或contracts/)。對於引數中的單引號(例如 "I'm Groot"),請使用跳脫語法:例如 'I'''m Groot'(或盡可能使用雙引號:"I'm Groot")。 -
載入設計文件:從 FEATURE_DIR 讀取:
- 必要:plan.md(技術棧、函式庫、結構)、spec.md(附優先級的使用者故事)
- 可選:data-model.md(實體)、contracts/(介面合約)、research.md(決策)、quickstart.md(測試情境)
- 若存在:載入
.specify/memory/constitution.md以了解專案原則與治理限制 - 注意:並非所有專案都有所有文件。根據可用的文件來產生任務。
-
執行任務產生工作流程:
- 載入 plan.md 並提取技術棧、函式庫、專案結構
- 載入 spec.md 並提取使用者故事及其優先級(P1、P2、P3 等)
- 若 data-model.md 存在:提取實體並對應到使用者故事
- 若 contracts/ 存在:將介面合約對應到使用者故事
- 若 research.md 存在:提取設定任務的決策
- 按使用者故事組織產生任務(請參閱下方的任務產生規則)
- 產生依賴關係圖,顯示使用者故事完成順序
- 為每個使用者故事建立並行執行範例
- 驗證任務完整性(每個使用者故事都有所有需要的任務,且可獨立測試)
-
產生 tasks.md:使用 TASKS_TEMPLATE_CONTENT(來自上述 JSON 輸出)作為結構。為了與省略 TASKS_TEMPLATE_CONTENT 的舊版設定腳本相容,請改為讀取 TASKS_TEMPLATE。填入以下內容:
- 來自 plan.md 的正確功能名稱
- 階段 1:設定任務(專案初始化)
- 階段 2:基礎任務(所有使用者故事的阻礙性先決條件)
- 階段 3+:每個使用者故事一個階段(依照 spec.md 中的優先級順序)
- 每個階段包含:故事目標、獨立測試標準、測試(若要求)、實作任務
- 最終階段:修飾與跨領域關注點
- 所有任務必須遵循嚴格的清單格式(請參閱下方的任務產生規則)
- 每個任務的清晰檔案路徑
- 顯示故事完成順序的依賴關係章節
- 每個故事的並行執行範例
- 實作策略章節(先 MVP,增量交付)
強制性執行後鉤子
在向使用者報告完成之前,你必須完成此章節。
檢查專案根目錄是否存在 .specify/extensions.yml。
- 若不存在,或
hooks.after_tasks下沒有註冊任何鉤子,則跳到完成報告。 - 若存在,讀取其內容並尋找
hooks.after_tasks鍵下的條目。 - 若 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 的路徑與摘要:
- 任務總數
- 每個使用者故事的任務數量
- 已識別的並行機會
- 每個故事的獨立測試標準
- 建議的 MVP 範圍(通常僅使用者故事 1)
- 格式驗證:確認所有任務都遵循清單格式(核取方塊、ID、標籤、檔案路徑)
任務產生的上下文:$ARGUMENTS
tasks.md 應立即可執行——每個任務必須足夠具體,以便 LLM 無需額外上下文即可完成。
任務產生規則
關鍵:任務必須按使用者故事組織,以實現獨立的實作與測試。
測試為可選:僅在功能規格中明確要求,或使用者要求 TDD 方法時,才產生測試任務。
清單格式(必要)
每個任務必須嚴格遵循以下格式:
- [ ] [TaskID] [P?] [Story?] 帶有檔案路徑的描述
格式組成部分:
- 核取方塊:始終以
- [ ]開頭(Markdown 核取方塊) - 任務 ID:按執行順序的序號(T001、T002、T003……)
- [P] 標記:僅在任務可並行化時包含(不同的檔案,無依賴於未完成任務的依賴)
- [Story] 標籤:僅對使用者故事階段的任務為必要
- 格式:[US1]、[US2]、[US3] 等(對應 spec.md 中的使用者故事)
- 設定階段:無故事標籤
- 基礎階段:無故事標籤
- 使用者故事階段:必須有故事標籤
- 修飾階段:無故事標籤
- 描述:包含確切檔案路徑的明確動作
範例:
- ✅ 正確:
- [ ] T001 依實作計劃建立專案結構 - ✅ 正確:
- [ ] T005 [P] 在 src/middleware/auth.py 實作認證中介軟體 - ✅ 正確:
- [ ] T012 [P] [US1] 在 src/models/user.py 建立 User 模型 - ✅ 正確:
- [ ] T014 [US1] 在 src/services/user_service.py 實作 UserService - ❌ 錯誤:
- [ ] 建立 User 模型(缺少 ID 和故事標籤) - ❌ 錯誤:
T001 [US1] 建立模型(缺少核取方塊) - ❌ 錯誤:
- [ ] [US1] 建立 User 模型(缺少任務 ID) - ❌ 錯誤:
- [ ] T001 [US1] 建立模型(缺少檔案路徑)
任務組織
-
來自使用者故事 (spec.md) - 主要組織方式:
- 每個使用者故事(P1、P2、P3……)都有自己的階段
- 將所有相關元件對應到其故事:
- 該故事所需的模型
- 該故事所需的服務
- 該故事所需的介面/UI
- 若要求測試:該故事專屬的測試
- 標記故事依賴關係(大多數故事應彼此獨立)
-
來自合約:
- 將每個介面合約對應到其所服務的使用者故事
- 若要求測試:每個介面合約 → 在該故事階段中,於實作之前的[P]合約測試任務
-
來自資料模型:
- 將每個實體對應到需要它的使用者故事
- 若實體服務於多個故事:放入最早的故事或設定階段
- 關係 → 在適當故事階段的服務層任務
- 對於 data-model.md 中具有約束的每個欄位(最大長度、可為 null/必要、列舉值、驗證規則),在任務描述中逐字引用該約束,以免留待實作時自行決定
-
來自設定/基礎設施:
- 共享基礎設施 → 設定階段(階段 1)
- 基礎/阻礙性任務 → 基礎階段(階段 2)
- 故事專屬設定 → 在該故事的階段內
階段結構
- 階段 1:設定(專案初始化)
- 階段 2:基礎(阻礙性先決條件——必須在使用者故事之前完成)
- 階段 3+:按優先級順序的使用者故事(P1、P2、P3……)
- 在每個故事內:測試(若要求)→ 模型 → 服務 → 端點 → 整合
- 每個階段應為一個完整、可獨立測試的增量
- 最終階段:修飾與跨領域關注點
完成條件
- 已產生包含所有階段、任務 ID 和檔案路徑的 tasks.md
- 已根據上述「強制性執行後鉤子」章節中的規則分派或跳過擴充套件鉤子
- 已向使用者報告完成,包含任務數量、故事細分和 MVP 範圍