Community研究與資料分析github.com

pax-k/build-right

與代理無關的技能,能將模糊的應用想法轉化為基於證據的 AI 執行。

build-right 是什麼?

這個技能「Build Right Execution」提供了一個嚴謹、與代理無關的框架,用於將模糊、未經梳理的應用想法轉化為結構化、基於證據的 AI 驅動執行。它的核心是強制執行一個嚴格的循環:「完成一個任務、證明當前狀態、窄幅變更、用正確證據驗證、更新追蹤器、然後繼續下一個任務」。它依賴於一組預先定義的參考文件(例如 workflow.md、gates.md、evidence-contract.md)和可執行的 Bun 腳本(state resolver、execution helper)來確保每次行動都基於已建立的產品真相、MVP 範圍和明確的任務佇列。該技能支援對非 AI 擁有的任務進行自動門控(停止/詢問)、範圍防護(禁止靜默擴展)以及強制執行證據階梯,以防止過早承諾。它在其輸出末尾輸出一個使用者可見的狀態徽章(例如 DONE、NEEDS INPUT、BLOCKED),為開發人員和 AI 代理提供清晰的問責制。它被設計為與 Claude Code、Cursor、Codex 等代理工具一起使用。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add pax-k/build-right

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 指令)。
  • 在選擇任務或推進佇列前,使用狀態解析器。報告並調和其決策後再繼續。
  • 使用執行輔助來取得確定性的任務、合約和閘道訊號。將腳本輸出視為判斷的輸入,而非權威。

操作模式

  1. 當可用時,執行唯讀的狀態解析器:

    bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict
    
  2. 在選擇工作前,報告解析器的發現:

    解析器決策:<決策>
    信心水準:<信心水準>
    下一個動作:<下一個動作>
    下一個任務:<任務或無>
    阻擋閘道:<閘道或無>
    外部後續事項:<後續事項或無>
    
  3. 在選擇工作前,遵循解析器的決策:

    • ask-founder:詢問或報告創始人擁有的閘道;不要繼續。
    • wait-external:報告外部狀態閘道;不要繼續。
    • create-blocker:建立或提議最小的 AI 擁有的阻礙任務。
    • no-ready-task:停止並報告沒有準備就緒的 AI 擁有任務。
    • invalid-state:停止並調和矛盾的追蹤器/閘道狀態。
    • continue-active-task 或 execute-task:精確選擇該任務。
  4. 當可用時,執行唯讀的執行輔助:

    bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown
    
  5. 讀取任務、衝刺/里程碑追蹤器、權威文件和本地代理指令。

  6. 列印任務接收資訊:

    活動任務:<任務 ID 或路徑>
    完成的定義:<可觀察的完成標準>
    非目標:<明確排除事項>
    假設基礎:<創始人聲稱 | AI 推斷 | 原型假設 | 儲存庫證據支援 | 公開證據支援 | 客戶證據支援>
    可逆性:<容易 | 中等 | 困難>
    學習鉤:<此任務將如何產出證據>
    測試中來源:<儲存庫本地路徑 | 已安裝路徑 | GitHub 來源 | 發布標籤 | 不適用>
    基準證據:<成品或指令>
    驗證階梯:<聚焦 -> 更廣泛的檢查>
    證據目的地:<任務檔案或證據檔案>
    
  7. 當任務路徑存在時,以 task-contract 或 all 模式執行執行輔助,然後在編輯前調和任何缺少的欄位。

  8. 在編輯前檢查當前工作區狀態。

  9. 擷取基準證據。

  10. 實作滿足任務所需的最小變更。

  11. 分層驗證。

  12. 當必要的審查觸發條件適用且子代理工具可用時,執行子代理審查。若不可用或禁止,記錄跳過的審查並在關閉前替換驗證。

  13. 在將任務標記為完成前記錄證據。

  14. 僅更新相關的追蹤器/文件。

  15. 在選擇另一個任務前,執行完整的 Bun 狀態解析器指令和 stop-gates 模式的執行輔助。

  16. 在決定是否安全選擇另一個任務前,再次報告解析器的發現。

  17. 在遇到創始人、外部狀態、驗證失敗、過時任務、來源不匹配、未解決衝突、非 AI 擁有者或發布聲明閘道時停止。在閘道被解決或明確轉換為準備就緒的 AI 擁有任務之前,不要推進到下一個任務。

  18. 根據專案工作流程進行提交或交接。

未準備就緒規則

如果權威文件、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 擁有的任務擁有權,或跳過了必要的審查且無替代方案。

相關技能