Menü
Use when 用户要修复已有行为 bug，且不新增 capability、不需要完整设计；也用于恢复 hotfix workflow。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
Use only when explicitly invoked as /comet-any or when the user explicitly wants to customize the /comet-classic five-phase workflow or create/upgrade a workflow Skill managed by Comet Creator. Do not use for general Skill authoring, cleanup, or review.
Use only when explicitly invoked as /comet-archive or routed by the root Comet skill/runtime to the archive phase; confirm archive, merge delta specs, and finish the branch.
Use only when explicitly invoked as /comet-build or routed by the root Comet skill/runtime to a full workflow build phase; create or recover the implementation plan and execute tasks.
Use when the user explicitly invokes /comet-classic, asks to start or resume the permanent Comet Classic workflow, or repository evidence identifies one unambiguous active Classic change; route through the intent runtime and .comet.yaml.
Use only when explicitly invoked as /comet-design or routed by the root Comet skill/runtime to a full workflow design phase; create or recover the deep technical Design Doc.
Use only when explicitly invoked as /comet-hotfix or routed by the root Comet skill/runtime to the hotfix preset; fix an existing behavior bug, not an ordinary unmanaged bugfix.
| name | comet-hotfix |
| description | Use when 用户要修复已有行为 bug，且不新增 capability、不需要完整设计；也用于恢复 hotfix workflow。 |
快速 bug fix 工作流：open → build → verify → archive。跳过 brainstorming 和完整 plan，适用于行为修复、不涉及新 capability 设计的场景。
适用条件（必须全部满足）：
不适用：如修复过程命中质变信号（见「升级判定」章节），由用户决定是否升级为完整 /comet 流程。
精简版 OpenSpec 产物必须使用触发本次工作流的用户请求语言。
执行链路：open → build → verify → archive。Hotfix 为每个阶段提供默认决策：精简开启、直接构建、按规模验证、验证通过后进入归档前最终确认。
开始前按 comet/reference/scripts.md 定位 Comet 脚本（定位 comet-env.mjs）；从任意入口恢复时先按 comet/reference/context-recovery.md 确认 phase/workflow。
复用 Comet open 能力创建 change，但使用 hotfix 默认值：不执行 openspec-explore 长探索，直接进入精简 change 创建。
立即执行： 使用 Skill 工具加载 openspec-new-change 技能。禁止跳过此步骤。
技能加载后，按其指引创建精简版产物：
proposal.md — 问题描述 + 根因分析 + 修复目标（无需方案对比）design.md — 修复方案（1 个即可，无需多方案对比）tasks.md — 修复任务清单初始化 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 2NEXT: manual → 暂停，按 HINT 提示用户手动运行 /<SKILL>使用 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 逐个执行任务：
openspec/changes/<name>/tasks.md，获取未完成任务列表mvn spotless:apply、npm run format 等）- [ ] 勾选为 - [x]fix: <简述修复>执行 hotfix 期间，只要运行程序、测试、构建或手动验证时出现崩溃、异常行为、测试失败或构建失败，必须使用 Skill 工具加载 Superpowers systematic-debugging 技能。在完成根因调查前，不得提出或实施源码修复。
具体调查、最小失败测试、修复验证和保持当前 change 验证闭环的要求，按 comet/reference/debug-gate.md 执行。
如修复影响已有 spec 验收场景：
openspec/changes/<name>/specs/<capability>/spec.md 创建 delta spec## MODIFIED Requirements 部分在运行 build guard 之前执行，确保修复确实消除了问题根因：
升级判定信号：
根因确认消除后，运行阶段守卫完成 build → verify 过渡：
node "$COMET_GUARD" <change-name> build --apply
状态文件自动更新为 phase: verify、verify_result: pending，然后进入验证。
复用 /comet-verify，由 comet-verify 的规模评估决定轻量或完整验证。
立即执行： 使用 Skill 工具加载 comet-verify 技能。禁止跳过此步骤。
无 delta spec 的小范围 hotfix 通常满足轻量验证条件（≤ 3 tasks、改动文件数低于 scale 阈值），comet-verify 的规模评估会选择轻量验证路径（6 项快速检查；默认 review_mode: off 时不自动派发代码审查）。若用户希望增加审查，可在验证前运行 node "$COMET_STATE" set <name> review_mode standard 或 thorough。若 hotfix 创建了 delta spec，则根据 comet-verify 的规模评估规则进入完整验证路径。
验证通过后，按 /comet-verify 的规则将 .comet.yaml 的 verify_result 记录为 pass，归档前不得跳过该状态。验证通过后仍必须进入 /comet-archive 的归档前最终确认，不得自动运行归档脚本。
复用 /comet-archive。归档前必须满足 .comet.yaml 中 verify_result: pass，并等待 /comet-archive 的归档前最终确认。
立即执行： 使用 Skill 工具加载 comet-archive 技能进行归档。禁止跳过此步骤。
如有 delta spec，按 comet-archive 规则同步到 main spec，并处理关联 Design Doc 与 Plan 的归档标注。
/comet 流程/comet-build 时的工作区隔离和执行方式选择执行顺序：快速开启 → 直接构建 → 根因消除检查 → 验证 → 归档 → 完成
每个阶段完成后立即进入下一阶段。阶段内部仍必须按上文要求调用对应 Comet/OpenSpec/Superpowers skill，被调用的 skill 如有自己的用户决策点，按该 skill 规则执行。
hotfix 的升级判定只决定是否从预设流程转为 full；文件数不自动升级，comet-state scale 只决定验证轻重。
若由 /comet 入口传入 intent frame，hotfix 在 build 前只复核 risk_signal 和升级信号：新增 capability、public API、schema 变更、跨模块协调或深层架构问题。命中时进入现有升级决策点；不得重新实现入口意图识别。
持续检查以下质变信号：跨模块协调修改、需要新增 capability、数据库 schema 变更、引入新的 public API、触及深层架构问题（hotfix 语境下多在根因消除检查时暴露）。命中任一信号时，agent 不得自行升级或自行判定可继续。
文件数 tripwire 仅作提示：改动文件数超过提示阈值（如 > 4 个文件）时，也交给用户决定继续 hotfix 还是升级 full；文件数多不等于质变。bug 修复通常聚焦在 1-3 个文件，超过阈值说明改动面偏大、值得让用户复核是否仍属预设范围。
命中质变信号或文件数 tripwire 时，必须按 comet/reference/decision-point.md 的协议暂停并等待用户明确选择。不得直接进入 /comet-design，不得自动补充 Design Doc。
用户选择升级（选项 B）后，使用状态机合法的升级通道，单条命令完成预设流程 → full 转换并回退到 design 阶段：
node "$COMET_STATE" transition <name> preset-escalate
该命令原子地把 workflow/classic_profile 置为 full、phase 回退到 design、清空 design_doc（满足 comet-design 入口要求）。然后在当前 change 基础上补充 Design Doc：立即使用 Skill 工具加载 comet-design skill，后续正常走完整流程。
用户选择继续（选项 A）时，继续 hotfix 流程，并记录用户确认继续的原因。
node "$COMET_GUARD" <change-name> build --apply，verify → archive 前按 /comet-verify 规则运行 node "$COMET_GUARD" <change-name> verify --apply按 comet/reference/auto-transition.md 执行。关键命令：
node "$COMET_STATE" next <name>
NEXT: auto → 调用 SKILL 指向的 skill 继续 hotfix 流程（phase: build 返回 comet-hotfix，verify 返回 comet-verify，archive 返回 comet-archive）NEXT: manual → 不要调用下一 skill，按 HINT 提示用户手动运行 /<SKILL>NEXT: done → 流程已完成，无需继续