comet-tweak
使用 Classic 预设流程完成单个 change 的轻量调整。在用户明确调用 /comet-tweak、选择 tweak,或恢复 workflow: tweak 时使用。
- License 许可
- MIT
- 所属仓库
- rpamis/comet
- 最近更新
- 2026-11-15
- Stars
- ★ 3.3k
- Forks
- 314
01 前言 Front Matter
- name
- comet-tweak
- description
- 使用 Classic 预设流程完成单个 change 的轻量调整。在用户明确调用 /comet-tweak、选择 tweak,或恢复 workflow: tweak 时使用。
02 资源文件 2
- 参考文档agents/openai.yaml198 B
- 参考文档reference/compat.md19.8 KB
03 SKILL.md 正文
Comet 预设路径:Tweak
开始或恢复任务前,必须先读取并遵守 comet-classic/reference/classic-layout.md。本文件中的 OpenSpec CLI 调用必须通过适配器执行,文件路径必须基于该协议绑定的 <classic-*> 逻辑根目录。
Tweak 为 Comet 五阶段流程提供一组预设配置。它通过 OpenSpec 完成需求与实施工作,复用 open、build、verify、archive 阶段,跳过 Superpowers brainstorming 和完整实施计划,不另建一套独立流程。
适用于配置调整、文档或提示词优化等轻量改动,也适用于需要依据 spec(含 delta spec)实施、但不需要完整 /comet-classic 深度设计的中等变更。Tweak 正常支持 delta spec,不能仅因为需要 delta spec 就要求升级流程。
适用条件(必须全部满足):
- 可以在单个 OpenSpec change 中完成
- 无需通过 Superpowers Design Doc 和完整实施计划,就能明确方案
- 不涉及跨模块、跨层级的架构协调
- 任务规模可预估(文件数和任务数仅作提示,不会自动要求升级,见 SDK 方法参考的预设范围复核)
不适用:变更过程中如发现 SDK 方法参考的预设范围复核列出的变化,需要由用户决定是否改用完整 /comet-classic 流程。
首次进入阶段、交接给新 Agent 或上下文恢复后,读取并执行 任务上下文与产物语言,优先采用当前 continuation 或已领取 Action 的 contextRequest;同一阶段连续执行不重复获取。
个人记忆只保存可复用用户信息,不写入任务摘要、进展、命令输出或测试结果。
SDK Run 路径
先读取并执行普通命令与检查。新旧 Run 均使用平台工具执行普通命令,在原 Run 提交实际检查报告;自动升级不恢复旧检查执行器。阶段准备、用户选择、任务完成和验收要求继续有效。
首次进入当前 SDK 阶段、换 Agent 或恢复上下文时,读取阶段入口与恢复及该参考的当前阶段章节;本会话已有且仍有效时直接复用。下文按当前阶段执行;nextAction.kind 的恢复路由只适用于没有 continuation mode 的旧响应。
开始或恢复时,优先复用当前有效结果中的 agent.continuation / data.nextAction 及已绑定的 change、工作区、phase 和 Run revision,按已知的 data.runtimeFormat 路由。只有冷恢复、外部状态变化或缺少这些信息时,才运行 comet state next <change-name> --json。sdk 只按本节推进;SDK 方法参考的适用条件、OpenSpec apply 方法、升级判定和文件数授权规则仍适用,状态与证据通过本节命令提交。若 nextAction.kind 为 reconcile,运行 comet state check <change-name> <phase> --recover --json 核对原 Action;结果未明时不重做实现、检查或归档。
- 新建时先按 工作区选择 确定隔离方式,运行
comet classic workspace prepare <name> --isolation <selected-isolation> --json,进入返回的projectRoot,先按 开始与产物 创建 OpenSpec 基础目录,再运行comet state init <name> tweak --isolation <selected-isolation>,随后运行comet state select <name>绑定 Hook 路由。按 SDK 方法参考的开始与产物章节创建 OpenSpec 产物,包括本次确需的 delta spec;运行comet guard <change-name> open --json预览确认内容,保存返回的data.approvalHash。向用户展示本次 Open 产物与范围,获得明确批准后,运行comet guard <change-name> open --apply --approval-hash <approvalHash>。产物变化后必须重新预览并确认,不复用旧哈希。只有 Run 进入 Build,Open 才完成。 tweak.build.execute待执行时,沿用本次 change、工作区和 Run,直接恢复 Build,不重新初始化或重跑 Open。按 SDK 方法参考的预设范围复核章节的 OpenSpec apply 方法读取指令与上下文,逐项实施并勾选同一 tasks.md。出现实质升级信号或文件数超限且无有效授权时,先运行comet state propose-escalation <change-name> --reason "<reason>";向用户展示当前原因和继续 tweak / 升级 full 的影响,并保存返回的data.wait.proposalHash。用户明确选择后运行comet state decide-escalation <change-name> --proposal-hash <proposalHash> --choice <continue|upgrade>。continue仍须满足 SDK 方法参考的范围、风险与 ruling 要求;upgrade在同一个 Run 和工作区进入 full Design,立即按入口加载 comet-design。恢复待决定 Wait 时复用原提案,不重新提案或替用户选。- 所有任务完成、必要检查与审查完成且仍适合当前预设时,运行
comet state complete-build <change-name> --session <builder-execution-ref> --checks <checks-json-file>提交实际结果。此处没有新的用户决定;Runtime 核对当前任务、配置、工作区和报告后进入 Verify。失败或结果未明时按返回的当前 Action 核对原任务,不重复执行。 - Run 进入 Verify 时,立即执行: 使用 Skill 工具加载 comet-verify 技能。禁止跳过此步骤。若有 delta spec,按 SDK 方法参考的完整验证方法覆盖其一致性,不调用旧
state set verify_mode。Run 进入 Archive 时,立即执行: 使用 Skill 工具加载 comet-archive 技能。禁止跳过此步骤。归档和交付仍须获得用户当前授权;当前成功结果显示 Run 完成后才能宣告完成;缺少完成状态时再读state next --json。
每次推进后,优先使用同次结果的 agent.continuation / data.nextAction;状态仍有效且信息完整时,不重复 next、select 或 check。仅在冷恢复、外部状态变化或缺少必要信息时补读。decision、evidence、reconcile 先处理当前 Run 的等待或恢复;action 才执行对应步骤。
SDK Build 使用真实的 --session <builder-execution-ref> 关联执行;已经携带时无需再次传入。
Compat 路径
以下旧 Runtime 步骤仅用于 runtimeFormat: compat。必须读取 Compat 操作,按其中当前阶段继续;SDK 不加载该参考。
可选变更说明
Build 收尾和 Verify 展示结果前,先核对项目 .comet/config.yaml 的 change_walkthrough(默认开启;仅显式 false 关闭)。开启时读取并执行变更说明,用共享模板生成或更新同一 walkthrough.html 并给出打开链接;关闭时跳过额外讲解、详细指引和渲染,保留原有摘要。Archive 只随现有材料保存已有页面并提供实际归档链接,不补生成、不新增确认、不为页面更新重跑代码检查。
04 同仓库更多 Skills
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
verification-before-completion
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
using-git-worktrees
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes