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 工作流。
  • 可验证循环：确保工作在归档前通过验证证据和独立审查得到证实。