@pzy560117/opentest 0.1.3 → 0.1.5

package/assets/skills-zh/opentest/references/quality-gate.md

@@ -0,0 +1,24 @@
+# OpenTest 质量门
+
+## 阻塞项
+
+- 构建失败
+- 类型检查失败
+- lint 失败
+- 必需测试失败
+- 必需验收失败
+- 高风险行为缺少必需证据
+- 必需证据标记为 blocked 但没有恢复路径
+- 产品行为失败被隐藏成测试资产问题
+
+## 已接受风险
+
+- 非关键证据缺口已有书面原因
+- 可选工具不可用，但已有替代证据
+- 低风险行为通过 review 覆盖，而不是执行验证
+- blocked 证据有明确原因和负责人，且行为不是 high-risk
+
+## 非阻塞缺口
+
+- 证据不适用于本次变更
+- 可选覆盖维度省略且有原因

package/assets/skills-zh/opentest/templates/acceptance-template.md

@@ -0,0 +1,32 @@
+# OpenTest 验收用例
+
+## ACC-001
+
+- 意图:
+- 背景:
+- 执行角色:
+- 执行界面:
+- 触发/输入:
+- 期望反馈位置:
+- status: pending
+
+### 操作步骤
+
+1.
+
+### 期望结果
+
+-
+
+### 反馈契约
+
+- 反馈位置:
+- 视觉状态:
+- 重试/恢复:
+- 数据保留:
+
+### 证据记录
+
+- status:
+- 备注:
+- 产物:

package/assets/skills-zh/opentest/templates/archive-layout.md

@@ -0,0 +1,14 @@
+# OpenTest 归档布局
+
+将已完成证据归档到：
+
+`docs/opentest/archive/YYYY-MM-DD-<topic>/`
+
+包含：
+
+- 测试策略
+- 验收到测试矩阵
+- 验收证据
+- 运行报告
+- 验证报告
+- 可用的截图或日志

package/assets/skills-zh/opentest/templates/matrix-template.md

@@ -0,0 +1,6 @@
+# 验收到测试矩阵
+
+| ID | 意图 | 触发/输入 | 期望行为 | 风险 | 证据层级 | 必需证据 | 状态 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| ACC-001 | 主路径成功 |  |  | low | smoke | targeted review | pending |
+| ACC-002 | 失败/边界路径 |  |  | medium | acceptance | UI/API 验收 | pending |

package/assets/skills-zh/opentest/templates/plan-template.md

@@ -0,0 +1,28 @@
+# OpenTest 测试策略
+
+## 变更摘要
+
+- 变更类型:
+- 风险等级:
+- 影响面:
+
+## 适用覆盖面
+
+- 必需:
+- 不适用:
+- gap:
+
+## 隐性场景挖掘
+
+- 空输入/非法输入:
+- 网络/服务端失败:
+- 权限/会话:
+- 重复提交/并发/过期状态:
+- 加载/空状态/错误/重试:
+- 移动端/可访问性:
+- 安全/敏感信息:
+
+## 证据计划
+
+| 证据层级 | 适用场景 | 命令或执行面 | 产物路径 | 状态 |
+| --- | --- | --- | --- | --- |

package/assets/skills-zh/opentest/templates/report-template.md

@@ -0,0 +1,28 @@
+# OpenTest 验证报告
+
+## 摘要
+
+- result:
+- 运行模式:
+- 验证时间:
+
+## 命令记录
+
+| 命令 | 退出码 | result | 日志 |
+| --- | --- | --- | --- |
+
+## 验收证据
+
+| ID | 是否必需 | result | 证据 | 备注 |
+| --- | --- | --- | --- | --- |
+
+## 矩阵覆盖
+
+| ID | 证据层级 | 必需证据 | result | 缺口/风险 |
+| --- | --- | --- | --- | --- |
+
+## 质量门
+
+- 阻塞项:
+- 已接受风险:
+- 非阻塞缺口:

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

@@ -0,0 +1,25 @@
+---
+name: opentest-accept
+description: "OpenTest 阶段 4：执行自然语言验收、MCP 验收或真实链路验收，并回写证据。"
+---
+
+# OpenTest Accept
+
+## 目标
+
+执行必需验收项，并把 PASS、FAIL 或 blocked evidence 回写到验收用例和矩阵。
+
+## 步骤
+
+1. 读取矩阵和 `docs/opentest/acceptance/`。
+2. 对前端交互，优先用 Chrome DevTools MCP 执行真实页面验收。
+3. 对 API 或后台链路，使用项目已有命令或直接 API 检查。
+4. 对反馈类场景，必须观察实际呈现位置和形态；例如字段错误不能只记录“失败”，要记录是否在字段下方、表单顶部、轻提示、模态框或页面错误区显示。
+5. 工具、环境或前置数据不可用时，记录 blocked evidence。
+6. 更新验收记录。
+7. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录验收结果、截图/步骤证据路径、blocked evidence 和下一步。
+8. 运行 `bash "$OPENTEST_GUARD" accept --apply`。
+
+## 现有技能路由
+
+前端交互验收优先使用自然语言用例加 Chrome DevTools MCP。执行前先确认用例覆盖的是本次适用维度；执行后把 PASS、FAIL 或 blocked 写回对应 ACC ID。

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

@@ -0,0 +1,8 @@
+---
+name: opentest-archive
+description: "OpenTest 阶段 6：归档已通过验证的质量证据并关闭状态。"
+---
+
+# OpenTest Archive
+
+验证通过后，将 plan、matrix、acceptance、runs、reports 和可用截图或日志复制到 `docs/opentest/archive/`，运行 `bash "$OPENTEST_GUARD" archive --apply`。验证未通过时拒绝完成归档。

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

@@ -0,0 +1,27 @@
+---
+name: opentest-author
+description: "OpenTest 阶段 2：根据矩阵补齐测试资产和自然语言验收用例。"
+---
+
+# OpenTest Author
+
+## 目标
+
+根据 acceptance-to-test matrix 创建或更新测试资产。
+
+本阶段把矩阵变成可执行证据：能用项目测试框架证明的写测试；更适合真实链路、浏览器、API 或人工可复验步骤证明的，写自然语言验收用例。不要为了“像 TDD”而把所有交互反馈硬塞进 unit test。
+
+## 步骤
+
+1. 读取 `.opentest.yaml` 中的 `matrix`。
+2. 对 unit/component/integration/contract 证据，按项目已有测试框架创建或更新测试文件。
+3. 对 E2E、smoke、browser acceptance、真实 API 或跨页面流程，写入 `docs/opentest/acceptance/` 自然语言验收用例。
+4. 对前端反馈类用例，写清反馈位置和形态，例如字段下方错误、表单顶部错误、轻提示、模态框、行内状态或页面错误态。
+5. 对不适用或当前无法补齐的证据，记录原因和风险。
+6. 写入 `.opentest.yaml` 的 `acceptance` 字段。
+7. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录测试资产、自然语言验收用例、gap/risk 和下一步。
+8. 运行 `bash "$OPENTEST_GUARD" author --apply`。
+
+## 现有技能路由
+
+当矩阵要求代码级测试证据时，优先加载现有 TDD guidance。若项目规则要求特定测试框架，遵循项目规则。若当前任务更适合真实验收而不是新增测试框架代码，记录原因并交给 `opentest-accept`。

package/assets/skills-zh/opentest-heal/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: opentest-heal
+description: "OpenTest 恢复阶段：修复测试资产问题，不掩盖产品行为失败。"
+---
+
+# OpenTest Heal
+
+只处理 selector、等待策略、过期 label、过期自然语言步骤等测试资产问题。若失败说明产品行为不满足验收，停止 heal 并记录需要回到 author、run 或 verify。

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

@@ -0,0 +1,30 @@
+---
+name: opentest-plan
+description: "OpenTest 阶段 1：分析变更、风险和项目事实，生成测试策略与 acceptance-to-test matrix。"
+---
+
+# OpenTest Plan
+
+## 目标
+
+生成 `docs/opentest/plans/` 下的测试策略和 `docs/opentest/matrices/` 下的矩阵。
+
+本阶段是 OpenTest-driven development 的入口。它必须在实现前把“需求没写但成熟产品默认应该处理”的场景显性化，避免只根据字面需求写少量 happy path 测试。
+
+## 步骤
+
+1. 读取项目规则、需求、设计、diff、现有测试命令和 `opentest/references/codex-harness-coverage-heuristics.md`。
+2. 如果存在前端、表单、导航、CRUD、状态反馈或动效，优先读取项目内 `docs/frontend/DESIGN.md` 和可用的 `harness-frontend-design` / `product-ui-defaults` 规则。
+3. 判断变更类型、风险等级和适用覆盖面。
+4. 做隐性场景挖掘：空输入、非法输入、网络失败、权限不足、重复提交、长内容、空数据、错误映射、移动端、可访问性、跨页面返回和状态恢复。
+5. 生成窄矩阵，至少包含 `ID`、`意图`、`触发/输入`、`期望行为`、`风险`、`证据层级`、`必需证据`、`状态`。
+6. 对适用但未覆盖的证据面标记 `gap`。
+7. 写入 `.opentest.yaml` 的 `plan` 和 `matrix` 字段。
+8. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录 plan、matrix 路径、当前阶段和下一步。
+9. 运行 `bash "$OPENTEST_GUARD" plan --apply`。
+
+## 约束
+
+不要把 Codex Harness 全量 checklist 展开成固定必需项。低风险变更保留轻量覆盖摘要，高风险闭环再展开详细验收维度。
+
+不要把所有证据都写成 unit test。矩阵要明确哪些用 unit/component/integration/contract/E2E/smoke/browser acceptance/security review 证明。

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

@@ -0,0 +1,28 @@
+---
+name: opentest-run
+description: "OpenTest 阶段 3：按 targeted、fast、full 或 ci-like 模式运行项目测试命令。"
+---
+
+# OpenTest Run
+
+## 目标
+
+执行项目已有验证命令并写入运行报告。
+
+## 模式
+
+- `targeted`：只运行与矩阵相关的测试命令。
+- `fast`：运行快速反馈命令，例如 type、lint、unit。
+- `full`：运行项目完整测试命令。
+- `ci-like`：尽量复现 CI 验证顺序。
+
+证据层级由矩阵决定。不要因为存在 `npm test` 就只跑 unit test；如果矩阵要求 integration、contract、E2E、smoke 或安全检查，必须运行对应项目命令，或记录 missing command / blocked。
+
+## 步骤
+
+1. 读取 `.opentest.yaml` 的 `run_mode` 和矩阵。
+2. 优先使用项目显式命令，按矩阵中的证据层级选择 targeted、fast、full 或 ci-like。
+3. 记录命令、退出码、摘要和日志路径到 `docs/opentest/runs/`。
+4. 写入 `.opentest.yaml` 的 `run_report` 字段。
+5. 更新 `docs/loop-handoff/latest.md`（如果项目使用 Loop Handoff），记录已运行验证、未运行验证、失败/阻塞、run report 路径和下一步。
+6. 运行 `bash "$OPENTEST_GUARD" run --apply`。

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

@@ -0,0 +1,24 @@
+---
+name: opentest-verify
+description: "OpenTest 阶段 5：应用质量门并生成验证报告。"
+---
+
+# OpenTest Verify
+
+## 目标
+
+应用质量门，输出结构化验证报告，并把结果写回状态文件。
+
+## 验证顺序
+
+验证报告按 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`。
+
+验证报告还必须回看矩阵，确认：
+
+- 每个 required evidence 都有 pass、fail、blocked 或 risk-accepted 结论。
+- 高风险行为不能因为没有工具、没有测试框架或没有 seed data 就直接通过。
+- blocked evidence 必须包含阻塞原因和后续恢复路径。
+- 若产品行为失败，不进入 `heal` 修测试资产；应返回实现或需求修正。