sample-specship
以規格驅動的自動化工程流程,專為 AI 編碼代理設計:偵察 → 規劃 → 建置 → 驗證 → 交付,並整合 TDD、對抗式驗證與反草率品質閘門。
sample-specship 是什麼?
以規格驅動的自動化工程流程,專為 AI 編碼代理設計:偵察 → 規劃 → 建置 → 驗證 → 交付,並整合 TDD、對抗式驗證與反草率品質閘門。以 Kiro Power 形式封裝。
sample-specship 概覽
這是什麼
SpecShip 是一個 Kiro Power 自主工程工作流程,透過完整的「偵察 → 規劃 → 建置 → 驗證 → 出貨」管線來協調 AI 代理。它包含既有程式碼逆向工程、測試驅動開發、平行執行、對抗式驗證以及規格驅動的品質閘門。此工作流程以 Kiro Power 形式封裝,旨在以最少的人工介入產出穩健且經過測試的程式碼。
主要功能
- 測試驅動開發:沒有先寫出失敗的測試就不會有正式程式碼;建置閘門會阻擋每個里程碑,直到型別檢查、測試和建置全部通過。
- 平行執行:獨立的任務同時執行;所有驗證器以獨立的子代理平行啟動。
- 對抗式驗證:建置程式碼的代理不能評判它;獨立的驗證器會產出帶有證據的類型化裁決。
- 自我修復復原:當驗證器發現錯誤時,一個全新的代理會精準修復它——每個問題只修一次,先做回歸測試,最多 3 個循環。
- 合約優先:每次建置都從驗收標準、失敗模式和設計規格開始,這些在程式碼之前就已定義,並儲存在
.specship/specs/中。 - 既有程式碼安全:在規劃之前會先逆向工程既有程式碼;合約包含保留的行為、本地慣例、基線測試、可能變更的檔案以及應避免的檔案。
- 市場研究:執行真實的網路搜尋(至少 5 個查詢)來研究同類別的現有產品;研究結果會儲存在
.specship/specs/artifacts/market-research.md。
使用情境
- 從頭開始建置新應用程式(例如「幫我建一個看板」)。
- 透過逆向工程為既有程式碼庫新增功能(例如「在新增計費功能之前先逆向工程這個儲存庫」)。
- 使用對抗式驗證器驗證程式碼品質,涵蓋程式碼、安全性、整合、瀏覽器、設計、對齊和負載。
- 透過拉取請求、變更記錄和封存來出貨程式碼;如果沒有 git 遠端,則在本機準備並提供推送指示。
- 使用
where was I?指令恢復中斷的任務。
快速開始
bash./install.sh安裝程式會自動偵測並安裝缺少的相依項目(superpowers 和 gstack),將 SpecShip 導向檔案複製到 ~/.kiro/steering/,並在未設定時設定 Playwright MCP。若要限定於單一專案,請執行 ./install.sh ./.kiro/steering。
授權與價格
採用 MIT 授權條款。開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。