@epoint-testtech/ep-stage-skill 0.0.10 → 0.5.0-alpha.2

package/codex-skill/ep-stage/glue-run-test/references/ai-runtime-loop.md

@@ -1,30 +1,30 @@
-# AI Runtime Loop
-
-glue-run-test 对 `generationStrategy=ai` 的用例采用受控运行态推理。
-
-状态机：
-
-```text
-prepare_tasks_cli
-  -> agent_infer_ai_snippets
-  -> compose_full_spec_cli
-  -> run_full_spec
-  -> classify_result
-      -> passed: final_report
-      -> failed: write_repair_report
-  -> wait_human_direction
-  -> repair_spec
-  -> rerun
-```
-
-Agent 可以读取 trace tasks，并使用 playwright-cli 观察页面、iframe、弹窗、提示和网络反馈；CLI 不做业务推理。Agent 不能新增测试范围、反刷 code_list.json5、静默改 testcase.json5 或绕开 docs/00-memory/dev-rules.md。
-
-失败后第一版只落：
-
-```text
-.ep-stage/ai-runtime-trace.json5
-.ep-stage/ai-snippets.json5
-.ep-stage/repair-runs/<round>/repair-report.md
-```
-
-修补 loop 不设固定轮数上限，每轮失败先落袋、人审纠偏，再修补重跑。退出条件：用户停止、同类失败无新证据、环境不可达、权限不足、数据不足、需要改变测试意图、真实业务不满足预期。
+# AI Runtime Loop
+
+glue-run-test 对 `generationStrategy=ai` 的用例采用受控运行态推理。
+
+状态机：
+
+```text
+prepare_tasks_cli
+  -> agent_infer_ai_snippets
+  -> compose_full_spec_cli
+  -> run_full_spec
+  -> classify_result
+      -> passed: final_report
+      -> failed: write_repair_report
+  -> wait_human_direction
+  -> repair_spec
+  -> rerun
+```
+
+Agent 可以读取 trace tasks，并使用 playwright-cli 观察页面、iframe、弹窗、提示和网络反馈；CLI 不做业务推理。Agent 不能新增测试范围、反刷 code_list.json5、静默改 testcase.json5 或绕开 docs/00-memory/dev-rules.md。
+
+失败后第一版只落：
+
+```text
+.ep-stage/ai-runtime-trace.json5
+.ep-stage/ai-snippets.json5
+.ep-stage/repair-runs/<round>/repair-report.md
+```
+
+修补 loop 不设固定轮数上限，每轮失败先落袋、人审纠偏，再修补重跑。退出条件：用户停止、同类失败无新证据、环境不可达、权限不足、数据不足、需要改变测试意图、真实业务不满足预期。

package/codex-skill/ep-stage/glue-run-test/references/crud-pipeline.md

@@ -1,132 +1,132 @@
-# CRUD Pipeline 参考（CRUD Pipeline Reference）
-
-> 本文为 `glue-run-test` skill 的参考文档。所有 CLI 调用统一使用 `npx -y @epoint-testtech/ep-stage-skill@latest <subcommand>` 形态（REQ-CLI-01 / REQ-CLI-02）。
-
-## 子命令一览
-
-| 子命令 | 入口 | 说明 |
-| --- | --- | --- |
-| `testcase` | `glue-generate-testcase` skill 包装 | 上游钻探 + contract 提取 + coverage 分析 + testcase v1-draft 生成 + credentials.template 生成 + code_list 软链 |
-| `spec` | `glue-run-test` skill 包装（**只生成不执行**） | 读 testcase + contract → 组装胶水骨架 `crud.spec.ts`（仅覆盖 cases[] 胶水部分） |
-| `prepare-tasks` | `glue-run-test` skill 包装 | 读 testcase（spec 缺失则自动组装）→ 为 ai 候选构建 runtime task → 写 ai-runtime-trace.json5 |
-| `run` | `glue-run-test` skill 包装 | 读 Agent 产出的 ai-snippets.json5 → 合并 resolved snippet → 执行完整 spec → 失败归类写 repair report |
-
-> **contract 提取已内嵌**到 `testcase` 子命令（REQ-CLI-02），不暴露为独立 CLI 命令。开发期可用 `pnpm generate:crud-contract`（路由到 `src/cli/dev/extract-contract.ts`），仅作调试入口，**不进 SKILL.md**。
-
-## 产物边界（Artifact Boundaries）
-
-当前正式链路不再使用 `ModuleHints` 作为输入源。测试策略和待确认信息应进入以下产物：
-
-- `_docs/code_list.json5`：只记录上游需求、页面、按钮、字段、业务规则等出码事实。
-- `.ep-stage/contract.json5`：记录下游可消费的当前结论和 `unresolvedSlots`。
-- `testcase.json5`：记录 `cases[]` 与 `uncoveredCandidates[]`，用 `coverageStatus` / `reviewStatus` 表达阻断和待确认。
-- `.ep-stage/ai-runtime-trace.json5`：记录 AI Runtime Task、结果和修补轮次。
-- `.ep-stage/repair-runs/<round>/repair-report.md`：失败后的人工修补建议。
-
-不得把运行态页面结果、最终 locator、账号密码或 AI 自由猜测反写入 `code_list.json5`。
-
-## 检查 testcase 闸门（Inspect Testcase Gate）
-
-testcase 子命令产出后，由 skill 校验 `testcase.json5` 顶层结构（schemaVersion=ep-stage-testcase/v1-draft + scenario + menuPath + cases + uncoveredCandidates + testAccess）。`cases[]`（`generationStrategy='glue'`）任一 `reviewStatus !== 'confirmed'` → 阻断 spec 组装；`uncoveredCandidates[]` 用 `generationStrategy`（'ai'）+ `coverageStatus`（'blocked' 等）分桶，`coverageStatus='blocked'` 的候选不进入 run 的 runtime task。
-
-详细 schema 见 [glue-generate-testcase/references/testcase-schema.md](../../glue-generate-testcase/references/testcase-schema.md)。
-
-## 生成 Spec（Generate Spec）
-
-任意 cwd 执行（**只生成不执行**，REQ-SPEC-01）：
-
-```bash
-npx -y @epoint-testtech/ep-stage-skill@latest spec \
-  --testcase <projectDir>/src/tests/<需求名>/testcase.json5 \
-  --out <projectDir>/src/tests/<需求名>/crud.spec.ts
-```
-
-生成的 spec（v1 初始版）应当：
-
-- 从 `../../skeletons` 导入 `CrudPage`、`LoginPage`、`MenuPage` 以及 `type CrudFlowSlots`
-- 定义 `const crudSlots: CrudFlowSlots`
-- 调用 `await crudPage.runCrudFlow()`
-- 仅覆盖 `cases[]` 胶水部分；`uncoveredCandidates` 留给 Agent Runtime 产出 snippets，再由 `run` 子命令追加
-- 避免内联 Playwright 操作流程
-
-## 准备 AI 任务（Prepare Tasks）
-
-```bash
-npx -y @epoint-testtech/ep-stage-skill@latest prepare-tasks \
-  --testcase <projectDir>/src/tests/<需求名>/testcase.json5
-```
-
-prepare-tasks 内部步骤：
-
-1. 从 `runtimeContext` 或向上查找定位 projectDir/specPath；`crud.spec.ts` 缺失时先跑 `spec` 组装胶水骨架
-2. 解析 testcase，为 `uncoveredCandidates[]` 中 `generationStrategy='ai'` 且 `coverageStatus !== 'blocked'` 的候选构建 AI Runtime Task
-3. 写 `.ep-stage/ai-runtime-trace.json5`（tasks 就绪，results 为空）
-
-## Agent 推理（Agent O-D-A-V）
-
-Agent 读取 `.ep-stage/ai-runtime-trace.json5`，使用 playwright-cli 观察和操作真实页面，产出 `.ep-stage/ai-snippets.json5`。详见 [playwright-cli-odav.md](./playwright-cli-odav.md)。
-
-## 执行 + AI snippet 合并（Run + AI Snippet Append）
-
-```bash
-npx -y @epoint-testtech/ep-stage-skill@latest run \
-  --testcase <projectDir>/src/tests/<需求名>/testcase.json5 \
-  --ai-snippets <projectDir>/src/tests/<需求名>/.ep-stage/ai-snippets.json5 \
-  --headless false
-```
-
-run 子命令接收 `--testcase`、`--ai-snippets` 与 `--headless`，不接收 `--spec`。内部步骤：
-
-1. 读取 ai-snippets.json5，只接受当前 testcase 下 status=resolved 且 specSnippet 非空的结果
-2. 若存在 AI Runtime Task 但缺少 resolved snippet，写 trace `needs_review` 后停止，不追加占位代码、不执行 Playwright
-3. 幂等合并：以 `// === AI 钻探追加（基于 uncoveredCandidates[].generationStrategy=ai）===` 为标记截断旧追加段，重新追加本轮 snippet
-4. 写 `.ep-stage/ai-runtime-trace.json5`（tasks + results）
-5. 执行完整 spec（`npx playwright test <specPath>`，headless=false 时 `--headed`）
-6. 失败时 `classifyRunFailure` 归类并写 `.ep-stage/repair-runs/<round>/repair-report.md`，同时回写 trace.repairRounds；成功时不写 repair report
-7. 读 `<需求名>/credentials.json5`（数组形态多角色，REQ-ENV-02）作消费边界声明
-
-**重跑 run**：检测到 spec 已含 AI 钻探追加标记时截断覆盖追加段，保证幂等。
-
-## 凭据配置（Credentials Config）
-
-凭据下沉到**需求级** `credentials.json5` 数组形态（REQ-ENV-02 / REQ-ENV-03），**不再用 `.env`**：
-
-```json5
-// <projectDir>/src/tests/<需求名>/credentials.json5（gitignore）
-[
-  {
-    url: "http://192.168.x.x:8100/.../login",
-    username: "admin",
-    password: "***",
-    role: "admin",           // 可选，多角色场景必填
-    systemName: "主业务系统"  // 可选，便于审阅与报告
-  }
-]
-```
-
-字段约束（Task 1.1 `validateCredentials` 强制）：
-
-- 必填：`url` / `username` / `password`
-- 可选：`role`（用于 Playwright 多角色登录切换）/ `systemName`
-- `(url, role)` 组合唯一
-
-完整流程参考 [glue-generate-testcase SKILL.md](../../glue-generate-testcase/SKILL.md) 第 5 步「与用户交互确认推断结果」。
-
-## 在消费方 glue 项目中本地编译验证（Optional Local Check）
-
-```bash
-cd <projectDir>
-pnpm --ignore-workspace exec tsc --noEmit
-```
-
-仅校验 v1 spec 编译通过；不执行测试。Playwright 真实执行走 `run` 子命令。
-
-## 失败归类（Failure Triage）
-
-若运行时失败，将失败原因归类为：
-
-- **系统可达性或登录配置** — credentials.json5 缺字段 / URL 不通 / 角色凭据错；引导场景 C
-- **上游物料不匹配** — code_list.json5 缺字段；引导场景 D
-- **AI 候选阻断或待审** — `coverageStatus: 'blocked'` / `reviewStatus: 'needs_review'` / `unresolvedSlots` 非空；补齐上游证据或人工确认后重跑
-- **骨架/组件行为** — `CrudPage` / `LoginPage` 实现 bug；本地修复后回归
-- **包生成器缺陷** — `spec` / `run` 子命令产物错误；走 ep-stage-skill 仓库 issue
+# CRUD Pipeline 参考（CRUD Pipeline Reference）
+
+> 本文为 `glue-run-test` skill 的参考文档。所有 CLI 调用统一使用 `npx -y @epoint-testtech/ep-stage-skill@latest <subcommand>` 形态（REQ-CLI-01 / REQ-CLI-02）。
+
+## 子命令一览
+
+| 子命令 | 入口 | 说明 |
+| --- | --- | --- |
+| `testcase` | `glue-generate-testcase` skill 包装 | 上游钻探 + contract 提取 + coverage 分析 + testcase v1-draft 生成 + credentials.template 生成 + code_list 软链 |
+| `spec` | `glue-run-test` skill 包装（**只生成不执行**） | 读 testcase + contract → 组装胶水骨架 `crud.spec.ts`（仅覆盖 cases[] 胶水部分） |
+| `prepare-tasks` | `glue-run-test` skill 包装 | 读 testcase（spec 缺失则自动组装）→ 为 ai 候选构建 runtime task → 写 ai-runtime-trace.json5 |
+| `run` | `glue-run-test` skill 包装 | 读 Agent 产出的 ai-snippets.json5 → 合并 resolved snippet → 执行完整 spec → 失败归类写 repair report |
+
+> **contract 提取已内嵌**到 `testcase` 子命令（REQ-CLI-02），不暴露为独立 CLI 命令。开发期可用 `pnpm generate:crud-contract`（路由到 `src/cli/dev/extract-contract.ts`），仅作调试入口，**不进 SKILL.md**。
+
+## 产物边界（Artifact Boundaries）
+
+当前正式链路不再使用 `ModuleHints` 作为输入源。测试策略和待确认信息应进入以下产物：
+
+- `_docs/code_list.json5`：只记录上游需求、页面、按钮、字段、业务规则等出码事实。
+- `.ep-stage/contract.json5`：记录下游可消费的当前结论和 `unresolvedSlots`。
+- `testcase.json5`：记录 `cases[]` 与 `uncoveredCandidates[]`，用 `coverageStatus` / `reviewStatus` 表达阻断和待确认。
+- `.ep-stage/ai-runtime-trace.json5`：记录 AI Runtime Task、结果和修补轮次。
+- `.ep-stage/repair-runs/<round>/repair-report.md`：失败后的人工修补建议。
+
+不得把运行态页面结果、最终 locator、账号密码或 AI 自由猜测反写入 `code_list.json5`。
+
+## 检查 testcase 闸门（Inspect Testcase Gate）
+
+testcase 子命令产出后，由 skill 校验 `testcase.json5` 顶层结构（schemaVersion=ep-stage-testcase/v1-draft + scenario + menuPath + cases + uncoveredCandidates + testAccess）。`cases[]`（`generationStrategy='glue'`）任一 `reviewStatus !== 'confirmed'` → 阻断 spec 组装；`uncoveredCandidates[]` 用 `generationStrategy`（'ai'）+ `coverageStatus`（'blocked' 等）分桶，`coverageStatus='blocked'` 的候选不进入 run 的 runtime task。
+
+详细 schema 见 [glue-generate-testcase/references/testcase-schema.md](../../glue-generate-testcase/references/testcase-schema.md)。
+
+## 生成 Spec（Generate Spec）
+
+任意 cwd 执行（**只生成不执行**，REQ-SPEC-01）：
+
+```bash
+npx -y @epoint-testtech/ep-stage-skill@latest spec \
+  --testcase <projectDir>/src/tests/<需求名>/testcase.json5 \
+  --out <projectDir>/src/tests/<需求名>/crud.spec.ts
+```
+
+生成的 spec（v1 初始版）应当：
+
+- 从 `../../skeletons` 导入 `CrudPage`、`LoginPage`、`MenuPage` 以及 `type CrudFlowSlots`
+- 定义 `const crudSlots: CrudFlowSlots`
+- 调用 `await crudPage.runCrudFlow()`
+- 仅覆盖 `cases[]` 胶水部分；`uncoveredCandidates` 留给 Agent Runtime 产出 snippets，再由 `run` 子命令追加
+- 避免内联 Playwright 操作流程
+
+## 准备 AI 任务（Prepare Tasks）
+
+```bash
+npx -y @epoint-testtech/ep-stage-skill@latest prepare-tasks \
+  --testcase <projectDir>/src/tests/<需求名>/testcase.json5
+```
+
+prepare-tasks 内部步骤：
+
+1. 从 `runtimeContext` 或向上查找定位 projectDir/specPath；`crud.spec.ts` 缺失时先跑 `spec` 组装胶水骨架
+2. 解析 testcase，为 `uncoveredCandidates[]` 中 `generationStrategy='ai'` 且 `coverageStatus !== 'blocked'` 的候选构建 AI Runtime Task
+3. 写 `.ep-stage/ai-runtime-trace.json5`（tasks 就绪，results 为空）
+
+## Agent 推理（Agent O-D-A-V）
+
+Agent 读取 `.ep-stage/ai-runtime-trace.json5`，使用 playwright-cli 观察和操作真实页面，产出 `.ep-stage/ai-snippets.json5`。详见 [playwright-cli-odav.md](./playwright-cli-odav.md)。
+
+## 执行 + AI snippet 合并（Run + AI Snippet Append）
+
+```bash
+npx -y @epoint-testtech/ep-stage-skill@latest run \
+  --testcase <projectDir>/src/tests/<需求名>/testcase.json5 \
+  --ai-snippets <projectDir>/src/tests/<需求名>/.ep-stage/ai-snippets.json5 \
+  --headless false
+```
+
+run 子命令接收 `--testcase`、`--ai-snippets` 与 `--headless`，不接收 `--spec`。内部步骤：
+
+1. 读取 ai-snippets.json5，只接受当前 testcase 下 status=resolved 且 specSnippet 非空的结果
+2. 若存在 AI Runtime Task 但缺少 resolved snippet，写 trace `needs_review` 后停止，不追加占位代码、不执行 Playwright
+3. 幂等合并：以 `// === AI 钻探追加（基于 uncoveredCandidates[].generationStrategy=ai）===` 为标记截断旧追加段，重新追加本轮 snippet
+4. 写 `.ep-stage/ai-runtime-trace.json5`（tasks + results）
+5. 执行完整 spec（`npx playwright test <specPath>`，headless=false 时 `--headed`）
+6. 失败时 `classifyRunFailure` 归类并写 `.ep-stage/repair-runs/<round>/repair-report.md`，同时回写 trace.repairRounds；成功时不写 repair report
+7. 读 `<需求名>/credentials.json5`（数组形态多角色，REQ-ENV-02）作消费边界声明
+
+**重跑 run**：检测到 spec 已含 AI 钻探追加标记时截断覆盖追加段，保证幂等。
+
+## 凭据配置（Credentials Config）
+
+凭据下沉到**需求级** `credentials.json5` 数组形态（REQ-ENV-02 / REQ-ENV-03），**不再用 `.env`**：
+
+```json5
+// <projectDir>/src/tests/<需求名>/credentials.json5（gitignore）
+[
+  {
+    url: "http://192.168.x.x:8100/.../login",
+    username: "admin",
+    password: "***",
+    role: "admin",           // 可选，多角色场景必填
+    systemName: "主业务系统"  // 可选，便于审阅与报告
+  }
+]
+```
+
+字段约束（Task 1.1 `validateCredentials` 强制）：
+
+- 必填：`url` / `username` / `password`
+- 可选：`role`（用于 Playwright 多角色登录切换）/ `systemName`
+- `(url, role)` 组合唯一
+
+完整流程参考 [glue-generate-testcase SKILL.md](../../glue-generate-testcase/SKILL.md) 第 5 步「与用户交互确认推断结果」。
+
+## 在消费方 glue 项目中本地编译验证（Optional Local Check）
+
+```bash
+cd <projectDir>
+pnpm --ignore-workspace exec tsc --noEmit
+```
+
+仅校验 v1 spec 编译通过；不执行测试。Playwright 真实执行走 `run` 子命令。
+
+## 失败归类（Failure Triage）
+
+若运行时失败，将失败原因归类为：
+
+- **系统可达性或登录配置** — credentials.json5 缺字段 / URL 不通 / 角色凭据错；引导场景 C
+- **上游物料不匹配** — code_list.json5 缺字段；引导场景 D
+- **AI 候选阻断或待审** — `coverageStatus: 'blocked'` / `reviewStatus: 'needs_review'` / `unresolvedSlots` 非空；补齐上游证据或人工确认后重跑
+- **骨架/组件行为** — `CrudPage` / `LoginPage` 实现 bug；本地修复后回归
+- **包生成器缺陷** — `spec` / `run` 子命令产物错误；走 ep-stage-skill 仓库 issue

package/codex-skill/ep-stage/glue-run-test/references/gap-review-protocol.md

@@ -1,44 +1,44 @@
-# Gap 评审协议（Gap Review Protocol）
-
-本参考定义 `glue-run-test` 对 `testcase.json5.uncoveredCandidates[]` 的评审和运行边界。它不再依赖旧 `ModuleHints` 或 `run:gap-pipeline`，当前正式链路以 `glue-generate-testcase` 产出的 `testcase.json5` / `contract.json5` 为准。
-
-## 输入
-
-- `testcase.json5` 中的 `uncoveredCandidates[]`。
-- `.ep-stage/contract.json5` 中的 `unresolvedSlots[]` 和 `scenario.skeletonSlots`。
-- `.ep-stage/inference-trace.json` 中的推理来源。
-- `.ep-stage/ai-runtime-trace.json5` 中的 AI Runtime Task 与结果。
-- Agent Runtime 产出的 `.ep-stage/ai-snippets.json5`。
-
-## 状态处理
-
-| 状态 | 行为 |
-|------|------|
-| `generationStrategy: 'glue'` | 不属于 gap，由 `spec` 子命令组装胶水骨架。 |
-| `generationStrategy: 'ai'` + `coverageStatus !== 'blocked'` | 可进入 `prepare-tasks`，由 Agent O-D-A-V 产出 snippet。 |
-| `coverageStatus: 'blocked'` | 不进入 AI Runtime Task；保留在 testcase / trace / review 输出中等待人工补齐。 |
-| `reviewStatus: 'needs_review'` | 不静默推进；提示人工审阅上下游证据和缺口原因。 |
-| `unresolvedSlots` 非空 | `spec` / `run` 不二次猜测槽位；先要求补充来源或确认。 |
-
-## 面向用户的摘要格式
-
-```text
-Gap: 同步窗口管理系统
-caseId: zwplace.syncWindowSystem
-coverageStatus: gap
-reviewStatus: needs_review
-generationStrategy: ai
-evidence: code_list.json5 pages[].toolbarActions + Java Action method
-businessIntent: 同步窗口管理系统数据
-assertionExpectation: 出现同步结果提示
-recommendedAction: run-ai-runtime | supplement-code-list | block
-```
-
-## 约束
-
-- 不得虚构业务意图。
-- 不得虚构断言文案。
-- 不得把 `coverageStatus: 'blocked'` 的候选追加进 spec。
-- 不得在缺少 resolved `ai-snippets.json5` 时追加占位 snippet。
-- 不得通过修改骨架来让一个 gap 假通过。
-- 修补失败时先写 `repair-report.md` 等待人工确认，不静默削弱断言或改变 testcase 意图。
+# Gap 评审协议（Gap Review Protocol）
+
+本参考定义 `glue-run-test` 对 `testcase.json5.uncoveredCandidates[]` 的评审和运行边界。它不再依赖旧 `ModuleHints` 或 `run:gap-pipeline`，当前正式链路以 `glue-generate-testcase` 产出的 `testcase.json5` / `contract.json5` 为准。
+
+## 输入
+
+- `testcase.json5` 中的 `uncoveredCandidates[]`。
+- `.ep-stage/contract.json5` 中的 `unresolvedSlots[]` 和 `scenario.skeletonSlots`。
+- `.ep-stage/inference-trace.json` 中的推理来源。
+- `.ep-stage/ai-runtime-trace.json5` 中的 AI Runtime Task 与结果。
+- Agent Runtime 产出的 `.ep-stage/ai-snippets.json5`。
+
+## 状态处理
+
+| 状态 | 行为 |
+|------|------|
+| `generationStrategy: 'glue'` | 不属于 gap，由 `spec` 子命令组装胶水骨架。 |
+| `generationStrategy: 'ai'` + `coverageStatus !== 'blocked'` | 可进入 `prepare-tasks`，由 Agent O-D-A-V 产出 snippet。 |
+| `coverageStatus: 'blocked'` | 不进入 AI Runtime Task；保留在 testcase / trace / review 输出中等待人工补齐。 |
+| `reviewStatus: 'needs_review'` | 不静默推进；提示人工审阅上下游证据和缺口原因。 |
+| `unresolvedSlots` 非空 | `spec` / `run` 不二次猜测槽位；先要求补充来源或确认。 |
+
+## 面向用户的摘要格式
+
+```text
+Gap: 同步窗口管理系统
+caseId: zwplace.syncWindowSystem
+coverageStatus: gap
+reviewStatus: needs_review
+generationStrategy: ai
+evidence: code_list.json5 pages[].toolbarActions + Java Action method
+businessIntent: 同步窗口管理系统数据
+assertionExpectation: 出现同步结果提示
+recommendedAction: run-ai-runtime | supplement-code-list | block
+```
+
+## 约束
+
+- 不得虚构业务意图。
+- 不得虚构断言文案。
+- 不得把 `coverageStatus: 'blocked'` 的候选追加进 spec。
+- 不得在缺少 resolved `ai-snippets.json5` 时追加占位 snippet。
+- 不得通过修改骨架来让一个 gap 假通过。
+- 修补失败时先写 `repair-report.md` 等待人工确认，不静默削弱断言或改变 testcase 意图。

package/codex-skill/ep-stage/glue-run-test/references/harness-principles.md

@@ -1,46 +1,46 @@
-# Stage Glue 的治理原则（Harness Principles）
-
-本 skill 将治理工程（harness-engineering）应用为一条小巧、显式的流水线，而非一个庞大且无所不包的提示词。
-
-## 设计承诺（Design Commitments）
-
-1. **仓库即记录系统（Repository as record system）**
-   - 契约、hints、生成的 spec 以及验证命令都是本地文件。
-   - 不要仅依赖截图或对话记忆作为唯一事实来源。
-
-2. **渐进式披露（Progressive disclosure）**
-   - `SKILL.md` 承载路由和护栏。
-   - `references/crud-pipeline.md` 承载命令和闸门。
-   - 仅当确定性命令执行有用时才加载脚本。
-
-3. **规划器/生成器/评估器分离（Planner/generator/evaluator separation）**
-   - 规划器（Planner）：识别上游物料和缺失的策略槽位。
-   - 生成器（Generator）：运行提取器和骨架渲染器。
-   - 评估器（Evaluator）：检查 `unresolvedSlots`，汇总输出，并可选地运行 Playwright。
-
-4. **最小可行治理（Minimum viable harness）**
-   - 日常工作中直接使用包 CLI。
-   - 仅当重复处理路径或未解析槽位闸门容易出错时，才使用 `scripts/generate-crud-spec.mjs`。
-   - 除非模块或验证目标过大、单次确定性执行无法覆盖，否则不要引入多 Agent 循环。
-
-5. **反过拟合（Anti-overfitting）**
-   - `zwplace` 是回归 fixture 和示例。
-   - 可复用的抽象是：上游物料 -> `crud-business-module/v1` -> `CrudFlowSlots` -> glue 骨架。
-   - 模块特有的取值应放入 hints 和生成产物中，而不是 skill 指令里。
-
-## 质量闸门（Quality Gates）
-
-| 闸门 | 证据 |
-| --- | --- |
-| Skill 可发现性 | `name` 与目录名一致，且 `description` 以 `Use when` 开头。 |
-| 契约健康度 | `contractVersion`、模块标识、`searchConditions`，且 `unresolvedSlots` 为空。 |
-| 骨架兼容性 | 生成的 spec 导入骨架类型，并能在 glue 项目中编译通过。 |
-| 运行时冒烟 | Playwright 测试在可达的业务系统上通过。 |
-| 交接清晰度 | 最终响应列出已生成文件、已执行命令以及未解决的风险。 |
-
-## 失败处理（Failure Handling）
-
-- 若上游路径错误，先停下来修正路径，再编辑 hints。
-- 若 `unresolvedSlots` 非空，应更新 hints，而不是削弱生成器检查。
-- 若 listbox 取值不唯一，在 hints 中选择一个合法的冒烟测试取值；完整数据覆盖不在 CRUD 冒烟范围之内。
-- 若 Playwright 无法连通系统，应将环境/网络状态与生成正确性分开报告。
+# Stage Glue 的治理原则（Harness Principles）
+
+本 skill 将治理工程（harness-engineering）应用为一条小巧、显式的流水线，而非一个庞大且无所不包的提示词。
+
+## 设计承诺（Design Commitments）
+
+1. **仓库即记录系统（Repository as record system）**
+   - 契约、hints、生成的 spec 以及验证命令都是本地文件。
+   - 不要仅依赖截图或对话记忆作为唯一事实来源。
+
+2. **渐进式披露（Progressive disclosure）**
+   - `SKILL.md` 承载路由和护栏。
+   - `references/crud-pipeline.md` 承载命令和闸门。
+   - 仅当确定性命令执行有用时才加载脚本。
+
+3. **规划器/生成器/评估器分离（Planner/generator/evaluator separation）**
+   - 规划器（Planner）：识别上游物料和缺失的策略槽位。
+   - 生成器（Generator）：运行提取器和骨架渲染器。
+   - 评估器（Evaluator）：检查 `unresolvedSlots`，汇总输出，并可选地运行 Playwright。
+
+4. **最小可行治理（Minimum viable harness）**
+   - 日常工作中直接使用包 CLI。
+   - 仅当重复处理路径或未解析槽位闸门容易出错时，才使用 `scripts/generate-crud-spec.mjs`。
+   - 除非模块或验证目标过大、单次确定性执行无法覆盖，否则不要引入多 Agent 循环。
+
+5. **反过拟合（Anti-overfitting）**
+   - `zwplace` 是回归 fixture 和示例。
+   - 可复用的抽象是：上游物料 -> `crud-business-module/v1` -> `CrudFlowSlots` -> glue 骨架。
+   - 模块特有的取值应放入 hints 和生成产物中，而不是 skill 指令里。
+
+## 质量闸门（Quality Gates）
+
+| 闸门 | 证据 |
+| --- | --- |
+| Skill 可发现性 | `name` 与目录名一致，且 `description` 以 `Use when` 开头。 |
+| 契约健康度 | `contractVersion`、模块标识、`searchConditions`，且 `unresolvedSlots` 为空。 |
+| 骨架兼容性 | 生成的 spec 导入骨架类型，并能在 glue 项目中编译通过。 |
+| 运行时冒烟 | Playwright 测试在可达的业务系统上通过。 |
+| 交接清晰度 | 最终响应列出已生成文件、已执行命令以及未解决的风险。 |
+
+## 失败处理（Failure Handling）
+
+- 若上游路径错误，先停下来修正路径，再编辑 hints。
+- 若 `unresolvedSlots` 非空，应更新 hints，而不是削弱生成器检查。
+- 若 listbox 取值不唯一，在 hints 中选择一个合法的冒烟测试取值；完整数据覆盖不在 CRUD 冒烟范围之内。
+- 若 Playwright 无法连通系统，应将环境/网络状态与生成正确性分开报告。