@rpamis/comet 0.2.0 → 0.2.2

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

@@ -1,114 +1,114 @@
----
-name: comet-verify
-description: "Comet Phase 4: Verify and Complete. Invoke with /comet-verify. Verify implementation matches design, handle development branch."
----
-
-# Comet Phase 4: Verify and Complete (Verify)
-
-## Prerequisites
-
-- Code has been committed (Phase 3 complete)
-- All tasks in tasks.md are complete
-
-## Steps
-
-### 0. Entry State Verification (Entry Check)
-
-Execute entry verification:
-
-```bash
-COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
-bash "$COMET_STATE" check <name> verify
-```
-
-Proceed to Step 1 after verification passes. The script outputs specific failure reasons when verification fails.
-
-### 1. Change Scale Assessment
-
-Execute scale assessment:
-
-```bash
-bash "$COMET_STATE" scale <name>
-```
-
-Script automatically counts tasks, delta specs, and changed files to determine whether to use light or full verification mode, and sets the verify_mode field.
-
-### 2a. Lightweight Verification (Small Changes)
-
-When scale assessment result is "small", skip `openspec-verify-change`, directly execute the following checks:
-
-1. All tasks in tasks.md completed `[x]`
-2. Changed files consistent with tasks.md description (`git diff --stat`对照 tasks content)
-3. Build passes (run project-appropriate build command, e.g., `npm run build`, `mvn compile`, `cargo build`)
-4. Related tests pass
-5. No obvious security issues (no hardcoded secrets, no new unsafe operations)
-
-**Pass standard**: All 5 items OK, no CRITICAL issues.
-
-**Report format**: Brief table listing 5 check results + PASS/FAIL.
-
-**Skipped items** (not checked in lightweight verification):
-- spec scenario coverage
-- design doc consistency deep comparison
-- code pattern consistency recommendations
-- delta spec and design doc drift detection
-
-### 2b. Full Verification (Large Changes)
-
-When scale assessment result is "large":
-
-**Immediately execute:** Use the Skill tool to load the `openspec-verify-change` skill. Skipping this step is prohibited.
-
-After the skill loads, follow its guidance to verify. Check items:
-1. All tasks in tasks.md completed (`[x]`)
-2. Implementation matches design.md design decisions
-3. Implementation matches brainstorming design document
-4. All capability specification scenarios pass
-5. proposal.md goals satisfied
-6. No contradiction between delta spec and design doc (if Build phase had incremental spec modifications, check if design doc has corresponding records)
-7. `docs/superpowers/specs/` associated design document can be located (file exists and relates to current change)
-
-When verification fails: report missing items, return to Phase 3 to supplement (invoke `/comet-build`).
-
-**Spec drift handling**:
-- If check item 6 finds contradiction (delta spec has content but design doc doesn't reflect it), prompt user:
-  - Option A: Append "Implementation Divergence" section to design doc recording deviation reason
-  - Option B: Roll back to Build phase, supplement brainstorming to update design doc
-  - Option C: Confirm deviation acceptable, continue verification (design doc will be marked as `superseded-by-main-spec` during archiving)
-
-### 3. Completion (Superpowers)
-
-**Immediately execute:** Use the Skill tool to load the `superpowers:finishing-a-development-branch` skill. Skipping this step is prohibited.
-
-If `superpowers:finishing-a-development-branch` is unavailable, stop the process and prompt to install or enable Superpowers skills. Do not substitute this step with normal conversation.
-
-After the skill loads, follow its guidance to complete. Branch handling options:
-1. Local merge to main branch
-2. Push and create PR
-3. Keep branch (handle later)
-4. Discard work
-
-**Confirmation items**:
-- All tests pass
-- No hardcoded secrets or security issues
-
-## Exit Conditions
-
-- Verification report passed
-- Branch handled
-- `.comet.yaml` `verify_result` recorded as `pass`
-- **Phase guard**: Run `bash $COMET_GUARD <change-name> verify`, allow transition only after all PASS
-
-Before exit, run guard to auto-transition:
-
-```bash
-bash $COMET_GUARD <change-name> verify --apply
-```
-
-State file is automatically updated to `phase: archive`, `verify_result: pass`, `verified_at: YYYY-MM-DD`.
-
-## Automatic Transition
-
-After exit conditions are met, **proceed immediately to the next phase without waiting for user input**:
-
-> **REQUIRED NEXT SKILL:** Invoke `comet-archive` skill to enter the archiving phase.
+---
+name: comet-verify
+description: "Comet Phase 4: Verify and Complete. Invoke with /comet-verify. Verify implementation matches design, handle development branch."
+---
+
+# Comet Phase 4: Verify and Complete (Verify)
+
+## Prerequisites
+
+- Code has been committed (Phase 3 complete)
+- All tasks in tasks.md are complete
+
+## Steps
+
+### 0. Entry State Verification (Entry Check)
+
+Execute entry verification:
+
+```bash
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
+bash "$COMET_STATE" check <name> verify
+```
+
+Proceed to Step 1 after verification passes. The script outputs specific failure reasons when verification fails.
+
+### 1. Change Scale Assessment
+
+Execute scale assessment:
+
+```bash
+bash "$COMET_STATE" scale <name>
+```
+
+Script automatically counts tasks, delta specs, and changed files to determine whether to use light or full verification mode, and sets the verify_mode field.
+
+### 2a. Lightweight Verification (Small Changes)
+
+When scale assessment result is "small", skip `openspec-verify-change`, directly execute the following checks:
+
+1. All tasks in tasks.md completed `[x]`
+2. Changed files consistent with tasks.md description (`git diff --stat`对照 tasks content)
+3. Build passes (run project-appropriate build command, e.g., `npm run build`, `mvn compile`, `cargo build`)
+4. Related tests pass
+5. No obvious security issues (no hardcoded secrets, no new unsafe operations)
+
+**Pass standard**: All 5 items OK, no CRITICAL issues.
+
+**Report format**: Brief table listing 5 check results + PASS/FAIL.
+
+**Skipped items** (not checked in lightweight verification):
+- spec scenario coverage
+- design doc consistency deep comparison
+- code pattern consistency recommendations
+- delta spec and design doc drift detection
+
+### 2b. Full Verification (Large Changes)
+
+When scale assessment result is "large":
+
+**Immediately execute:** Use the Skill tool to load the `openspec-verify-change` skill. Skipping this step is prohibited.
+
+After the skill loads, follow its guidance to verify. Check items:
+1. All tasks in tasks.md completed (`[x]`)
+2. Implementation matches design.md design decisions
+3. Implementation matches brainstorming design document
+4. All capability specification scenarios pass
+5. proposal.md goals satisfied
+6. No contradiction between delta spec and design doc (if Build phase had incremental spec modifications, check if design doc has corresponding records)
+7. `docs/superpowers/specs/` associated design document can be located (file exists and relates to current change)
+
+When verification fails: report missing items, return to Phase 3 to supplement (invoke `/comet-build`).
+
+**Spec drift handling**:
+- If check item 6 finds contradiction (delta spec has content but design doc doesn't reflect it), prompt user:
+  - Option A: Append "Implementation Divergence" section to design doc recording deviation reason
+  - Option B: Roll back to Build phase, supplement brainstorming to update design doc
+  - Option C: Confirm deviation acceptable, continue verification (design doc will be marked as `superseded-by-main-spec` during archiving)
+
+### 3. Completion (Superpowers)
+
+**Immediately execute:** Use the Skill tool to load the `superpowers:finishing-a-development-branch` skill. Skipping this step is prohibited.
+
+If `superpowers:finishing-a-development-branch` is unavailable, stop the process and prompt to install or enable Superpowers skills. Do not substitute this step with normal conversation.
+
+After the skill loads, follow its guidance to complete. Branch handling options:
+1. Local merge to main branch
+2. Push and create PR
+3. Keep branch (handle later)
+4. Discard work
+
+**Confirmation items**:
+- All tests pass
+- No hardcoded secrets or security issues
+
+## Exit Conditions
+
+- Verification report passed
+- Branch handled
+- `.comet.yaml` `verify_result` recorded as `pass`
+- **Phase guard**: Run `bash $COMET_GUARD <change-name> verify`, allow transition only after all PASS
+
+Before exit, run guard to auto-transition:
+
+```bash
+bash $COMET_GUARD <change-name> verify --apply
+```
+
+State file is automatically updated to `phase: archive`, `verify_result: pass`, `verified_at: YYYY-MM-DD`.
+
+## Automatic Transition
+
+After exit conditions are met, **proceed immediately to the next phase without waiting for user input**:
+
+> **REQUIRED NEXT SKILL:** Invoke `comet-archive` skill to enter the archiving phase.

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

@@ -1,63 +1,63 @@
----
-name: comet-archive
-description: "Comet 阶段 5：归档。用 /comet-archive 调用。同步 delta spec 到主 spec，归档 change。"
----
-
-# Comet 阶段 5：归档（Archive）
-
-## 前置条件
-
-- 验证已通过（阶段 4 完成）
-- 分支已处理
-- `openspec/changes/<name>/.comet.yaml` 中 `verify_result: pass`
-
-## 步骤
-
-### 0. 入口状态验证（Entry Check）
-
-执行入口验证：
-
-```bash
-COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
-bash "$COMET_STATE" check <name> archive
-```
-
-验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
-
-### 1. 执行归档
-
-运行归档脚本，自动完成以下全部步骤：
-
-```bash
-COMET_ARCHIVE="${COMET_ARCHIVE:-$(find . -path '*/comet/scripts/comet-archive.sh' -type f -print -quit)}"
-bash "$COMET_ARCHIVE" "<change-name>"
-```
-
-脚本自动执行：
-1. 入口状态验证（phase=archive, verify_result=pass, archived=false）
-2. Delta spec 同步到主 spec
-3. Design doc 前置元数据标注（archived-with, status）
-4. Plan 前置元数据标注（archived-with）
-5. 移动 change 到归档目录
-6. 更新 archived: true
-
-如脚本返回非零退出码，报告错误并停止。
-如脚本返回零退出码，归档完成。
-
-如需预览而不实际执行，使用 `--dry-run` 参数。
-
-### 2. 生命周期闭环
-
-Spec 生命周期在此完成：
-```
-brainstorming → delta spec → 实施 → 验证 → 主 spec 覆盖 → design doc 标注 → 归档
-```
-
-## 退出条件
-
-- 归档脚本执行成功（退出码 0）
-- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> archive`，全部 PASS 后确认归档完整
-
-## 完成
-
-Comet 流程全部完成。如需开始新工作，调用 `/comet` 或 `/comet-open`。
+---
+name: comet-archive
+description: "Comet 阶段 5：归档。用 /comet-archive 调用。同步 delta spec 到主 spec，归档 change。"
+---
+
+# Comet 阶段 5：归档（Archive）
+
+## 前置条件
+
+- 验证已通过（阶段 4 完成）
+- 分支已处理
+- `openspec/changes/<name>/.comet.yaml` 中 `verify_result: pass`
+
+## 步骤
+
+### 0. 入口状态验证（Entry Check）
+
+执行入口验证：
+
+```bash
+COMET_STATE="${COMET_STATE:-$(find . -path '*/comet/scripts/comet-state.sh' -type f -print -quit)}"
+bash "$COMET_STATE" check <name> archive
+```
+
+验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。
+
+### 1. 执行归档
+
+运行归档脚本，自动完成以下全部步骤：
+
+```bash
+COMET_ARCHIVE="${COMET_ARCHIVE:-$(find . -path '*/comet/scripts/comet-archive.sh' -type f -print -quit)}"
+bash "$COMET_ARCHIVE" "<change-name>"
+```
+
+脚本自动执行：
+1. 入口状态验证（phase=archive, verify_result=pass, archived=false）
+2. Delta spec 同步到主 spec
+3. Design doc 前置元数据标注（archived-with, status）
+4. Plan 前置元数据标注（archived-with）
+5. 移动 change 到归档目录
+6. 更新 archived: true
+
+如脚本返回非零退出码，报告错误并停止。
+如脚本返回零退出码，归档完成。
+
+如需预览而不实际执行，使用 `--dry-run` 参数。
+
+### 2. 生命周期闭环
+
+Spec 生命周期在此完成：
+```
+brainstorming → delta spec → 实施 → 验证 → 主 spec 覆盖 → design doc 标注 → 归档
+```
+
+## 退出条件
+
+- 归档脚本执行成功（退出码 0）
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> archive`，全部 PASS 后确认归档完整
+
+## 完成
+
+Comet 流程全部完成。如需开始新工作，调用 `/comet` 或 `/comet-open`。

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="${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 进入验证与收尾阶段。