clawplays/ospec

Spec-driven, agentic workflow framework for AI coding agents. Turn a request into a verifiable goal loop — plan, act, verify — with durable specs and evidence in your repo. Works with Claude Code, Codex, Gemini, OpenCode, and plain CLI.

解決的問題

AI 編程助手通常僅將關鍵需求和決策上下文儲存在聊天歷史記錄中，導致在不同的會話或工具之間檢查、審查和恢復工作變得困難。OSpec 通過引入規範驅動開發 (SDD) 層解決了這個問題，該層將整個工作流（提議、設計、計劃和驗證證據）直接持久化在專案倉庫中。

工作原理

OSpec 實現了一個「循環工程」框架 (plan $ ightarrow$ act $ ightarrow$ verify)，該框架可與 Claude Code、Codex 和 Gemini 等 AI 代理集成。它通過兩種主要模式運行：

  1. 變更流 (Change Flow)：針對簡單需求的輕量級路徑 (init $ ightarrow$ change $ ightarrow$ verify/finalize)，通過創建一系列 Markdown 檔案（提議、任務、驗證、審查）來追蹤進度。
  2. 目標工作流 (Goal Workflow)：針對複雜任務更嚴格的代理流程。它使用控制器層來推導任務圖、調度並行工作代理、強制執行審查者關卡，並要求在標記目標完成之前提供確定性的驗證證據。

系統使用「協議外殼」 (Protocol Shell，包括 .skillrc 和 .ospec/ 目錄) 來維護專案知識和狀態，允許任何相容的 AI 代理從前一個代理停止的地方準確接手。

適用對象

使用 AI 編程代理（如 Claude Code、Codex、Gemini 或 OpenCode）的開發人員，他們希望擁有 AI 驅動變更的可驗證、可審計且持久的記錄，而不是依賴易失性的聊天日誌。

亮點

  • 基於倉庫的上下文：將需求和計劃從聊天歷史記錄移至版本控制檔案。
  • 代理控制器：支持高風險任務的並行工作調度和獨立的審查者關卡。
  • 工具無關性：適用於各種 AI 框架和 CLI 工作流。
  • 可驗證循環：確保工作在歸檔前通過驗證證據和獨立審查得到證實。