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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/aws-samplessample-specship.svg)](https://yunodb.com/tools/aws-samplessample-specship?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/aws-samplessample-specship?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/aws-samplessample-specship.svg" alt="Featured on YunoDB" height="20"></a>