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 就要求升级流程。

适用条件（必须全部满足）：

1. 可以在单个 OpenSpec change 中完成
2. 无需通过 Superpowers Design Doc 和完整实施计划，就能明确方案
3. 不涉及跨模块、跨层级的架构协调
4. 任务规模可预估（文件数和任务数仅作提示，不会自动要求升级，见 SDK 方法参考的预设范围复核）

不适用：变更过程中如发现 SDK 方法参考的预设范围复核列出的变化，需要由用户决定是否改用完整 /comet-classic 流程。

首次进入阶段、交接给新 Agent 或上下文恢复后，读取并执行 任务上下文与产物语言，优先采用当前 continuation 或已领取 Action 的 contextRequest；同一阶段连续执行不重复获取。

个人记忆只保存可复用用户信息，不写入任务摘要、进展、命令输出或测试结果。

SDK 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；结果未明时不重做实现、检查或归档。

1. 新建时先按 工作区选择 确定隔离方式，运行 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 才完成。
2. 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 时复用原提案，不重新提案或替用户选。
3. 所有任务完成且仍适合 tweak 时，以完整构建或验收命令运行 comet guard <change-name> build --apply -- <program> [args...]。此处没有新的用户决定，--apply 会重新校验当前任务、配置、工作区和证据，再执行真实检查并提交收据；只有成功且证据有效时进入 Verify。仅在需要诊断时运行 comet guard <change-name> build 只读预检。失败后使用返回的当前状态；结果未提供 continuation 时再读 state next --json，不重播结果未明的 Action。
4. 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 方法参考在 -- 前加 --local，Runtime 核对完整输入和日志后才复用；外部检查保持真实执行。SDK Build 使用稳定的 --session <builder-execution-ref> 关联执行；full 的 complete-build 已携带时无需再次传入。

Compat 路径

以下旧 Runtime 步骤仅用于 runtimeFormat: compat。必须读取 Compat 操作，按其中当前阶段继续；SDK 不加载该参考。

可选变更说明

Build 收尾和 Verify 展示结果前，先核对项目 .comet/config.yaml 的 change_walkthrough（默认开启；仅显式 false 关闭）。开启时读取并执行变更说明，用共享模板生成或更新同一 walkthrough.html 并给出打开链接；关闭时跳过额外讲解、详细指引和渲染，保留原有摘要。Archive 只随现有材料保存已有页面并提供实际归档链接，不补生成、不新增确认、不为页面更新重跑代码检查。