clawplays/ospec

解决的问题

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。
• 持久状态：将进度保存在仓库中，任何助手都能从上一次停止的位置精确恢复任务。