@epoint-testtech/ep-stage-skill 0.0.3-alpha.2 → 0.0.4-alpha.1

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

@@ -1,139 +0,0 @@
-# CRUD Pipeline 参考（CRUD Pipeline Reference）
-
-## 输入参数（Inputs）
-
-使用显式输入。当用户已经明确给出路径时，不要大范围搜索。
-
-| 输入 | 用途 | 说明 |
-| --- | --- | --- |
-| `--module-id` | 契约标识 | 稳定的技术标识，例如 `zwplace`。 |
-| `--docs` | 需求/规格目录 | 当存在 `spec.yaml` 时优先使用；当前 CLI 可回退到 `code_list.md` 的模块标签。 |
-| `--code-list` | 模块清单 | 通常为 `<knowledge-project>/_docs/code_list.md`。 |
-| `--webapp` | 生成的 HTML 页面 | 包含 list/add/edit/detail HTML 文件的目录。 |
-| `--java-actions` | Java Action 源码 | 包含 `*Action.java` 文件的目录，用于后端消息/规则。 |
-| `--hints` | 策略决策 | 数据主键、搜索条件、按钮别名、自动填充覆盖、删除策略、断言。 |
-| `--out` | 契约 JSON | 除非用户另有指定，否则输出保持在 `packages/ep-stage-skill/output/` 下。 |
-
-## ModuleHints 指引（ModuleHints Guidance）
-
-`ModuleHints` 是"已提取事实"与"测试人员策略"之间的边界。
-
-以下内容应放入 hints，而不是由 Agent 自行推断：
-
-- `dataKey.selectedField` 和 `dataKey.generationStrategy`
-- `searchConditions[]`，尤其是 listbox 的 `value`
-- `buttonAliases`
-- `autofill.overrideFields`
-- `deletePolicy`
-- 断言策略覆盖
-
-对于多条件 CRUD 冒烟测试，推荐：
-
-```json
-{
-  "dataKey": {
-    "selectedField": "placename",
-    "generationStrategy": "timestamp_prefix"
-  },
-  "searchConditions": [
-    {
-      "field": "placename",
-      "component": "input",
-      "seedValue": "自动化测试名称",
-      "strategy": "timestamp_prefix",
-      "updatePrefix": "修改"
-    },
-    {
-      "field": "placecategory",
-      "component": "listbox",
-      "value": "条线大厅",
-      "createSelections": [
-        { "field": "placecategory", "value": "条线大厅" }
-      ]
-    }
-  ]
-}
-```
-
-`searchConditions` 驱动生成的 `CrudFlowSlots`。`dataKey` 仍作为兼容性和策略锚点保留，但不应与独立的 `searchField` 概念重复。
-
-## 生成契约（Generate Contract）
-
-从仓库根目录执行：
-
-```bash
-pnpm --filter @epoint/ep-stage-skill generate:crud-contract -- \
-  --module-id <module-id> \
-  --docs <absolute-upstream-docs-dir> \
-  --code-list <absolute-code-list-md> \
-  --webapp <absolute-webapp-html-dir> \
-  --java-actions <absolute-java-action-dir> \
-  --hints examples/<module>.module-hints.json \
-  --out output/<module>.crud.contract.json
-```
-
-由于 `pnpm --filter` 会在包目录内执行，上游路径通常应使用绝对路径。
-
-## 检查契约闸门（Inspect Contract Gate）
-
-```bash
-node --input-type=module -e "
-import fs from 'node:fs';
-const c = JSON.parse(fs.readFileSync('packages/ep-stage-skill/output/<module>.crud.contract.json', 'utf8'));
-console.log(JSON.stringify({
-  contractVersion: c.contractVersion,
-  module: c.module,
-  searchConditions: c.searchConditions?.map(({ field, label, component, value }) => ({ field, label, component, value })),
-  unresolvedSlots: c.unresolvedSlots?.map(({ slotId, reason }) => ({ slotId, reason }))
-}, null, 2));
-if (c.unresolvedSlots?.length) process.exit(2);
-"
-```
-
-若退出码为 `2`，请更新 `ModuleHints` 并重新生成。不要从存在未解析槽位（unresolved slots）的契约生成最终 spec。
-
-## 生成 Spec（Generate Spec）
-
-```bash
-pnpm --filter @epoint/ep-stage-skill generate:playwright-tests -- \
-  --contract output/<module>.crud.contract.json \
-  --out <absolute-glue-project>/src/tests/<name>.spec.ts \
-  --menu "<menu-path>"
-```
-
-生成的 spec 应当：
-
-- 从 `../skeletons` 导入 `CrudPage`、`LoginPage`、`MenuPage` 以及 `type CrudFlowSlots`
-- 定义 `const crudSlots: CrudFlowSlots`
-- 调用 `await crudPage.runCrudFlow()`
-- 避免内联 Playwright 操作流程
-
-## 在消费方 glue 项目中验证（Verify In Consuming Glue Project）
-
-```bash
-cd <glue-project>
-pnpm --ignore-workspace exec tsc --noEmit
-```
-
-运行时验证需要 `.env` 配置：
-
-```text
-LOGIN_SYSTEM_URL=...
-LOGIN_USERNAME=...
-LOGIN_PASSWORD=...
-HEADLESS=false
-```
-
-仅当业务系统可达时才执行：
-
-```bash
-pnpm --ignore-workspace exec playwright test src/tests/<name>.spec.ts --project=chromium --headed --workers=1
-```
-
-若运行时失败，将失败原因归类为：
-
-- 系统可达性或登录配置
-- 上游物料不匹配
-- `ModuleHints` 缺失或错误
-- 骨架/组件行为
-- 包生成器缺陷

package/codex-skill/ep-stage/glue-testcase/SKILL.md

@@ -1,31 +0,0 @@
----
-name: glue-testcase
-description: 使用时机：当需要基于 ep-stage 可观测 trace、场景推理结果和 coverage diff 先生成可人工审阅的胶水测试用例中间产物，再供 glue-test 组装 Playwright spec 时使用。
----
-
-# ep-stage: glue-testcase
-
-本 skill 只负责测试用例中间产物（`glue-testcase.json` / `.md`），不直接生成或执行 Playwright spec。
-
-## 工作流
-
-```text
-读取 .stage/trace
-  -> 检查 scenario-inference 是否已确认（--scenario）
-  -> 读取 coverage-diff
-  -> 生成 testcase JSON / Markdown（testcases/<module>.glue-testcase.*）
-  -> 展示推理摘要和未确认项
-  -> 人工确认后供 glue-test 消费
-```
-
-## 关键约束
-
-- 未确认的 `scenario-inference` 不得生成可执行 spec。
-- `candidate` 和 `unresolved` 必须写入 testcase 的 `reviewStatus` 和 `unresolved`。
-- 嵌套 CRUD 一期只能作为候选用例进入 testcase，不写入正式 CRUD 契约。
-- 对话中展示的是可审阅推理摘要和证据链，不展示原始隐式思维链。
-
-## 按需加载
-
-- 用例 schema：`references/testcase-schema.md`
-- 样例产物：`examples/observable-testcase.json`

package/codex-skill/ep-stage/glue-testcase/references/testcase-schema.md

@@ -1,67 +0,0 @@
-# glue-testcase schema
-
-`glue-testcase` 的 JSON 顶层结构：
-
-```json
-{
-  "moduleId": "zwplace",
-  "moduleName": "场所窗口信息管理",
-  "cases": [
-    {
-      "caseId": "zwplace.create",
-      "title": "新增场所窗口信息管理",
-      "scenario": "crud.single-page",
-      "reviewStatus": "confirmed",
-      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
-      "steps": ["进入菜单", "点击新增", "填写并保存测试数据"],
-      "assertions": ["新增后可查询到记录"],
-      "unresolved": []
-    },
-    {
-      "caseId": "zwplace.read",
-      "title": "查询场所窗口信息管理",
-      "scenario": "crud.single-page",
-      "reviewStatus": "confirmed",
-      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
-      "steps": ["进入菜单", "输入查询字段", "提交查询"],
-      "assertions": ["查询结果包含测试记录"],
-      "unresolved": []
-    },
-    {
-      "caseId": "zwplace.update",
-      "title": "修改场所窗口信息管理",
-      "scenario": "crud.single-page",
-      "reviewStatus": "confirmed",
-      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
-      "steps": ["定位测试记录", "点击修改", "保存更新值"],
-      "assertions": ["修改后可查询到更新记录"],
-      "unresolved": []
-    },
-    {
-      "caseId": "zwplace.delete",
-      "title": "删除场所窗口信息管理",
-      "scenario": "crud.single-page",
-      "reviewStatus": "confirmed",
-      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
-      "steps": ["定位测试记录", "点击删除", "确认删除策略"],
-      "assertions": ["删除结果符合契约断言策略"],
-      "unresolved": []
-    }
-  ],
-  "reasoningSummary": {
-    "conclusion": "生成 4 条 CRUD 胶水测试用例。",
-    "evidenceChain": [],
-    "alternatives": ["crud.single-page"],
-    "confidence": "high",
-    "risks": [],
-    "needsHumanReview": false
-  }
-}
-```
-
-## 字段说明
-
-- `reviewStatus`：`confirmed` / `needs_review` / `blocked`。`needs_review` 的用例不得进入 spec assembly。
-- `caseId`：spec assembly 需要与生成脚本工作流粒度一致，CRUD 用例固定为 `<moduleId>.create`、`<moduleId>.read`、`<moduleId>.update`、`<moduleId>.delete`。
-- `unresolved`：未确认项（如嵌套 CRUD 子表保存后断言）。必须落盘，不能只在对话解释。
-- `reasoningSummary`：与 `.stage/trace/<run-id>/testcase-generation.json` 同构。