@rpamis/comet 0.1.1 → 0.1.3

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

@@ -12,6 +12,29 @@ description: "Comet 阶段 4：验证与收尾。用 /comet-verify 调用。验
 
 ## 步骤
 
+### 0. 入口状态验证（Entry Check）
+
+在执行任何操作之前，读取并验证当前状态：
+
+**检查清单：**
+1. `openspec/changes/<name>/.comet.yaml` 存在
+2. `phase` 字段的值为 `"verify"`
+3. `verify_result` 字段为 `"pending"` 或 null（尚未验证通过）
+
+**验证方式：**
+- `cat openspec/changes/<name>/.comet.yaml` 读取全部字段
+- 如 `verify_result` 已是 `"pass"`，说明此 change 已验证过
+
+**失败输出：**
+```
+[HARD STOP] Entry check failed for comet-verify
+  Expected: phase=verify, verify_result=pending|null
+  Actual:   phase=<实际值>, verify_result=<实际值>
+  Suggestion: Run comet-build first, or this change was already verified.
+```
+
+验证通过后才进入步骤 1。
+
 ### 1. 改动规模评估
 
 根据以下指标判定改动规模：
@@ -25,7 +48,7 @@ description: "Comet 阶段 4：验证与收尾。用 /comet-verify 调用。验
 
 **判定规则**：任一指标命中"大" → 完整验证。全部命中"小" → 轻量验证。
 
-判定完成后，在 `openspec/changes/<name>/.openspec.yaml` 中记录实际验证模式。`verify_mode` 只允许以下值之一：
+判定完成后，在 `openspec/changes/<name>/.comet.yaml` 中记录实际验证模式。`verify_mode` 只允许以下值之一：
 
 - `light`
 - `full`
@@ -34,20 +57,23 @@ Few-shot 示例：
 
 ```yaml
 # 全部指标命中“小”
-comet:
-  phase: verify
-  verify_mode: light
-  verify_result: pending
+phase: verify
+verify_mode: light
+verify_result: pending
 ```
 
 ```yaml
-# 任一指标命中“大”
-comet:
-  phase: verify
-  verify_mode: full
-  verify_result: pending
+# 任一指标命中”大”
+phase: verify
+verify_mode: full
+verify_result: pending
 ```
 
+【写入验证】更新完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 verify_mode 行的值为 “<light 或 full>”
+  如不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ### 2a. 轻量验证（小改动）
 
 当规模评估结果为"小"时，跳过 `openspec-verify-change`，直接执行以下检查：
@@ -113,17 +139,24 @@ comet:
 
 - 验证报告通过
 - 分支已处理
-- `.openspec.yaml` 中 `comet.verify_result` 已记录为 `pass`
+- `.comet.yaml` 中 `verify_result` 已记录为 `pass`
+- **阶段守卫**：运行 `bash $COMET_GUARD <change-name> verify`，全部 PASS 后才允许流转
 
-退出前合并更新：
+退出前在 `.comet.yaml` 中合并更新以下字段（保留其他字段不变）：
 
 ```yaml
-comet:
-  phase: archive
-  verify_result: pass
-  verified_at: YYYY-MM-DD
+phase: archive
+verify_result: pass
+verified_at: YYYY-MM-DD
 ```
 
+【写入验证】更新完成后必须验证：
+  cat openspec/changes/<name>/.comet.yaml
+  确认 phase 行的值为 "archive"
+  确认 verify_result 行的值为 "pass"
+  确认 verified_at 行的值非空（格式为 YYYY-MM-DD）
+  如任一字段不匹配，重试写入后再次验证。最多重试 2 次，仍失败则报告错误并终止。
+
 ## 自动流转
 
 退出条件满足后，**无需等待用户再次输入**，直接执行下一阶段：

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "@rpamis/comet",
-  "version": "0.1.1",
-  "description": "OpenSpec + Superpowers dual-star development workflow",
-  "keywords": [
-    "comet",
-    "openspec",
-    "superpowers",
-    "skills",
-    "workflow"
-  ],
-  "license": "MIT",
-  "author": "benym",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "comet": "./bin/comet.js"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "assets",
-    "scripts/postinstall.js",
-    "!dist/**/*.test.js",
-    "!dist/**/__tests__"
-  ],
-  "scripts": {
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepare": "pnpm run build",
-    "prepublishOnly": "node scripts/prepublish-check.js && pnpm run build",
-    "postinstall": "node scripts/postinstall.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "devDependencies": {
-    "@types/node": "^24.2.0",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
-  },
-  "dependencies": {
-    "@inquirer/prompts": "^8.4.3",
-    "commander": "^14.0.0"
-  }
-}
+{
+  "name": "@rpamis/comet",
+  "version": "0.1.3",
+  "description": "OpenSpec + Superpowers dual-star development workflow",
+  "keywords": [
+    "comet",
+    "openspec",
+    "superpowers",
+    "skills",
+    "workflow"
+  ],
+  "license": "MIT",
+  "author": "benym",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "comet": "./bin/comet.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "assets",
+    "scripts/postinstall.js",
+    "!dist/**/*.test.js",
+    "!dist/**/__tests__"
+  ],
+  "scripts": {
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "pnpm run build",
+    "prepublishOnly": "node scripts/prepublish-check.js && pnpm run build",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.4.3",
+    "commander": "^14.0.0"
+  }
+}