comet-classic

Comet Classic — OpenSpec + Superpowers 双星开发流程

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

OpenSpec 与 Superpowers 如双星系统围绕同一目标运转。

OpenSpec 负责 WHAT  — 大纲、提案、spec 生命周期、归档
Superpowers 负责 HOW — 技术设计、计划、执行、收尾

核心原则：brainstorming 必不可跳过。每次变更都必须经过深度设计（hotfix 和 tweak 预设除外）。

---

决策核心（Decision Core）

agent 做决策只需读本节，参考附录按需查阅。

输出语言规则

所有 OpenSpec 和 Superpowers 产物都必须使用 Comet 配置的产物语言。配置值是规范化语言 ID，en 或 zh-CN。已有 change 优先通过 comet state get <name> language 读取 <classic-change-dir>/.comet.yaml 中的 language；.comet.yaml 尚不存在时依次读取项目 .comet/config.yaml 和全局 ~/.comet/config.yaml 的 classic.language；都不存在时才回退到当前用户请求语言。调用外部 OpenSpec/Superpowers skill 时，必须把解析后的语言显式写入 prompt 或 ARGUMENTS。

阶段自动检测

Step 0: 活跃 Change 发现与意图判定

1. 先按 comet-classic/reference/scripts.md 直接运行公开 Comet CLI 命令。
2. 运行 comet classic openspec -- list --json 获取所有活跃 change。
3. 根据用户请求、active change 列表和必要仓库状态填写 CometIntentFrame。
4. 优先用 comet classic intent route --stdin 传入 frame JSON，获取 runtime 规范化路由。CometIntentFrame + runtime scorer 是事实源；本节自然语言规则只用于意图识别槽位提取。
5. 按 runtime route 处理：
   • hotfix → 直接调用 /comet-hotfix
   • tweak → 直接调用 /comet-tweak
   • full → 按活跃 change 表决定 /comet-open 或用户确认
   • resume → 进入 Step 1 读取对应 change 的 .comet.yaml
   • ask_user → 按 comet-classic/reference/decision-point.md 暂停并等待用户选择
   • out_of_scope → 说明本次输入不是 Comet workflow 启动/恢复请求，不初始化 change

当 runtime route、Ambient Resume 或用户选择已经解析出明确 change 后，进入对应阶段 Skill 前必须先绑定当前执行上下文：

comet classic workspace resolve <change-name> --json
# 进入返回的 projectRoot；state select 会在该工作区写入选择
comet state select <change-name>

新 change 的 workspace 决策在 /comet-open 完成，并遵循 comet-classic/reference/workspace.md：用户明确表达并行、同时处理或多个会话时，在绑定前准备 Worktree；未指定隔离方式时，需要决策就把 current、branch、worktree 作为单选项展示，推荐只作说明。准备和恢复都会扫描已登记 Worktree，优先复用分支匹配的工作区；当分支已重命名、被用户接管或无法确认归属时请求 rebind。

多个 active change 且用户尚未明确选择时，不得提前绑定；继续按 ask_user 决策点等待选择。