@pzy560117/opentest 0.1.2 → 0.1.3

package/assets/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.2",
+  "version": "0.1.3",
   "skills": [
     "opentest/SKILL.md",
     "opentest/scripts/opentest-state.sh",

package/assets/skills/opentest/SKILL.md

@@ -27,6 +27,8 @@ OPENTEST_DETECT="${OPENTEST_DETECT:-$(find "${OPENTEST_SEARCH_ROOTS[@]}" -path '
 
 ## Step 1: 状态检测
 
+如果存在 `docs/loop-handoff/latest.md`，先读取 handoff，确认上次 OpenTest 阶段、矩阵/验收/报告路径、阻塞项和下一步。handoff 只作为恢复线索，不替代 `.opentest.yaml`。
+
 如果 `.opentest.yaml` 不存在，运行：
 
 ```bash
@@ -59,7 +61,7 @@ bash "$OPENTEST_STATE" get phase
 - `phase: heal`：调用 `opentest-heal`。
 - `phase: archive`：调用 `opentest-archive`。
 
-若状态与可验证文件冲突，以文件状态为准，并用 `opentest-state.sh set` 修正。
+若状态与可验证文件冲突，以文件状态为准，并用 `opentest-state.sh set` 修正；如存在 handoff，也同步更新 handoff 的“当前阶段/下一步/失败阻塞”。
 
 ## OpenTest-Driven Development 用法
 
@@ -83,3 +85,9 @@ bash "$OPENTEST_STATE" get phase
 - 哪些证据是必需，哪些是不适用，哪些是 gap 或 risk-accepted 候选。
 
 实现完成后，`OpenSuper verify` 可以引用 OpenTest 的 verification report，但不能替代 OpenTest 的矩阵、运行记录和验收证据。
+
+## Loop Handoff 衔接
+
+OpenTest 每完成 `plan`、`author`、`run`、`accept`、`verify` 任一阶段后，应更新 `docs/loop-handoff/latest.md`，至少记录 `.opentest.yaml` 路径、当前阶段、测试资产路径、已运行验证、未运行验证、失败/阻塞和下一步。
+
+`opentest-verify` 生成的 verification report 路径必须写入 handoff，方便 OpenSuper verify 或新会话恢复时直接引用。

package/assets/skills/opentest-accept/SKILL.md

@@ -17,7 +17,8 @@ description: "OpenTest 阶段 4：执行自然语言验收、MCP 验收或真实
 4. 对反馈类场景，必须观察实际呈现位置和形态；例如字段错误不能只记录“失败”，要记录是否在字段下方、表单顶部、toast、modal 或页面错误区显示。
 5. 工具、环境或前置数据不可用时，记录 blocked evidence。
 6. 更新验收记录。
-7. 运行 `bash "$OPENTEST_GUARD" accept --apply`。
+7. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录验收结果、截图/步骤证据路径、blocked evidence 和下一步。
+8. 运行 `bash "$OPENTEST_GUARD" accept --apply`。
 
 ## Existing Skill Routing
 

package/assets/skills/opentest-author/SKILL.md

@@ -19,7 +19,8 @@ description: "OpenTest 阶段 2：根据矩阵补齐测试资产和自然语言
 4. 对前端反馈类用例，写清反馈位置和形态，例如字段下方错误、表单顶部错误、toast、modal、inline status 或页面错误态。
 5. 对不适用或当前无法补齐的证据，记录原因和风险。
 6. 写入 `.opentest.yaml` 的 `acceptance` 字段。
-7. 运行 `bash "$OPENTEST_GUARD" author --apply`。
+7. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录测试资产、自然语言验收用例、gap/risk 和下一步。
+8. 运行 `bash "$OPENTEST_GUARD" author --apply`。
 
 ## Existing Skill Routing
 

package/assets/skills/opentest-plan/SKILL.md

@@ -20,7 +20,8 @@ description: "OpenTest 阶段 1：分析变更、风险和项目事实，生成
 5. 生成窄矩阵，至少包含 `ID`、`意图`、`触发/输入`、`期望行为`、`风险`、`证据层级`、`必需证据`、`状态`。
 6. 对适用但未覆盖的证据面标记 `gap`。
 7. 写入 `.opentest.yaml` 的 `plan` 和 `matrix` 字段。
-8. 运行 `bash "$OPENTEST_GUARD" plan --apply`。
+8. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录 plan、matrix 路径、当前阶段和下一步。
+9. 运行 `bash "$OPENTEST_GUARD" plan --apply`。
 
 ## 约束
 

package/assets/skills/opentest-run/SKILL.md

@@ -24,4 +24,5 @@ description: "OpenTest 阶段 3：按 targeted、fast、full 或 ci-like 模式
 2. 优先使用项目显式命令，按矩阵中的证据层级选择 targeted、fast、full 或 ci-like。
 3. 记录命令、退出码、摘要和日志路径到 `docs/opentest/runs/`。
 4. 写入 `.opentest.yaml` 的 `run_report` 字段。
-5. 运行 `bash "$OPENTEST_GUARD" run --apply`。
+5. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录已运行验证、未运行验证、失败/阻塞、run report 路径和下一步。
+6. 运行 `bash "$OPENTEST_GUARD" run --apply`。

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

@@ -14,6 +14,7 @@ description: "OpenTest 阶段 5：应用质量门并生成验证报告。"
 验证报告按 build、type、lint、test、security、diff 组织。若项目没有某类命令，记录为 missing command 或 not applicable，不把未知状态写成 pass。
 
 按 build、type、lint、test、security、diff 的顺序组织证据。必需测试、必需验收、构建、类型或 lint 失败时标记 `fail`。非必需缺口可记录为 `risk-accepted`。写入 `docs/opentest/reports/` 和 `.opentest.yaml` 的 `verification_report`、`verification_result`。
+如果项目使用 Loop Handoff，同时把 OpenTest verification report 路径、verification result、已运行验证、未运行验证、失败/阻塞和下一步写入 `docs/loop-handoff/latest.md`。
 
 验证报告还必须回看矩阵，确认：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pzy560117/opentest",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OpenTest quality evidence lifecycle skills for Codex",
   "keywords": [
     "opentest",