comet-open

Comet 阶段 1：开启（Open）

开始或恢复前必须先读取并执行 comet-classic/reference/classic-layout.md；本文件中的 OpenSpec CLI 调用必须使用 adapter，文件路径必须使用该协议绑定的 <classic-*> 逻辑根。

前置条件

• 无活跃 change，或用户希望创建新 change

步骤

0. 输出语言约束

传递给 OpenSpec 的所有提问和产物要求都必须包含解析后的 Comet 产物语言，并使用 en、zh-CN 这类规范化 ID。.comet.yaml 尚不存在时依次读取项目 .comet/config.yaml 和全局 ~/.comet/config.yaml 的 classic.language；change 初始化后使用 comet state get <name> language 读取。没有配置语言时才回退到当前用户请求语言。生成的 proposal.md、design.md、tasks.md 必须以该语言为主语言。

0a. 当前 change 绑定

恢复已有 change 时先检查 <classic-change-dir>/.comet.yaml：

• 状态文件存在且可解析：先运行 comet classic workspace resolve <change-name> --json，进入返回的 projectRoot 后再选择 change
• 状态文件缺失但 change 目录有效：先使用所选隔离方式准备工作区，再进入返回的 projectRoot 运行 comet state init <change-name> full --isolation <selected-isolation>，最后选择 change
• 状态文件格式异常：停止并报告解析错误；从版本控制、备份或可验证产物人工修复后再继续，不得用 state set 覆盖损坏文件

comet classic workspace resolve <change-name> --json
# 进入返回的 projectRoot
comet state select <change-name>

创建新 change 时，必须先完成 .comet.yaml 初始化，再立即运行同一命令；状态文件不存在前不得伪造选择。

0b. Open 前工作区决策与准备

创建 Classic change 时读取 comet-classic/reference/workspace.md。工作区决策必须在创建 OpenSpec artifacts 和 .comet.yaml 之前完成，不能推迟到 Build：

• 用户明确表达并行意图时直接使用 worktree，确保在创建 OpenSpec 和 state 前准备好独立工作区
• 未指定隔离方式时按参考文档处理：需要决策时展示合法的 current、branch、worktree 选项，推荐只作说明
• 用户选择的 current 或 branch 仍表示串行方式，不得把它描述为适合同时会话

新 change 在运行 OpenSpec new 前准备工作区：

comet classic workspace prepare <name> --isolation <current|branch|worktree> --json
# 进入返回的 projectRoot；后续 OpenSpec、state 和产物写入都必须在该目录执行

准备命令会复用已登记且分支匹配的 Worktree；分支仍存在但登记的 Worktree 已被移除时会重建。只有分支已重命名、被用户接管或无法确认归属时，才暂停请求显式 rebind。

0c. OpenSpec 兼容性检查

在任何 OpenSpec 状态或指令命令前运行：

comet classic openspec -- --version

本流程要求 OpenSpec >= 1.5.0。版本低于 1.5.0、无法解析版本、命令不可用或返回非零退出码时立即停止，并提示运行 npm install -g @fission-ai/openspec@latest 后重试；不得继续使用缺少 applyRequires、artifactPaths、changeRoot 或 resolvedOutputPath 契约的旧 CLI。

1. 探索想法与需求澄清