Comet 预设路径：Hotfix

快速 bug fix 工作流：open → build → verify → archive。跳过 brainstorming 和完整 plan，适用于行为修复、不涉及新 capability 设计的场景。

适用条件（必须全部满足）：

1. 修复已有功能的 bug，不新增 capability
2. 不涉及接口变更或架构调整
3. 改动范围可预估（文件数仅作提示，不作为硬性升级条件，见下方升级判定）

不适用：如修复过程命中质变信号（见「升级判定」章节），由用户决定是否升级为完整 /comet 流程。

---

流程（预设流程，6 步）

0. 输出语言约束

精简版 OpenSpec 产物必须使用触发本次工作流的用户请求语言。

执行链路：open → build → verify → archive。Hotfix 为每个阶段提供默认决策：精简开启、直接构建、按规模验证、验证通过后进入归档前最终确认。

开始前按 comet/reference/scripts.md 定位 Comet 脚本（定位 comet-env.mjs）；从任意入口恢复时先按 comet/reference/context-recovery.md 确认 phase/workflow。

1. 快速开启（预设 open）

复用 Comet open 能力创建 change，但使用 hotfix 默认值：不执行 openspec-explore 长探索，直接进入精简 change 创建。

立即执行： 使用 Skill 工具加载 openspec-new-change 技能。禁止跳过此步骤。

技能加载后，按其指引创建精简版产物：

• proposal.md, 问题描述 + 根因分析 + 修复目标（无需方案对比）
• design.md, 修复方案（1 个即可，无需多方案对比）
• tasks.md, 修复任务清单
• 无需 delta spec（除非修复改变了已有 spec 的验收场景）

初始化 Comet 状态文件：

node "$COMET_STATE" init <name> hotfix

初始化后验证状态：

node "$COMET_STATE" check <name> open

阶段守卫完成 open → build 过渡：

node "$COMET_GUARD" <change-name> open --apply

检查 auto_transition 决定是否继续：

node "$COMET_STATE" next <name>

• NEXT: auto → 继续 Step 2
• NEXT: manual → 暂停，按 HINT 提示用户手动运行 /<SKILL>

2. 直接构建（预设 build）

使用 hotfix 默认值：build_mode: direct，review_mode: off（hotfix/tweak 跳过 review_mode 选择, , guard 不要求预设工作流选择此项）。跳过 Superpowers brainstorming 和 writing-plans（除非任务 > 3 个；若超过 3 个任务，转入 /comet-build 的计划与执行方式选择, , 注意这不触发 full workflow 升级，仅切换执行方式）。

继续或开始修改前，按 comet/reference/dirty-worktree.md 协议处理未提交改动。若归因后发现修复命中质变信号或文件数 tripwire，按本文件「升级判定」处理。

立即执行： 按 tasks.md 逐个执行任务：

1. 读取 openspec/changes/<name>/tasks.md，获取未完成任务列表
2. 对每个未完成任务：
   • 根据任务描述修改代码
   • 运行项目格式化命令（如 mvn spotless:apply、npm run format 等）
   • 运行相关测试确认通过
   • 将 tasks.md 中对应 - [ ] 勾选为 - [x]
   • 提交代码，commit message 格式：fix: <简述修复>
3. 全部任务完成后，显式运行项目相关测试和构建命令