
Comet Tweak
Use when 用户要进行可收敛为单一 OpenSpec change 的轻量或中等变更,且不需要完整设计;也用于恢复 tweak workflow。
Install
npx skills add rpamis/comet --skill comet-tweak -g -a claude-code -y- Repository
- rpamis/comet3.3k
- Category
- Engineering
- Updated
- 3d ago
- License
- MIT
- Context cost
- Mediumabout 1,599 tokens
- Runs scripts
- No, instructions only
What it does
Use when 用户要进行可收敛为单一 OpenSpec change 的轻量或中等变更,且不需要完整设计;也用于恢复 tweak workflow。
Comet 预设路径:Tweak
Tweak 是 Comet 五阶段能力的预设工作流,不是独立的平行流程。它串联 OpenSpec 的核心流程,复用 open、build、verify、archive 能力,仅跳过 Superpowers brainstorming 和完整 plan。
适用于串联 OpenSpec 的轻量改动,例如配置调整、文档或 prompt 优化,以及需 spec 驱动(含 delta spec)但不需要完整 /comet 深度设计流程的中等变更。delta spec 在 tweak 中是一等公民正常产物,需要 delta spec 本身不构成升级理由。
适用条件(必须全部满足):
- 可收敛为单一 OpenSpec change
- 不需要 Superpowers Design Doc 和完整 plan 才能澄清方案
- 不涉及跨模块、跨层级的架构协调
- 任务规模可预估(文件数和任务数仅作提示,不作为硬性升级条件,见下方升级判定)
不适用:如变更过程中命中质变信号(见「升级判定」章节),由用户决定是否升级为完整 /comet 流程。
流程(预设流程,4 阶段)
0. 输出语言约束
精简版 OpenSpec 产物必须使用触发本次工作流的用户请求语言。
执行链路:open → OpenSpec apply → verify → archive。Tweak 为每个阶段提供默认决策:精简开启、通过 OpenSpec apply 直接构建、按规模与 delta spec 判定验证轻重、验证通过后进入归档前最终确认。
开始前按 comet/reference/scripts.md 定位 Comet 脚本(定位 comet-env.mjs);从任意入口恢复时先按 comet/reference/context-recovery.md 确认 phase/workflow。
1. 快速开启(预设 open)
复用 Comet open 能力创建 change,但使用 tweak 默认值:不执行 openspec-explore 长探索,直接进入精简 change 创建。
立即执行: 使用 Skill 工具加载 openspec-new-change 技能。禁止跳过此步骤。
技能加载后,按其指引创建精简版产物:
proposal.md, 变更动机 + 目标 + 范围design.md, 简短实现说明(无需方案对比)tasks.md, 任务清单(建议控制在合理规模,数量本身不触发升级,见「升级判定」)delta spec(可选), 若变更影响已有 spec 的验收场景,作为正常产物创建(仅含## MODIFIED Requirements或## ADDED Requirements)。delta spec 是 OpenSpec brownfield 改动的核心产物,需要 delta spec 本身不构成升级理由
初始化 Comet 状态文件:
node "$COMET_STATE" init <name> tweak
初始化后验证状态:
node "$COMET_STATE" check <name> open
阶段守卫完成 open → build 过渡:
node "$COMET_GUARD" <change-name> open --apply
2. OpenSpec apply 构建(tweak 专用预设 build)
使用 tweak 默认值:build_mode: direct。跳过 Superpowers brainstorming 和 writing-plans,改由 OpenSpec 的 apply action 执行当前 change 的 tasks。
