AI-Workspace

AI Workspace Framework 是一套面向 AI 辅助项目、可版本化并可复制采用的流程契约。本仓库保存通用 Framework 源文件、不可变发行版本、起始模板、校验器及发行工具，不保存任何实际消费者项目的动态状态。

Framework 的作用

AI Workspace Framework 为人员与 AI 共同参与的软件项目提供一套可复制、可恢复、可审查的协作机制，重点解决以下问题：

• 使用仓库内的项目事实、Controller、任务卡和 Bootstrap 恢复工作，使新任务不必依赖旧聊天记录才能继续。
• 明确 Controller、Owner、Executor、Reviewer 等角色的责任，并约束长期 owner 与 Controller 的轮换和交接。
• 将规划、实施、验证、独立 Review、Git、发布及外部操作拆分为独立门禁，避免一次授权被扩展成全部权限。
• 通过受保护路径、完整对象身份、单一 writer 和范围明确的授权包，阻止越权修改、并发覆盖及工作区漂移。
• 规范任务复用与新建、跨任务终态报告、范围门禁和安全异常路由，减少重复汇报、ACK 链和轮询。
• 通过版本化的 project-starter、注册工具和升级工具，让项目复制同一套流程，同时继续拥有自己的事实、任务、Controller 和 Framework pin。

它不是产品运行时、业务代码框架或中心化项目管理平台，而是约束人员与 AI 如何安全、连续地协作完成项目工作的流程基础设施。

版本权威

Framework 不存在全局默认版本，也不存在全局 CURRENT 版本。

• 每个现有项目都通过自己的 .ai-workspace/project.json.frameworkVersion 选择并持有 Framework 版本。
• 每次新项目注册都必须明确指定一个准确的稳定 Framework 版本。
• Framework 发行不会自动升级项目、发现消费者或记录消费者身份。
• 项目升级是由该项目自行拥有的独立任务，必须在项目自己的真实控制面和 Git 边界内执行。

只有同时满足以下条件的版本才可供项目采用：其 VERSION.json 声明 STABLE、consumable=true、projectPinEligible=true，并且 RELEASE_MANIFEST.json 完整、通过规范化校验且已获得独立 Review 批准。

仓库结构

framework/versions/ / 下已经发行的目录不可修改。新版本直接在其最终版本目录中开发，但在候选内容冻结、完成独立 Review 并正式封存前，不可供项目采用。无需另外维护一份平行的 draft 副本。

新项目初始化

注册流程复制所选版本中现有的 project-starter，不会另外创建第二套流程模型。

默认只执行预览。只有在取得项目写入授权后才能添加 -Apply。未提供 FrameworkVersion、版本未知、发行清单不完整或版本并非稳定版时，脚本会在写入项目之前失败。