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 程式設計助手通常僅將關鍵需求與決策歷史儲存在聊天記錄中,導致難以檢視、審查,並在不同會話或不同 AI 工具之間維持一致的狀態。OSpec 提供一個以規格驅動開發(SDD)為核心的層,將變更上下文——提案、設計、計畫與驗證證據——直接持久化至專案儲存庫中。

工作原理

OSpec 實作「循環工程」工作流程(計畫 → 執行 → 驗證),並與 Claude Code、Codex、Gemini 等 AI 助手整合。它透過 CLI 工具管理需求的生命周期:

  1. 初始化:設定專案結構(包含 .ospec/ 目錄),用於存放 AI 指引與專案知識。
  2. 變更管理:針對簡單任務,使用快速流程(ospec change),從提案直接推進至任務、實作與驗證。
  3. 目標工作流程:針對複雜任務,ospec goal 會觸發更嚴謹的代理式流程,包含設計文件、任務圖、並行工作者分發、獨立審查與自動化驗證門檻。
  4. 歸檔:一旦變更通過驗證並部署,就會在儲存庫內歸檔,以保留工作的永久記錄。

適用對象

使用 AI 程式設計助手,並希望獲得可驗證、基於儲存庫的審計追蹤(而非依賴暫時性聊天歷史)的軟體開發者。

核心亮點

  • 規格驅動開發:將聊天請求轉化為持久化檔案(提案、設計、計畫),儲存在儲存庫中。
  • 代理控制器:支援複雜目標的並行工作者分發與審查門檻。
  • 工具無關性:相容多種 AI 框架,包括 Claude Code、Codex、Gemini 與 OpenCode。
  • 持久狀態:將進度儲存在儲存庫中,任何助手都能從上一次停止的位置精確恢復任務。

相關

  • 專案
  • 專案
  • 專案
  • Dispatch
  • 專案