Menu
Comet 预设路径：非 bug 的小改动（tweak）。跳过 brainstorming 和完整 plan，直接 open → lightweight build → light verify → archive。适用于文案、配置、文档或 prompt 的局部优化。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | comet-tweak |
| description | Comet 预设路径：非 bug 的小改动（tweak）。跳过 brainstorming 和完整 plan，直接 open → lightweight build → light verify → archive。适用于文案、配置、文档或 prompt 的局部优化。 |
Tweak 是 Comet 五阶段能力的预设工作流，不是独立的平行流程。它复用 open、build、verify、archive 能力，仅跳过 brainstorming 和完整 plan。
适用于非 bug 的小范围变更，例如文案调整、配置调整、文档或 prompt 的局部优化。
适用条件（必须全部满足）：
不适用：如变更过程中发现需要 capability、架构或接口调整，应升级为完整 /comet 流程。
精简版 OpenSpec 产物必须使用触发本次工作流的用户请求语言。
执行链路：open → lightweight build → light verify → archive。Tweak 为每个阶段提供默认决策：精简开启、轻量构建、轻量验证、验证通过后进入归档前最终确认。
开始前先定位 Comet 脚本：
COMET_ENV="${COMET_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" "$HOME/.gemini" -path '*/comet/scripts/comet-env.sh' -type f -print -quit 2>/dev/null)}"
if [ -z "$COMET_ENV" ]; then
echo "ERROR: comet-env.sh not found. Ensure the comet skill is installed." >&2
return 1
fi
. "$COMET_ENV"
复用 Comet open 能力创建 change，但使用 tweak 默认值：不执行 openspec-explore 长探索，直接进入精简 change 创建。
立即执行： 使用 Skill 工具加载 openspec-new-change 技能。禁止跳过此步骤。
技能加载后，按其指引创建精简版产物：
proposal.md — 变更动机 + 目标 + 范围design.md — 简短实现说明（无需方案对比）tasks.md — 不超过 3 个任务/comet）初始化 Comet 状态文件：
"$COMET_BASH" "$COMET_STATE" init <name> tweak
初始化后验证状态：
"$COMET_BASH" "$COMET_STATE" check <name> open
阶段守卫完成 open → build 过渡：
"$COMET_BASH" "$COMET_GUARD" <change-name> open --apply
使用 tweak 默认值：build_mode: direct。跳过 Superpowers brainstorming 和 writing-plans。
继续或开始修改前，按 comet/reference/dirty-worktree.md 协议处理未提交改动。若归因后发现范围超出 tweak，按本文件“升级条件”处理。
立即执行： 按 tasks.md 逐个执行任务：
openspec/changes/<name>/tasks.md，获取未完成任务列表mvn spotless:apply、npm run format 等）- [ ] 勾选为 - [x]tweak: <简述变更>执行 tweak 期间，只要运行程序、测试、构建或手动验证时出现崩溃、异常行为、测试失败或构建失败，必须使用 Skill 工具加载 Superpowers systematic-debugging 技能。在完成根因调查前，不得提出或实施源码修复。
具体调查、最小失败测试、修复验证和保持当前 change 验证闭环的要求，按 comet/reference/debug-gate.md 执行。
"$COMET_BASH" "$COMET_GUARD" <change-name> build --apply
状态文件自动更新为 phase: verify、verify_result: pending，然后进入验证。
复用 /comet-verify。Tweak 必须保持轻量验证条件：≤ 3 tasks、≤ 4 files、无 delta spec、无新 capability。
立即执行： 使用 Skill 工具加载 comet-verify 技能。禁止跳过此步骤。
如规模评估进入完整验证路径，停止 tweak，按升级条件阻塞确认处理。
验证通过后，按 /comet-verify 的规则将 .comet.yaml 的 verify_result 记录为 pass，归档前不得跳过该状态。验证通过后仍必须进入 /comet-archive 的归档前最终确认，不得自动运行归档脚本。
复用 /comet-archive。归档前必须满足 .comet.yaml 中 verify_result: pass，并等待 /comet-archive 的归档前最终确认。
立即执行： 使用 Skill 工具加载 comet-archive 技能进行归档。禁止跳过此步骤。
执行顺序：快速开启 → 轻量构建 → 轻量验证 → 归档 → 完成
每个阶段完成后立即进入下一阶段。阶段内部仍必须按上文要求调用对应 Comet/OpenSpec/Superpowers skill，被调用的 skill 如有自己的用户决策点，按该 skill 规则执行。
满足以下任一条件时，停止 tweak 流程，升级为完整 /comet：
| 条件 | 说明 |
|---|---|
| 改动涉及 5+ 文件 | 超出小改动范围 |
| 多模块协调修改 | 需要跨组件协调 |
| 需要新增测试用例 5+ | 变更复杂度上升 |
| 配置项新增或删除 | 非值修改的配置变更 |
| 需要新增 capability | 超出局部优化 |
| 需要 delta spec | 影响了已有规格 |
满足升级条件时必须按 comet/reference/decision-point.md 的协议暂停并等待用户明确确认升级为完整 /comet 流程。不得直接进入 /comet-design，不得自动补充 Design Doc。
用户确认升级后，必须先更新 workflow 和 phase 字段再进入完整流程：
"$COMET_BASH" "$COMET_STATE" set <name> workflow full
"$COMET_BASH" "$COMET_STATE" set <name> phase design
然后在当前 change 基础上补充 Design Doc：立即使用 Skill 工具加载 comet-design skill，后续正常走完整流程。若用户不确认升级，停止 tweak 并报告当前变更已超出 tweak 适用范围。
"$COMET_BASH" "$COMET_GUARD" <change-name> build --apply，verify → archive 前按 /comet-verify 规则运行 "$COMET_BASH" "$COMET_GUARD" <change-name> verify --apply按 comet/reference/auto-transition.md 执行。关键命令：
"$COMET_BASH" "$COMET_STATE" next <name>
NEXT: auto → 调用 SKILL 指向的 skill 继续 tweak 流程（phase: build 返回 comet-tweak，verify 返回 comet-verify，archive 返回 comet-archive）NEXT: manual → 不要调用下一 skill，按 HINT 提示用户手动运行 /<SKILL>NEXT: done → 流程已完成，无需继续Comet 阶段 5：归档。用 /comet-archive 调用。按 OpenSpec delta 语义合并主 spec，归档 change。
Comet 阶段 3：计划与构建。用 /comet-build 调用。制定计划并选择执行方式（subagent 或直接执行）实施。
Comet 阶段 2：深度设计。用 /comet-design 调用。通过 brainstorming 产出 Design Doc 和 delta spec。
Comet 预设路径：Bug fix / 热修复。跳过 brainstorming，直接 open → build → verify → archive。适用于行为修复、不涉及新 capability 设计的场景。
Comet 阶段 1：开启。用 /comet-open 调用。通过 OpenSpec 探索想法、确认需求澄清，再创建 change 结构（proposal + design + tasks）。
Comet — OpenSpec + Superpowers 双星开发流程。用 /comet 启动，自动检测阶段并分发到子命令。五阶段：开启 → 深度设计 → 计划与构建 → 验证与收尾 → 归档。