@rpamis/comet 0.1.8 → 0.2.1

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

@@ -1,153 +1,153 @@
----
-name: comet-build
-description: "Comet 阶段 3：计划与构建。用 /comet-build 调用。制定计划并通过 subagent-driven-development 执行实施。"
----
-
-# Comet 阶段 3：计划与构建（Build）
-
-## 前置条件
-
-- Design Doc 已创建（阶段 2 完成）
-- 活跃 change 存在
-
-## 步骤
-
-### 0. 入口状态验证（Entry Check）
-
-执行入口验证：
-
-```bash
-COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
-bash "$COMET_STATE" check <name> build
-```
-
-验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
-
-### 1. 制定计划
-
-**立即执行：** 使用 Skill 工具加载 `superpowers:writing-plans` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引制定计划。计划要求：
-- 保存至 `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
-- 引用设计文档，拆分为可执行任务
-- **Plan 文件头必须包含关联元数据**：
-
-```yaml
----
-change: <openspec-change-name>
-design-doc: docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
----
-```
-
-### 2. 更新计划状态
-
-先记录 plan 路径：
-
-```bash
-bash "$COMET_STATE" set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
-```
-
-无需手动更新 phase，guard 会在退出条件满足后自动流转。
-
-### 3. 工作区隔离
-
-计划已写入当前分支。在开始执行前，选择工作区隔离方式：
-
-| 选项 | 方式 | 说明 |
-|------|------|------|
-| A | 创建分支 | 在当前仓库创建新分支，简单快速 |
-| B | 创建 Worktree | 隔离工作区，完全独立，适合并行开发 |
-
-**推荐规则**：
-- 变更涉及 ≤ 3 个文件 → 推荐 A
-- 需要并行开发、当前分支有未提交工作 → 推荐 B
-
-用户选择后，更新 `isolation` 字段。`isolation` 只允许以下值之一：
-
-```bash
-bash "$COMET_STATE" set <name> isolation <value>
-```
-
-- `branch`
-- `worktree`
-
-**执行隔离**：
-
-- **branch**：执行 `git checkout -b <change-name>`，后续工作在新分支上进行
-- **worktree**：调用 `superpowers:using-git-worktrees` 技能或使用原生 `EnterWorktree` 工具创建隔离工作区
-
-创建隔离后，确认计划文件可访问（分支方式天然可访问；worktree 方式需确认计划已提交）。
-
-### 4. 选择执行方式
-
-向用户展示计划摘要（任务数、涉及模块），然后询问执行方式：
-
-| 选项 | 技能 | 适用场景 |
-|------|------|---------|
-| A | `superpowers:subagent-driven-development` | 任务独立、复杂度高、需要双阶段审查 |
-| B | `superpowers:executing-plans` | 任务简单、无子agent环境、轻量快速 |
-
-**推荐规则**：
-- 任务数 ≥ 3 → 推荐 A
-- 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
-- 来自 hotfix 路径 → 推荐 B
-
-用户选择后，更新 `build_mode` 字段。`build_mode` 只允许以下值之一：
-
-```bash
-bash "$COMET_STATE" set <name> build_mode <value>
-```
-
-- `subagent-driven-development`
-- `executing-plans`
-- `direct`（仅 hotfix preset 使用）
-
-然后，**立即执行：** 使用 Skill 工具加载对应技能。禁止跳过此步骤。
-
-如所选 Superpowers 技能不可用，停止流程并提示安装或启用对应技能，不要用普通对话替代该步骤。
-
-技能加载后，按其指引执行：
-- 按计划执行任务
-- 完成 tasks.md 勾选（`- [ ]` → `- [x]`）
-- 每个任务完成后提交代码
-
-### 5. Spec 增量更新
-
-实施过程中发现初版 spec 不完整时，按变更规模分级处理：
-
-| 规模 | 触发条件 | 做法 |
-|------|---------|------|
-| 小 | 遗漏验收场景、边界条件 | 直接编辑 delta spec + design.md，追加 tasks.md 任务 |
-| 中 | 接口变更、新增组件、数据流变化 | 重新 `superpowers:brainstorming` 更新 Design Doc + delta spec |
-| 大 | 全新 capability 需求 | `/opsx:new` 创建独立 change |
-
-**50% 阈值判定**：以 tasks.md 初始任务总数为基准，若新增任务数超过该总数的一半，视为超出原计划范围，应考虑拆分为新 change。
-
-**原则**：
-- delta spec 是活文档，本阶段期间随时可修改
-- 每次更新应提交，commit message 说明变更原因
-- 不提前同步到 main spec，归档时统一同步
-- 如增量任务超过原 tasks.md 初始任务总数 50%，考虑拆分为新 change
-- 小规模增量直接改 delta spec 时，应在 commit message 中注明，便于归档时判断 design doc 漂移
-
-## 退出条件
-
-- tasks.md 全部勾选
-- 代码已提交
-- 测试通过
-- `.comet.yaml` 中 `phase` 已更新为 `verify`
-- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> build`，全部 PASS 后才允许流转
-
-退出前运行 guard 自动流转：
-
-```bash
-bash $COMET_GUARD <change-name> build --apply
-```
-
-状态文件自动更新为 `phase: verify`、`verify_result: pending`。
-
-## 自动流转
-
-退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
-
-> **REQUIRED NEXT SKILL:** 调用 `comet-verify` skill 进入验证与收尾阶段。
+---
+name: comet-build
+description: "Comet 阶段 3：计划与构建。用 /comet-build 调用。制定计划并通过 subagent-driven-development 执行实施。"
+---
+
+# Comet 阶段 3：计划与构建（Build）
+
+## 前置条件
+
+- Design Doc 已创建（阶段 2 完成）
+- 活跃 change 存在
+
+## 步骤
+
+### 0. 入口状态验证（Entry Check）
+
+执行入口验证：
+
+```bash
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
+bash "$COMET_STATE" check <name> build
+```
+
+验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
+
+### 1. 制定计划
+
+**立即执行：** 使用 Skill 工具加载 `superpowers:writing-plans` 技能。禁止跳过此步骤。
+
+技能加载后，按其指引制定计划。计划要求：
+- 保存至 `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
+- 引用设计文档，拆分为可执行任务
+- **Plan 文件头必须包含关联元数据**：
+
+```yaml
+---
+change: <openspec-change-name>
+design-doc: docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md
+---
+```
+
+### 2. 更新计划状态
+
+先记录 plan 路径：
+
+```bash
+bash "$COMET_STATE" set <name> plan docs/superpowers/plans/YYYY-MM-DD-feature.md
+```
+
+无需手动更新 phase，guard 会在退出条件满足后自动流转。
+
+### 3. 工作区隔离
+
+计划已写入当前分支。在开始执行前，选择工作区隔离方式：
+
+| 选项 | 方式 | 说明 |
+|------|------|------|
+| A | 创建分支 | 在当前仓库创建新分支，简单快速 |
+| B | 创建 Worktree | 隔离工作区，完全独立，适合并行开发 |
+
+**推荐规则**：
+- 变更涉及 ≤ 3 个文件 → 推荐 A
+- 需要并行开发、当前分支有未提交工作 → 推荐 B
+
+用户选择后，更新 `isolation` 字段。`isolation` 只允许以下值之一：
+
+```bash
+bash "$COMET_STATE" set <name> isolation <value>
+```
+
+- `branch`
+- `worktree`
+
+**执行隔离**：
+
+- **branch**：执行 `git checkout -b <change-name>`，后续工作在新分支上进行
+- **worktree**：调用 `superpowers:using-git-worktrees` 技能或使用原生 `EnterWorktree` 工具创建隔离工作区
+
+创建隔离后，确认计划文件可访问（分支方式天然可访问；worktree 方式需确认计划已提交）。
+
+### 4. 选择执行方式
+
+向用户展示计划摘要（任务数、涉及模块），然后询问执行方式：
+
+| 选项 | 技能 | 适用场景 |
+|------|------|---------|
+| A | `superpowers:subagent-driven-development` | 任务独立、复杂度高、需要双阶段审查 |
+| B | `superpowers:executing-plans` | 任务简单、无子agent环境、轻量快速 |
+
+**推荐规则**：
+- 任务数 ≥ 3 → 推荐 A
+- 任务数 ≤ 2 且无跨模块依赖 → 推荐 B
+- 来自 hotfix 路径 → 推荐 B
+
+用户选择后，更新 `build_mode` 字段。`build_mode` 只允许以下值之一：
+
+```bash
+bash "$COMET_STATE" set <name> build_mode <value>
+```
+
+- `subagent-driven-development`
+- `executing-plans`
+- `direct`（仅 hotfix preset 使用）
+
+然后，**立即执行：** 使用 Skill 工具加载对应技能。禁止跳过此步骤。
+
+如所选 Superpowers 技能不可用，停止流程并提示安装或启用对应技能，不要用普通对话替代该步骤。
+
+技能加载后，按其指引执行：
+- 按计划执行任务
+- 完成 tasks.md 勾选（`- [ ]` → `- [x]`）
+- 每个任务完成后提交代码
+
+### 5. Spec 增量更新
+
+实施过程中发现初版 spec 不完整时，按变更规模分级处理：
+
+| 规模 | 触发条件 | 做法 |
+|------|---------|------|
+| 小 | 遗漏验收场景、边界条件 | 直接编辑 delta spec + design.md，追加 tasks.md 任务 |
+| 中 | 接口变更、新增组件、数据流变化 | 重新 `superpowers:brainstorming` 更新 Design Doc + delta spec |
+| 大 | 全新 capability 需求 | `/opsx:new` 创建独立 change |
+
+**50% 阈值判定**：以 tasks.md 初始任务总数为基准，若新增任务数超过该总数的一半，视为超出原计划范围，应考虑拆分为新 change。
+
+**原则**：
+- delta spec 是活文档，本阶段期间随时可修改
+- 每次更新应提交，commit message 说明变更原因
+- 不提前同步到 main spec，归档时统一同步
+- 如增量任务超过原 tasks.md 初始任务总数 50%，考虑拆分为新 change
+- 小规模增量直接改 delta spec 时，应在 commit message 中注明，便于归档时判断 design doc 漂移
+
+## 退出条件
+
+- tasks.md 全部勾选
+- 代码已提交
+- 测试通过
+- `.comet.yaml` 中 `phase` 已更新为 `verify`
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> build`，全部 PASS 后才允许流转
+
+退出前运行 guard 自动流转：
+
+```bash
+bash $COMET_GUARD <change-name> build --apply
+```
+
+状态文件自动更新为 `phase: verify`、`verify_result: pending`。
+
+## 自动流转
+
+退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
+
+> **REQUIRED NEXT SKILL:** 调用 `comet-verify` skill 进入验证与收尾阶段。

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

@@ -1,91 +1,91 @@
----
-name: comet-design
-description: "Comet 阶段 2：深度设计。用 /comet-design 调用。通过 brainstorming 产出 Design Doc 和 delta spec。"
----
-
-# Comet 阶段 2：深度设计（Design）
-
-## 前置条件
-
-- 活跃 change 已存在（proposal.md、design.md、tasks.md）
-- 无 Design Doc（`docs/superpowers/specs/` 下无对应文件）
-
-## 步骤
-
-### 0. 入口状态验证（Entry Check）
-
-执行入口验证：
-
-```bash
-COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
-bash "$COMET_STATE" check <name> design
-```
-
-验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
-
-### 1a. 读取已有上下文
-
-读取活跃 change 下的 `proposal.md` 和 `design.md`，将核心内容整理为摘要：
-- **proposal 摘要**：目标、动机、范围
-- **design 摘要**：架构决策、高层设计
-
-### 1b. 执行 Brainstorming（带上下文）
-
-**立即执行：** 使用 Skill 工具加载 `superpowers:brainstorming` 技能，ARGUMENTS 包含：
-
-```
-Change: <change-name>
-Proposal 摘要: <proposal 核心内容>
-Design 摘要: <design.md 架构决策>
-跳过上下文探索，直接进入设计提问。
-```
-
-禁止跳过此步骤，禁止在未加载该技能的情况下继续。
-
-如 `superpowers:brainstorming` 不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
-
-技能加载后，按其指引产出：
-- `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` — 设计文档（技术 RFC）
-- `openspec/changes/<name>/specs/<capability>/spec.md` — 能力规格（delta）
-
-### 2. 更新 Comet 状态
-
-先记录 design_doc 路径，再运行 guard 自动流转：
-
-```bash
-# 记录 design_doc 路径
-bash "$COMET_STATE" set <name> design_doc docs/superpowers/specs/YYYY-MM-DD-topic-design.md
-
-# 自动流转到下一阶段
-bash $COMET_GUARD <change-name> design --apply
-```
-
-状态文件自动更新，无需手动编辑其他字段。
-
-### 3. 双 Spec 分工
-
-| Spec 类型 | 归属 | 存放位置 | 定义 |
-|-----------|------|---------|------|
-| 能力规格 | OpenSpec | `openspec/changes/<name>/specs/` | 系统应该做什么（需求 + 验收场景） |
-| 设计文档 | Superpowers | `docs/superpowers/specs/` | 怎么构建（技术架构 + 实现细节） |
-
-### 4. 文档层级确认
-
-```
-proposal.md（阶段 1）              → Why + What
-design.md（阶段 1，OpenSpec）      → 高层架构决策
-设计文档（阶段 2，Superpowers）     → 深度技术设计
-能力规格（阶段 2，delta）           → 需求 + 验收场景
-```
-
-## 退出条件
-
-- Design Doc 已创建并保存
-- 如有新能力则 delta spec 已创建
-- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> design`，全部 PASS 后才允许流转
-
-## 自动流转
-
-退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
-
-> **REQUIRED NEXT SKILL:** 调用 `comet-build` skill 进入计划与构建阶段。
+---
+name: comet-design
+description: "Comet 阶段 2：深度设计。用 /comet-design 调用。通过 brainstorming 产出 Design Doc 和 delta spec。"
+---
+
+# Comet 阶段 2：深度设计（Design）
+
+## 前置条件
+
+- 活跃 change 已存在（proposal.md、design.md、tasks.md）
+- 无 Design Doc（`docs/superpowers/specs/` 下无对应文件）
+
+## 步骤
+
+### 0. 入口状态验证（Entry Check）
+
+执行入口验证：
+
+```bash
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
+bash "$COMET_STATE" check <name> design
+```
+
+验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
+
+### 1a. 读取已有上下文
+
+读取活跃 change 下的 `proposal.md` 和 `design.md`，将核心内容整理为摘要：
+- **proposal 摘要**：目标、动机、范围
+- **design 摘要**：架构决策、高层设计
+
+### 1b. 执行 Brainstorming（带上下文）
+
+**立即执行：** 使用 Skill 工具加载 `superpowers:brainstorming` 技能，ARGUMENTS 包含：
+
+```
+Change: <change-name>
+Proposal 摘要: <proposal 核心内容>
+Design 摘要: <design.md 架构决策>
+跳过上下文探索，直接进入设计提问。
+```
+
+禁止跳过此步骤，禁止在未加载该技能的情况下继续。
+
+如 `superpowers:brainstorming` 不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
+
+技能加载后，按其指引产出：
+- `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` — 设计文档（技术 RFC）
+- `openspec/changes/<name>/specs/<capability>/spec.md` — 能力规格（delta）
+
+### 2. 更新 Comet 状态
+
+先记录 design_doc 路径，再运行 guard 自动流转：
+
+```bash
+# 记录 design_doc 路径
+bash "$COMET_STATE" set <name> design_doc docs/superpowers/specs/YYYY-MM-DD-topic-design.md
+
+# 自动流转到下一阶段
+bash $COMET_GUARD <change-name> design --apply
+```
+
+状态文件自动更新，无需手动编辑其他字段。
+
+### 3. 双 Spec 分工
+
+| Spec 类型 | 归属 | 存放位置 | 定义 |
+|-----------|------|---------|------|
+| 能力规格 | OpenSpec | `openspec/changes/<name>/specs/` | 系统应该做什么（需求 + 验收场景） |
+| 设计文档 | Superpowers | `docs/superpowers/specs/` | 怎么构建（技术架构 + 实现细节） |
+
+### 4. 文档层级确认
+
+```
+proposal.md（阶段 1）              → Why + What
+design.md（阶段 1，OpenSpec）      → 高层架构决策
+设计文档（阶段 2，Superpowers）     → 深度技术设计
+能力规格（阶段 2，delta）           → 需求 + 验收场景
+```
+
+## 退出条件
+
+- Design Doc 已创建并保存
+- 如有新能力则 delta spec 已创建
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> design`，全部 PASS 后才允许流转
+
+## 自动流转
+
+退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
+
+> **REQUIRED NEXT SKILL:** 调用 `comet-build` skill 进入计划与构建阶段。

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

@@ -25,7 +25,7 @@ Hotfix 是 Comet 五阶段能力的预设工作流，不是独立的平行流程
 执行入口验证：
 
 ```bash
-COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
 bash "$COMET_STATE" check <name> open
 ```
 
@@ -60,7 +60,7 @@ bash "$COMET_STATE" init <name> hotfix
 1. 读取 `openspec/changes/<name>/tasks.md`，获取未完成任务列表
 2. 对每个未完成任务：
    - 根据任务描述修改代码
-   - 运行 `mvn spotless:apply` 格式化
+   - 运行项目格式化命令（如 `mvn spotless:apply`、`npm run format` 等）
    - 运行相关测试确认通过
    - 将 tasks.md 中对应 `- [ ]` 勾选为 `- [x]`
    - 提交代码，commit message 格式：`fix: <简述修复>`
@@ -114,12 +114,15 @@ Hotfix 流程为 **一次性连续执行**。调用 `/comet-hotfix` 后，agent
 
 ## 升级条件
 
-修复过程中出现以下情况时，停止 hotfix 流程，升级为完整 `/comet`：
+满足以下**任一**条件时，停止 hotfix 流程，升级为完整 `/comet`：
 
-1. 发现根因涉及架构缺陷
-2. 修复需要新增接口或组件
-3. 影响范围扩大到 > 10 个文件
-4. 需要新 capability 的 spec
+| 条件 | 说明 |
+|------|------|
+| 改动涉及 **3+ 文件** | 超出单点修复范围 |
+| 架构变更 | 新模块、新接口、新依赖 |
+| 数据库 schema 变更 | 结构性调整 |
+| 引入新的 public API | 修复产生了新的对外接口 |
+| 修复范围超出单一函数/模块 | 需要多处协调修改 |
 
 升级方式：在当前 change 基础上补充 Design Doc（执行 `/comet-design`），后续正常走完整流程。
 

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

@@ -1,70 +1,70 @@
----
-name: comet-open
-description: "Comet 阶段 1：开启。用 /comet-open 调用。通过 OpenSpec 探索想法、创建 change 结构（proposal + design + tasks）。"
----
-
-# Comet 阶段 1：开启（Open）
-
-## 前置条件
-
-- 无活跃 change，或用户希望创建新 change
-
-## 步骤
-
-### 0. 入口状态验证（Entry Check）
-
-执行入口验证：
-
-```bash
-COMET_STATE=$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)
-bash "$COMET_STATE" check <name> open
-```
-
-验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
-
-### 1. 探索想法
-
-**立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引自由探索问题空间。
-
-### 2. 创建 Change 结构
-
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。若用户意图未明确、需要先形成建议，改为加载 `openspec-propose`。禁止跳过此步骤。
-
-确认以下产物已创建：
-
-```
-openspec/changes/<name>/
-├── .openspec.yaml
-├── .comet.yaml
-├── proposal.md       # Why + What：问题、目标、范围
-├── design.md         # How（高层）：架构决策、方案选型
-└── tasks.md          # 任务清单（勾选框）
-```
-
-### 3. 初始化 Comet 状态
-
-初始化 Comet 状态文件：
-
-```bash
-bash "$COMET_STATE" init <name> full
-```
-
-### 4. 内容完整性检查
-
-确认三个文档内容完整：
-- **proposal.md**：问题背景、目标、范围、非目标
-- **design.md**：高层架构决策、方案选型、数据流
-- **tasks.md**：任务列表，每个任务有明确描述
-
-## 退出条件
-
-- proposal.md、design.md、tasks.md 均已创建且内容完整
-- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> open`，全部 PASS 后才允许流转
-
-## 自动流转
-
-退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
-
-> **REQUIRED NEXT SKILL:** 调用 `comet-design` skill 进入深度设计阶段。
+---
+name: comet-open
+description: "Comet 阶段 1：开启。用 /comet-open 调用。通过 OpenSpec 探索想法、创建 change 结构（proposal + design + tasks）。"
+---
+
+# Comet 阶段 1：开启（Open）
+
+## 前置条件
+
+- 无活跃 change，或用户希望创建新 change
+
+## 步骤
+
+### 0. 入口状态验证（Entry Check）
+
+执行入口验证：
+
+```bash
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
+bash "$COMET_STATE" check <name> open
+```
+
+验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
+
+### 1. 探索想法
+
+**立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能。禁止跳过此步骤。
+
+技能加载后，按其指引自由探索问题空间。
+
+### 2. 创建 Change 结构
+
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。若用户意图未明确、需要先形成建议，改为加载 `openspec-propose`。禁止跳过此步骤。
+
+确认以下产物已创建：
+
+```
+openspec/changes/<name>/
+├── .openspec.yaml
+├── .comet.yaml
+├── proposal.md       # Why + What：问题、目标、范围
+├── design.md         # How（高层）：架构决策、方案选型
+└── tasks.md          # 任务清单（勾选框）
+```
+
+### 3. 初始化 Comet 状态
+
+初始化 Comet 状态文件：
+
+```bash
+bash "$COMET_STATE" init <name> full
+```
+
+### 4. 内容完整性检查
+
+确认三个文档内容完整：
+- **proposal.md**：问题背景、目标、范围、非目标
+- **design.md**：高层架构决策、方案选型、数据流
+- **tasks.md**：任务列表，每个任务有明确描述
+
+## 退出条件
+
+- proposal.md、design.md、tasks.md 均已创建且内容完整
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> open`，全部 PASS 后才允许流转
+
+## 自动流转
+
+退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：
+
+> **REQUIRED NEXT SKILL:** 调用 `comet-design` skill 进入深度设计阶段。