Build Right 執行
在前置執行工作產出產品真相、MVP 範圍、 操作規則和可執行任務佇列後,使用此技能。
核心規則:
完成一個任務。
證明當前狀態。
窄幅變更。
用正確的證據驗證。
更新追蹤器。
然後繼續下一個任務。
必須閱讀
- 在執行前,始終閱讀
references/workflow.md。 - 在任務選擇前、任務接收後以及推進到下一個任務前,閱讀
references/gates.md。 - 僅在審查觸發條件適用、子代理審查有用,或涉及廣泛的證據/追蹤器變更時,閱讀
references/review-and-delegation.md。 - 在完成或更新任務前,閱讀
references/evidence-contract.md。 - 在實作或審查時,若任務觸及架構邊界、公開 API、套件擁有權、提供者適配器、產生的程式碼、錯誤語義、測試、可觀測性、安全性或可強制執行的政策,請閱讀
../build-right-engineering-principles/references/principles.md。 - 在建立缺少的任務或拆分過於寬泛的任務時,使用
assets/templates/task-template.md。 - 僅透過下方顯示的完整 Bun 指令形式使用捆綁的輔助腳本。請勿依賴 PATH 別名或叫用簡短名稱(例如將
continue-check作為 shell 指令)。 - 在選擇任務或推進佇列前,使用狀態解析器。報告並調和其決策後再繼續。
- 使用執行輔助來取得確定性的任務、合約和閘道訊號。將腳本輸出視為判斷的輸入,而非權威。
操作模式
-
當可用時,執行唯讀的狀態解析器:
bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict -
在選擇工作前,報告解析器的發現:
解析器決策:<決策> 信心水準:<信心水準> 下一個動作:<下一個動作> 下一個任務:<任務或無> 阻擋閘道:<閘道或無> 外部後續事項:<後續事項或無> -
在選擇工作前,遵循解析器的決策:
ask-founder:詢問或報告創始人擁有的閘道;不要繼續。wait-external:報告外部狀態閘道;不要繼續。create-blocker:建立或提議最小的 AI 擁有的阻礙任務。no-ready-task:停止並報告沒有準備就緒的 AI 擁有任務。invalid-state:停止並調和矛盾的追蹤器/閘道狀態。continue-active-task或execute-task:精確選擇該任務。
-
當可用時,執行唯讀的執行輔助:
bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown -
讀取任務、衝刺/里程碑追蹤器、權威文件和本地代理指令。
-
列印任務接收資訊:
活動任務:<任務 ID 或路徑> 完成的定義:<可觀察的完成標準> 非目標:<明確排除事項> 假設基礎:<創始人聲稱 | AI 推斷 | 原型假設 | 儲存庫證據支援 | 公開證據支援 | 客戶證據支援> 可逆性:<容易 | 中等 | 困難> 學習鉤:<此任務將如何產出證據> 測試中來源:<儲存庫本地路徑 | 已安裝路徑 | GitHub 來源 | 發布標籤 | 不適用> 基準證據:<成品或指令> 驗證階梯:<聚焦 -> 更廣泛的檢查> 證據目的地:<任務檔案或證據檔案> -
當任務路徑存在時,以
task-contract或all模式執行執行輔助,然後在編輯前調和任何缺少的欄位。 -
在編輯前檢查當前工作區狀態。
-
擷取基準證據。
-
實作滿足任務所需的最小變更。
-
分層驗證。
-
當必要的審查觸發條件適用且子代理工具可用時,執行子代理審查。若不可用或禁止,記錄跳過的審查並在關閉前替換驗證。
-
在將任務標記為完成前記錄證據。
-
僅更新相關的追蹤器/文件。
-
在選擇另一個任務前,執行完整的 Bun 狀態解析器指令和
stop-gates模式的執行輔助。 -
在決定是否安全選擇另一個任務前,再次報告解析器的發現。
-
在遇到創始人、外部狀態、驗證失敗、過時任務、來源不匹配、未解決衝突、非 AI 擁有者或發布聲明閘道時停止。在閘道被解決或明確轉換為準備就緒的 AI 擁有任務之前,不要推進到下一個任務。
-
根據專案工作流程進行提交或交接。
未準備就緒規則
如果權威文件、MVP 範圍、執行規則或任務檔案缺失,請不要假裝執行已準備就緒。將使用者引導至 /build-right-preflight,或建立所需的最小 Sprint 0 阻礙任務,以建立缺少的執行表面。
只有當可逆性、學習鉤以及在產品真相前需要驗證是明確的時候,原型任務才能從 prototype-assumption 基礎執行。
對於技能發布/手動試驗,記錄正在測試的精確來源。如果已安裝或叫用的技能相對於儲存庫本地技能來源已過時,則將試驗標記為 partial-needs-rerun,並且不要將發布閘道推進至準備就緒。
範圍規則
請勿靜默擴大範圍。如果任務揭示了無關的工作,請建立一個後續議題,並僅在所選任務邊界內繼續。
停止/詢問閘道
在每個任務之後,檢查下一步是否確實是 AI 擁有的且準備就緒。當下一步需要以下事項時,停止並詢問或報告阻礙:
- 創始人擁有的產品、定位、買方/使用者或 MVP 決策
- 準備就緒或活動的任務擁有權不屬於 AI
docs/conflicts.md中未解決的衝突- 外部發現、搜尋索引、發布、機密、付費服務或生產環境存取
- 驗證失敗、過時任務狀態、來源不匹配或不明確的證據
- 被跳過且沒有等效替代方案的必需子代理審查
只有在每個下一個任務都準備就緒、由 AI 擁有、有證據支持且未被這些閘道之一阻擋時,才允許繼續通過已準備好的佇列。
使用者可見狀態徽章
以一個狀態徽章區塊結束每個最終回應:
✅ [完成] 狀態:完成
決策:<決策/結果>
下一個動作:<下一個動作或無>
需要使用者輸入:<無 | 簡潔的詢問>
被阻擋者:<無 | 阻礙>
使用此狀態對應:
✅ [完成] 狀態:完成表示一個已完成且有證據、驗證和追蹤器更新的任務。🟢 [綠色] 狀態:全部綠燈表示在實作開始前的execute-task或continue-active-task。🟡 [黃色] 狀態:需要輸入表示ask-founder。🟠 [橙色] 狀態:需要工作表示 AI 擁有的後續工作,但尚未成為準備就緒的執行任務。🔵 [藍色] 狀態:等待外部表示wait-external、發布、索引、憑證、付費服務、生產環境存取或第三方狀態。🔴 [紅色] 狀態:受阻表示create-blocker、no-ready-task、invalid-state、未解決的衝突、驗證失敗、過時/來源不匹配、非 AI 擁有的任務擁有權,或跳過了必要的審查且無替代方案。