Skills

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 本身不构成升级理由。

适用条件(必须全部满足):

  1. 可收敛为单一 OpenSpec change
  2. 不需要 Superpowers Design Doc 和完整 plan 才能澄清方案
  3. 不涉及跨模块、跨层级的架构协调
  4. 任务规模可预估(文件数和任务数仅作提示,不作为硬性升级条件,见下方升级判定)

不适用:如变更过程中命中质变信号(见「升级判定」章节),由用户决定是否升级为完整 /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。

<IMPORTANT> 这条 apply 路径只属于 tweak。完整 `/comet` 或 `workflow: full` 不得套用 tweak 的 `openspec-apply-change` 构建路径;full 仍必须先通过 `/comet-design` 生成 Design Doc,再由 `/comet-build` 通过 Superpowers `writing-plans`、执行方式选择和对应执行技能完成构建。 </IMPORTANT>
Read the whole SKILL.md on GitHub

More in Engineering