@rpamis/comet 0.1.1 → 0.1.3

package/assets/skills/comet-build/SKILL.md

@@ -12,6 +12,32 @@ description: "Comet 阶段 3：计划与构建。用 /comet-build 调用。制
 
 ## 步骤
 
+### 0. 入口状态验证（Entry Check）
+
+在执行任何操作之前，读取并验证当前状态：
+
+**检查清单：**
+1. `openspec/changes/<name>/.comet.yaml` 存在
+2. `phase` 字段的值为 `"build"`
+3. `design_doc` 字段非 null 且非空
+4. `design_doc` 引用的文件存在（例如 `docs/superpowers/specs/YYYY-MM-DD-topic-design.md`）
+5. `openspec/changes/<name>/proposal.md` 存在且非空
+6. `openspec/changes/<name>/tasks.md` 存在且非空
+
+**验证方式：**
+- `cat openspec/changes/<name>/.comet.yaml` 读取全部字段
+- 用 `ls` 或 `test -f` 确认 design_doc 文件存在
+
+**失败输出：**
+```
+[HARD STOP] Entry check failed for comet-build
+  Expected: phase=build, design_doc=<path> exists
+  Actual:   phase=<实际值>, design_doc=<实际值或文件不存在>
+  Suggestion: Run comet-design first, or verify design_doc file exists.
+```
+
+验证通过后才进入步骤 1。
+
 ### 1. 制定计划
 
 **立即执行：** 使用 Skill 工具加载 `superpowers:writing-plans` 技能。禁止跳过此步骤。
@@ -30,14 +56,18 @@ design-doc: docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
 
 ### 2. 更新计划状态
 
-在 `openspec/changes/<name>/.openspec.yaml` 中合并更新：
+在 `openspec/changes/<name>/.comet.yaml` 中合并更新以下字段（保留其他字段不变）：
 
 ```yaml
-comet:
-  phase: build
-  plan: docs/superpowers/plans/YYYY-MM-DD-feature.md
+phase: build
+plan: docs/superpowers/plans/YYYY-MM-DD-feature.md
 ```
 
+【写入验证】更新完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 plan 行的值为 "docs/superpowers/plans/YYYY-MM-DD-feature.md"
+  如不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ### 3. 选择执行方式
 
 向用户展示计划摘要（任务数、涉及模块），然后询问执行方式：
@@ -52,7 +82,7 @@ comet:
 - 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
 - 来自 hotfix 路径 → 推荐 B
 
-用户选择后，在 `openspec/changes/<name>/.openspec.yaml` 中记录实际执行方式。`build_mode` 只允许以下值之一：
+用户选择后，在 `openspec/changes/<name>/.comet.yaml` 中合并更新 `build_mode`（保留其他字段不变）。`build_mode` 只允许以下值之一：
 
 - `subagent-driven-development`
 - `executing-plans`
@@ -62,16 +92,19 @@ Few-shot 示例：
 
 ```yaml
 # 用户选择稳健模式 / A
-comet:
-  build_mode: subagent-driven-development
+build_mode: subagent-driven-development
 ```
 
 ```yaml
 # 用户选择快速模式 / B
-comet:
-  build_mode: executing-plans
+build_mode: executing-plans
 ```
 
+【写入验证】更新完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 build_mode 行的值为 "<subagent-driven-development 或 executing-plans 或 direct>"
+  如不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 然后，**立即执行：** 使用 Skill 工具加载对应技能。禁止跳过此步骤。
 
 如所选 Superpowers 技能不可用，停止流程并提示安装或启用对应技能，不要用普通对话替代该步骤。
@@ -105,16 +138,22 @@ comet:
 - tasks.md 全部勾选
 - 代码已提交
 - 测试通过
-- `.openspec.yaml` 中 `comet.phase` 已更新为 `verify`
+- `.comet.yaml` 中 `phase` 已更新为 `verify`
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> build`，全部 PASS 后才允许流转
 
-退出前合并更新：
+退出前在 `.comet.yaml` 中合并更新以下字段（保留其他字段不变）：
 
 ```yaml
-comet:
-  phase: verify
-  verify_result: pending
+phase: verify
+verify_result: pending
 ```
 
+【写入验证】更新完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 phase 行的值为 "verify"
+  确认 verify_result 行的值为 "pending"
+  如任一字段不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ## 自动流转
 
 退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：

package/assets/skills/comet-design/SKILL.md

@@ -12,6 +12,33 @@ description: "Comet 阶段 2：深度设计。用 /comet-design 调用。通过
 
 ## 步骤
 
+### 0. 入口状态验证（Entry Check）
+
+在执行任何操作之前，读取并验证当前状态：
+
+**检查清单：**
+1. `openspec/changes/<name>/.comet.yaml` 存在
+2. `phase` 字段的值为 `"design"`
+3. `workflow` 字段的值为 `"full"`
+4. `design_doc` 字段为 `null` 或空
+5. `openspec/changes/<name>/proposal.md` 存在且非空
+6. `openspec/changes/<name>/design.md` 存在且非空
+7. `openspec/changes/<name>/tasks.md` 存在且非空
+
+**验证方式：**
+- `cat openspec/changes/<name>/.comet.yaml` 读取全部字段
+- 逐条比对检查清单
+
+**失败输出：**
+```
+[HARD STOP] Entry check failed for comet-design
+  Expected: phase=design, design_doc=<empty/null>, workflow=full
+  Actual:   phase=<实际值>, design_doc=<实际值>, workflow=<实际值>
+  Suggestion: Run comet-open first, or check if .comet.yaml was modified out of sequence.
+```
+
+验证通过后才进入步骤 1。
+
 ### 1a. 读取已有上下文
 
 读取活跃 change 下的 `proposal.md` 和 `design.md`，将核心内容整理为摘要：
@@ -39,14 +66,19 @@ Design 摘要: <design.md 架构决策>
 
 ### 2. 更新 Comet 状态
 
-在 `openspec/changes/<name>/.openspec.yaml` 中合并更新：
+在 `openspec/changes/<name>/.comet.yaml` 中合并更新以下字段（保留其他字段不变）：
 
 ```yaml
-comet:
-  phase: build
-  design_doc: docs/superpowers/specs/YYYY-MM-DD-topic-design.md
+phase: build
+design_doc: docs/superpowers/specs/YYYY-MM-DD-topic-design.md
 ```
 
+【写入验证】更新完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 phase 行的值为 "build"
+  确认 design_doc 行的值为 "docs/superpowers/specs/YYYY-MM-DD-topic-design.md"
+  如任一字段不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ### 3. 双 Spec 分工
 
 | Spec 类型 | 归属 | 存放位置 | 定义 |
@@ -67,6 +99,7 @@ design.md（阶段 1，OpenSpec）      → 高层架构决策
 
 - Design Doc 已创建并保存
 - 如有新能力则 delta spec 已创建
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> design`，全部 PASS 后才允许流转
 
 ## 自动流转
 

package/assets/skills/comet-hotfix/SKILL.md

@@ -20,6 +20,28 @@ Hotfix 是 Comet 五阶段能力的预设工作流，不是独立的平行流程
 
 ## 流程（preset workflow，4 阶段）
 
+### 0. 入口状态验证（Entry Check）
+
+在执行任何操作之前，验证当前状态：
+
+**检查清单：**
+1. `openspec/changes/<name>/` 目录不存在，或目录存在但 `.comet.yaml` 不存在（无冲突）
+
+**验证方式：**
+- `test -d openspec/changes/<name>` 检查目录
+- 如目录存在，`test -f openspec/changes/<name>/.comet.yaml` 检查配置文件
+- 如 `.comet.yaml` 已存在，读取 `phase` 检查是否为未完成的 hotfix
+
+**失败输出（有冲突）：**
+```
+[HARD STOP] Entry check failed for comet-hotfix
+  Expected: openspec/changes/<name>/.comet.yaml does not exist (new change)
+  Actual:   .comet.yaml exists with phase=<实际值>
+  Suggestion: Pick a different change name, or check if an existing hotfix is in progress.
+```
+
+验证通过后才进入流程步骤。
+
 执行链路：open → build → verify → archive。Hotfix 为每个阶段提供默认决策：精简开启、直接构建、按规模验证、验证通过后归档。
 
 ### 1. 快速开启（preset open）
@@ -34,21 +56,33 @@ Hotfix 是 Comet 五阶段能力的预设工作流，不是独立的平行流程
   - `tasks.md` — 修复任务清单
 - **无需 delta spec**（除非修复改变了已有 spec 的验收场景）
 
-在 `openspec/changes/<name>/.openspec.yaml` 中写入或合并 hotfix 状态：
+在 `openspec/changes/<name>/` 下创建独立的 `.comet.yaml` 文件：
 
 ```yaml
-comet:
-  workflow: hotfix
-  phase: build
-  design_doc: null
-  plan: null
-  build_mode: direct
-  verify_mode: light
-  verify_result: pending
-  verified_at: null
-  archived: false
+workflow: hotfix
+phase: build
+design_doc: null
+plan: null
+build_mode: direct
+verify_mode: light
+verify_result: pending
+verified_at: null
+archived: false
 ```
 
+【写入验证】创建完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 workflow 行的值为 "hotfix"
+  确认 phase 行的值为 "build"
+  确认 design_doc 行的值为 "null"
+  确认 plan 行的值为 "null"
+  确认 build_mode 行的值为 "direct"
+  确认 verify_mode 行的值为 "light"
+  确认 verify_result 行的值为 "pending"
+  确认 verified_at 行的值为 "null"
+  确认 archived 行的值为 "false"
+  如任一字段不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ### 2. 直接构建（preset build）
 
 使用 hotfix 默认值：`build_mode: direct`。跳过 `superpowers:brainstorming` 和 `superpowers:writing-plans`（除非任务 > 3 个；若超过 3 个任务，转入 `/comet-build` 的计划与执行方式选择）。
@@ -87,11 +121,11 @@ comet:
 - 回归测试揭示深层架构问题 → 停止 hotfix，升级为 `/comet`
 - 修复需要额外接口变更 → 停止 hotfix，升级为 `/comet`
 
-验证通过后，按 `/comet-verify` 的规则将 `comet.verify_result` 记录为 `pass`，归档前不得跳过该状态。
+验证通过后，按 `/comet-verify` 的规则将 `.comet.yaml` 的 `verify_result` 记录为 `pass`，归档前不得跳过该状态。
 
 ### 4. 归档（preset archive）
 
-复用 `/comet-archive`。归档前必须满足 `comet.verify_result: pass`。
+复用 `/comet-archive`。归档前必须满足 `.comet.yaml` 中 `verify_result: pass`。
 
 **立即执行：** 使用 Skill 工具加载 `comet-archive` 技能进行归档。禁止跳过此步骤。
 如有 delta spec，按 comet-archive 规则同步到 main spec，并处理关联 Design Doc 与 Plan 的归档标注。
@@ -128,3 +162,4 @@ Hotfix 流程为 **一次性连续执行**。调用 `/comet-hotfix` 后，agent
 - Bug 已修复，测试通过
 - change 已归档
 - 如有 spec 变更，已同步到 main spec
+- **阶段守卫**：build → verify 前运行 `bash $COMET_GUARD <change-name> build`，verify → archive 前运行 `bash $COMET_GUARD <change-name> verify`

package/assets/skills/comet-open/SKILL.md

@@ -11,6 +11,31 @@ description: "Comet 阶段 1：开启。用 /comet-open 调用。通过 OpenSpec
 
 ## 步骤
 
+### 0. 入口状态验证（Entry Check）
+
+在执行任何操作之前，读取并验证当前状态：
+
+**检查清单：**
+1. `openspec/changes/<name>/` 目录已存在（由 openspec-new-change 创建）
+2. `openspec/changes/<name>/.comet.yaml` 文件不存在（尚未初始化）
+3. `openspec/changes/<name>/proposal.md` 存在且非空
+4. `openspec/changes/<name>/design.md` 存在且非空
+5. `openspec/changes/<name>/tasks.md` 存在且非空
+
+**验证方式：**
+- 读取以上路径确认存在/不存在
+- 如 `.comet.yaml` 已存在，读取其 `phase` 字段：如 phase 不为空，输出 `[HARD STOP]` 并提示可能已有活跃 change
+
+**失败输出：**
+```
+[HARD STOP] Entry check failed for comet-open
+  Expected: .comet.yaml does not exist, proposal.md + design.md + tasks.md exist
+  Actual:   phase=<实际值>, design_doc=<实际值> (或文件不存在)
+  Suggestion: Check if another change with the same name is already active.
+```
+
+验证通过后才进入步骤 1。
+
 ### 1. 探索想法
 
 **立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能。禁止跳过此步骤。
@@ -19,13 +44,14 @@ description: "Comet 阶段 1：开启。用 /comet-open 调用。通过 OpenSpec
 
 ### 2. 创建 Change 结构
 
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能（或 `openspec-propose` 如需先提建议）。
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。若用户意图未明确、需要先形成建议，改为加载 `openspec-propose`。禁止跳过此步骤。
 
 确认以下产物已创建：
 
 ```
 openspec/changes/<name>/
 ├── .openspec.yaml
+├── .comet.yaml
 ├── proposal.md       # Why + What：问题、目标、范围
 ├── design.md         # How（高层）：架构决策、方案选型
 └── tasks.md          # 任务清单（勾选框）
@@ -47,27 +73,37 @@ cp openspec/specs/<capability>/spec.md openspec/changes/<name>/specs/<capability
 ```
 
 3. 在复制的 delta spec 中，按 delta 格式组织变更（`## ADDED`、`## MODIFIED`、`## REMOVED`）
-4. 在 proposal.md 中注明 `基于已有 capability: <capability-name>` 
-
-**好处**：避免从零编写 delta spec，确保增量修改有完整上下文。
+4. 在 proposal.md 中注明 `基于已有 capability: <capability-name>`
 
 ### 3. 初始化 Comet 状态
 
-在 `openspec/changes/<name>/.openspec.yaml` 中写入或合并以下元数据：
+在 `openspec/changes/<name>/` 下创建独立的 `.comet.yaml` 文件：
 
 ```yaml
-comet:
-  workflow: full
-  phase: design
-  design_doc: null
-  plan: null
-  build_mode: null
-  verify_mode: null
-  verify_result: pending
-  verified_at: null
-  archived: false
+workflow: full
+phase: design
+design_doc: null
+plan: null
+build_mode: null
+verify_mode: null
+verify_result: pending
+verified_at: null
+archived: false
 ```
 
+【写入验证】创建完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 workflow 行的值为 "full"
+  确认 phase 行的值为 "design"
+  确认 design_doc 行的值为 "null"
+  确认 plan 行的值为 "null"
+  确认 build_mode 行的值为 "null"
+  确认 verify_mode 行的值为 "null"
+  确认 verify_result 行的值为 "pending"
+  确认 verified_at 行的值为 "null"
+  确认 archived 行的值为 "false"
+  如任一字段不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ### 4. 内容完整性检查
 
 确认三个文档内容完整：
@@ -78,6 +114,7 @@ comet:
 ## 退出条件
 
 - proposal.md、design.md、tasks.md 均已创建且内容完整
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> open`，全部 PASS 后才允许流转
 
 ## 自动流转
 

package/assets/skills/comet-tweak/SKILL.md

@@ -1,117 +1,152 @@
----
-name: comet-tweak
-description: "Comet 预设路径：非 bug 的小改动（tweak）。跳过 brainstorming 和完整 plan，直接 open → lightweight build → light verify → archive。适用于文案、配置、文档或 prompt 的局部优化。"
----
-
-# Comet 预设路径：Tweak
-
-Tweak 是 Comet 五阶段能力的预设工作流，不是独立的平行流程。它复用 open、build、verify、archive 能力，仅跳过 brainstorming 和完整 plan。
-
-适用于非 bug 的小范围变更，例如文案调整、配置调整、文档或 prompt 的局部优化。
-
-**适用条件**（必须全部满足）：
-1. 不新增 capability
-2. 不改变架构
-3. 不涉及接口变化
-4. 通常不超过 3 个 tasks、5 个文件
-
-**不适用**：如变更过程中发现需要 capability、架构或接口调整，应升级为完整 `/comet` 流程。
-
----
-
-## 流程（preset workflow，4 阶段）
-
-执行链路：open → lightweight build → light verify → archive。Tweak 为每个阶段提供默认决策：精简开启、轻量构建、轻量验证、验证通过后归档。
-
-### 1. 快速开启（preset open）
-
-复用 Comet open 能力创建 change，但使用 tweak 默认值：不执行 `openspec-explore` 长探索，直接进入精简 change 创建。
-
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引创建精简版产物：
-  - `proposal.md` — 变更动机 + 目标 + 范围
-  - `design.md` — 简短实现说明（无需方案对比）
-  - `tasks.md` — 不超过 3 个任务
-- **无需 delta spec**（除非变更改变了已有 spec 的验收场景；一旦需要 delta spec，升级为完整 `/comet`）
-
-在 `openspec/changes/<name>/.openspec.yaml` 中写入或合并 tweak 状态：
-
-```yaml
-comet:
-  workflow: tweak
-  phase: build
-  design_doc: null
-  plan: null
-  build_mode: direct
-  verify_mode: light
-  verify_result: pending
-  verified_at: null
-  archived: false
-```
-
-### 2. 轻量构建（preset build）
-
-使用 tweak 默认值：`build_mode: direct`。跳过 `superpowers:brainstorming` 和 `superpowers:writing-plans`。
-
-**立即执行：** 按 tasks.md 逐个执行任务：
-
-1. 读取 `openspec/changes/<name>/tasks.md`，获取未完成任务列表
-2. 对每个未完成任务：
-   - 根据任务描述修改目标文件
-   - 运行 `mvn spotless:apply` 格式化
-   - 运行相关测试确认通过
-   - 将 tasks.md 中对应 `- [ ]` 勾选为 `- [x]`
-   - 提交代码，commit message 格式：`tweak: <简述变更>`
-3. 全部任务完成后进入验证
-
-### 3. 轻量验证（preset verify）
-
-复用 `/comet-verify`。Tweak 必须保持轻量验证条件：≤ 3 tasks、≤ 5 files、无 delta spec、无新 capability。
-
-**立即执行：** 使用 Skill 工具加载 `comet-verify` 技能。禁止跳过此步骤。
-
-如规模评估进入完整验证路径，停止 tweak，升级为完整 `/comet`。
-
-验证通过后，按 `/comet-verify` 的规则将 `comet.verify_result` 记录为 `pass`，归档前不得跳过该状态。
-
-### 4. 归档（preset archive）
-
-复用 `/comet-archive`。归档前必须满足 `comet.verify_result: pass`。
-
-**立即执行：** 使用 Skill 工具加载 `comet-archive` 技能进行归档。禁止跳过此步骤。
-
----
-
-## 连续执行模式
-
-<IMPORTANT>
-Tweak 流程为 **一次性连续执行**。调用 `/comet-tweak` 后，agent 必须自动走完全部 4 个阶段，中间不停顿等待用户输入（除非遇到升级条件需要用户确认）。
-
-执行顺序：快速开启 → 轻量构建 → 轻量验证 → 归档 → 完成
-
-每个阶段完成后立即进入下一阶段，无需用户再次输入。阶段内部仍必须按上文要求调用对应 Comet/OpenSpec/Superpowers skill。
-</IMPORTANT>
-
----
-
-## 升级条件
-
-执行过程中出现以下情况时，停止 tweak 流程，升级为完整 `/comet`：
-
-1. 需要新增 capability
-2. 需要架构调整
-3. 需要接口变化
-4. 影响范围扩大到 > 5 个文件
-5. 任务数超过 3 个
-6. 需要 delta spec
-
-升级方式：在当前 change 基础上补充 Design Doc（执行 `/comet-design`），后续正常走完整流程。
-
----
-
-## 退出条件
-
-- 小改动已完成，测试通过
-- change 已归档
-- 未新增 capability、架构调整或接口变化
+---
+name: comet-tweak
+description: "Comet 预设路径：非 bug 的小改动（tweak）。跳过 brainstorming 和完整 plan，直接 open → lightweight build → light verify → archive。适用于文案、配置、文档或 prompt 的局部优化。"
+---
+
+# Comet 预设路径：Tweak
+
+Tweak 是 Comet 五阶段能力的预设工作流，不是独立的平行流程。它复用 open、build、verify、archive 能力，仅跳过 brainstorming 和完整 plan。
+
+适用于非 bug 的小范围变更，例如文案调整、配置调整、文档或 prompt 的局部优化。
+
+**适用条件**（必须全部满足）：
+1. 不新增 capability
+2. 不改变架构
+3. 不涉及接口变化
+4. 通常不超过 3 个 tasks、5 个文件
+
+**不适用**：如变更过程中发现需要 capability、架构或接口调整，应升级为完整 `/comet` 流程。
+
+---
+
+## 流程（preset workflow，4 阶段）
+
+### 0. 入口状态验证（Entry Check）
+
+在执行任何操作之前，验证当前状态：
+
+**检查清单：**
+1. `openspec/changes/<name>/` 目录不存在，或目录存在但 `.comet.yaml` 不存在（无冲突）
+
+**验证方式：**
+- `test -d openspec/changes/<name>` 检查目录
+- 如目录存在，`test -f openspec/changes/<name>/.comet.yaml` 检查配置文件
+- 如 `.comet.yaml` 已存在，读取 `phase` 检查是否为未完成的 tweak
+
+**失败输出（有冲突）：**
+```
+[HARD STOP] Entry check failed for comet-tweak
+  Expected: openspec/changes/<name>/.comet.yaml does not exist (new change)
+  Actual:   .comet.yaml exists with phase=<实际值>
+  Suggestion: Pick a different change name, or check if an existing tweak is in progress.
+```
+
+验证通过后才进入流程步骤。
+
+执行链路：open → lightweight build → light verify → archive。Tweak 为每个阶段提供默认决策：精简开启、轻量构建、轻量验证、验证通过后归档。
+
+### 1. 快速开启（preset open）
+
+复用 Comet open 能力创建 change，但使用 tweak 默认值：不执行 `openspec-explore` 长探索，直接进入精简 change 创建。
+
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。禁止跳过此步骤。
+
+技能加载后，按其指引创建精简版产物：
+  - `proposal.md` — 变更动机 + 目标 + 范围
+  - `design.md` — 简短实现说明（无需方案对比）
+  - `tasks.md` — 不超过 3 个任务
+- **无需 delta spec**（除非变更改变了已有 spec 的验收场景；一旦需要 delta spec，升级为完整 `/comet`）
+
+在 `openspec/changes/<name>/` 下创建独立的 `.comet.yaml` 文件：
+
+```yaml
+workflow: tweak
+phase: build
+design_doc: null
+plan: null
+build_mode: direct
+verify_mode: light
+verify_result: pending
+verified_at: null
+archived: false
+```
+
+【写入验证】创建完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 workflow 行的值为 "tweak"
+  确认 phase 行的值为 "build"
+  确认 design_doc 行的值为 "null"
+  确认 plan 行的值为 "null"
+  确认 build_mode 行的值为 "direct"
+  确认 verify_mode 行的值为 "light"
+  确认 verify_result 行的值为 "pending"
+  确认 verified_at 行的值为 "null"
+  确认 archived 行的值为 "false"
+  如任一字段不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
+### 2. 轻量构建（preset build）
+
+使用 tweak 默认值：`build_mode: direct`。跳过 `superpowers:brainstorming` 和 `superpowers:writing-plans`。
+
+**立即执行：** 按 tasks.md 逐个执行任务：
+
+1. 读取 `openspec/changes/<name>/tasks.md`，获取未完成任务列表
+2. 对每个未完成任务：
+   - 根据任务描述修改目标文件
+   - 运行 `mvn spotless:apply` 格式化
+   - 运行相关测试确认通过
+   - 将 tasks.md 中对应 `- [ ]` 勾选为 `- [x]`
+   - 提交代码，commit message 格式：`tweak: <简述变更>`
+3. 全部任务完成后进入验证
+
+### 3. 轻量验证（preset verify）
+
+复用 `/comet-verify`。Tweak 必须保持轻量验证条件：≤ 3 tasks、≤ 5 files、无 delta spec、无新 capability。
+
+**立即执行：** 使用 Skill 工具加载 `comet-verify` 技能。禁止跳过此步骤。
+
+如规模评估进入完整验证路径，停止 tweak，升级为完整 `/comet`。
+
+验证通过后，按 `/comet-verify` 的规则将 `.comet.yaml` 的 `verify_result` 记录为 `pass`，归档前不得跳过该状态。
+
+### 4. 归档（preset archive）
+
+复用 `/comet-archive`。归档前必须满足 `.comet.yaml` 中 `verify_result: pass`。
+
+**立即执行：** 使用 Skill 工具加载 `comet-archive` 技能进行归档。禁止跳过此步骤。
+
+---
+
+## 连续执行模式
+
+<IMPORTANT>
+Tweak 流程为 **一次性连续执行**。调用 `/comet-tweak` 后，agent 必须自动走完全部 4 个阶段，中间不停顿等待用户输入（除非遇到升级条件需要用户确认）。
+
+执行顺序：快速开启 → 轻量构建 → 轻量验证 → 归档 → 完成
+
+每个阶段完成后立即进入下一阶段，无需用户再次输入。阶段内部仍必须按上文要求调用对应 Comet/OpenSpec/Superpowers skill。
+</IMPORTANT>
+
+---
+
+## 升级条件
+
+执行过程中出现以下情况时，停止 tweak 流程，升级为完整 `/comet`：
+
+1. 需要新增 capability
+2. 需要架构调整
+3. 需要接口变化
+4. 影响范围扩大到 > 5 个文件
+5. 任务数超过 3 个
+6. 需要 delta spec
+
+升级方式：在当前 change 基础上补充 Design Doc（执行 `/comet-design`），后续正常走完整流程。
+
+---
+
+## 退出条件
+
+- 小改动已完成，测试通过
+- change 已归档
+- 未新增 capability、架构调整或接口变化
+- **阶段守卫**：build → verify 前运行 `bash $COMET_GUARD <change-name> build`，verify → archive 前运行 `bash $COMET_GUARD <change-name> verify`