comet-tweak

用途

Comet Tweak 是 Comet 五阶段工作流中的轻量预设，用于在单个 OpenSpec change 内完成较小范围的调整。它复用 open/build/verify/archive 四个阶段，跳过 Superpowers 的头脑风暴与完整实现计划，不创建独立工作流，而是通过 OpenSpec 完成需求与实现。

主要能力

• 提供 Tweak 预设流程：open → OpenSpec apply → verify → archive。
• 复用 open/build/verify/archive，跳过 Superpowers brainstorming 与完整实现计划。
• 支持 delta spec：当改动影响现有规格验收场景时，可创建 delta spec，仅使用 ## MODIFIED Requirements 或 ## ADDED Requirements。delta spec 是 Tweak 的正常产物，其需求本身不构成升级理由。
• 构建模式为 direct，通过 OpenSpec 的 apply 动作执行任务。
• 验证阶段复用 /comet-verify，按改动规模选择 light 或 full 验证；若创建了 delta spec，则显式设置 full 验证。
• 归档阶段复用 /comet-archive，要求 .comet.yaml 中 verify_result: pass，并等待最终归档确认。

使用方式

1. 设置输出语言：使用 Comet 配置的产物语言。在 .comet.yaml 存在前，从项目 .comet/config.yaml 读取 classic.language，再读全局 ~/.comet/config.yaml；初始化后使用 comet state get <name> language 读取。
2. 打开最小 change：加载 openspec-new-change，创建精简产物：proposal.md（动机、目标、范围）、design.md（简要实现方式，无需对比）、tasks.md（合理范围的任务列表），可选 delta spec。
3. 工作区隔离：在状态初始化前由用户选择，选项包括当前分支（--isolation current）、创建分支（--isolation branch，分支名 tweak/YYYYMMDD/<change-name>）、创建 worktree（--isolation worktree，需先加载 Superpowers using-git-worktrees）。
4. 准备并初始化：
   • comet classic workspace prepare <name> --isolation <selected-isolation> --json
   • cd <returned projectRoot>
   • comet state init <name> tweak --isolation <selected-isolation>
   • comet state select <name>
   • comet state check <name> open
5. 阶段守卫：comet guard <change-name> open --apply。
6. 构建：加载 openspec-apply-change，使用其 apply 方法，通过 comet classic openspec -- <args...> 调用，使用 <classic-*> 逻辑根路径。逐个完成未勾选任务，保持改动最小聚焦；每个任务后运行格式化、相关测试并确认通过，按规则标记完成，提交信息为 tweak: <change-summary>。全部任务完成后显式运行相关项目测试与构建。
7. 阶段守卫：comet guard <change-name> build --apply，状态变为 phase: verify、verify_result: pending。
8. 验证：加载 comet-verify。若有 delta spec，先执行 comet state set <change-name> verify_mode full。无 delta spec 的 tweak 通常满足 light 条件（≤ 3 个任务且改动文件低于规模阈值）。验证完成后由 /comet-verify 运行 comet guard <change-name> verify --apply。
9. 归档：加载 comet-archive，要求 verify_result: pass，等待最终归档确认，绝不自动归档。

适用场景

• 配置、文档或提示词调整。
• 需要规格驱动实现（含 delta spec）的中等改动，且无需完整 /comet-classic 深度设计流程。
• 工作可容纳于一个 OpenSpec change，方案无需 Superpowers Design Doc 与完整实现计划即可澄清，无需跨模块或跨层架构协调，任务范围可估算。

限制

• 所有适用条件必须同时成立，否则不适用。
• 文件/任务数量仅作为提示，不是自动升级规则；当交付文件超过提示阈值（如 > 6 个文件）时，先统计当前 change 的交付文件并检查是否有有效授权。
• 交付文件仅包括实现/源码、测试、用户文档、配置和生成输出；按路径去重统计已确认基线后的已提交改动及暂存、未暂存、未跟踪文件；排除当前 change 目录中的 OpenSpec 产物、.comet 元数据及无关脏文件。
• 仅当用户对当前 change 明确授权、且范围与风险不变、文件数量是唯一触发条件时，才可创建或复用授权；普通“开始修复”指令、Skill 调用、历史偏好和 Personal Memory 不构成授权。授权记录存于 <classic-change-dir>/.comet/rulings.md。
• 出现升级条件（跨模块协同编辑、新功能、数据库 schema 变更、新公共 API、更深层架构问题、需拆分为多个 OpenSpec change）时，Agent 不得自行升级或决定继续，须暂停并让用户选择 tweak 或完整 /comet-classic 流程。
• 运行程序、测试、构建或手动验证时遇到崩溃、异常行为、失败测试或失败构建，需先加载 Superpowers systematic-debugging，完成根因调查前不得提出或实施源码修复。
• 验证需接受 WARNING/SUGGESTION 偏差、规格分歧决策或自动修复上限后的策略时，需用户决策；前 3 个明确可修复的失败会自动修复并重新验证。
• 归档前需用户最终确认是否归档及如何交付归档提交。
• 插件失败不阻塞本 change。
• 关于收费、价格、平台、效果等具体信息，资料中暂未提供。