Project OS：面向 Claude Code 的规约驱动开发脚手架

Project OS 是一个专为 Claude Code 设计的开源开发脚手架，提供规约驱动的开发流程、记忆系统、子智能体编排和质量门禁机制。

随着 Claude Code 等 AI 编程助手的普及，开发者与 AI 的协作方式正在发生根本性转变。然而，许多团队发现，简单地让 AI "帮忙写代码"并不能充分发挥其潜力。缺乏结构化流程的 AI 协作往往导致上下文丢失、质量不稳定、难以规模化等问题。

Project OS 正是为解决这些问题而生。它是一个专为 Claude Code 设计的开发脚手架，将规约驱动开发（Spec-Driven Development）的理念与 AI 辅助编程相结合，为团队提供了一套可复用、可扩展的协作框架。

规约驱动开发是一种先定义后实现的方法论。在项目 OS 的语境下，这意味着：

1. 先写规约，后写代码：任何功能实现之前，必须先有清晰、可验证的规约文档
2. 规约即测试：规约本身包含验收标准，可以直接转化为测试用例
3. 规约即文档：规约文档同时服务于人类开发者和 AI 助手，确保双方理解一致
4. 规约即协作界面：不同角色（产品经理、开发者、AI）通过规约进行协作

AI 助手（如 Claude Code）在处理结构化输入时表现最佳。清晰的规约为 AI 提供了：

• 明确的上下文：减少猜测和假设
• 可验证的目标：知道"完成"的标准是什么
• 一致的格式：便于解析和处理
• 可追溯的变更：规约版本与代码版本对应

Project OS 的架构围绕四个核心模块展开，形成了一个完整的开发支持系统。

工作流管道定义了从需求到交付的完整流程，将开发过程分解为一系列明确的阶段：

需求分析阶段：

• 输入：原始需求或用户故事
• 处理：AI 辅助分析，提取关键需求点
• 输出：结构化的需求规约文档

设计阶段：

• 输入：需求规约
• 处理：生成技术设计方案，包括架构图、接口定义、数据模型
• 输出：设计规约文档

实现阶段：

• 输入：设计规约
• 处理：AI 辅助代码生成，开发者审查和微调
• 输出：实现代码和单元测试

验证阶段：

• 输入：实现代码 + 需求规约
• 处理：自动化测试、代码审查、AI 辅助检查
• 输出：验证报告

每个阶段都有明确的输入输出格式和转换规则，确保流程的连贯性。

AI 助手的一个常见限制是上下文窗口。Project OS 通过分层记忆系统解决这个问题：

短期记忆（Session Memory）：

• 当前会话的上下文
• 最近的对话历史
• 临时工作区状态

中期记忆（Project Memory）：

• 项目级别的知识库
• 已完成的规约和决策记录
• 代码库的结构和关键文件索引

长期记忆（Organization Memory）：

• 跨项目的最佳实践
• 团队编码规范
• 历史项目经验和教训

记忆系统采用向量数据库和结构化存储相结合的方式，支持语义检索和精确查询。

复杂任务需要多个专业智能体协作完成。Project OS 提供了子智能体编排机制：

角色定义：

• 架构师智能体：负责高层设计和决策
• 开发者智能体：负责具体代码实现
• 测试智能体：负责测试用例设计和执行
• 审查智能体：负责代码质量和规范检查

协作模式：

• 串行模式：智能体按顺序执行，前一个的输出作为后一个的输入
• 并行模式：多个智能体同时处理不同子任务，结果汇总
• 会诊模式：多个智能体共同讨论复杂问题，达成共识

调度器： 智能体调度器负责任务分配和进度监控，确保协作效率。