@epoint-testtech/ep-stage-skill 0.0.4-alpha.0 → 0.0.5

package/codex-skill/ep-stage/recording-to-glue/SKILL.md

@@ -1,28 +1,28 @@
----
-name: recording-to-glue
-description: 使用时机：当用户讨论或规划「将录制产出的 Playwright 脚本转换为 ep-stage 胶水骨架（glue skeleton）或组件（component）候选代码」时使用。
-version: 2026-06-23+a9e7576
----
-
-# ep-stage: recording-to-glue
-
-本 skill 是一个规划中的能力入口。
-
-## 当前状态
-
-转换工作流在本期尚未实现。
-
-## 预期输入（未来）
-
-- 来自 `stage-recorder-ext` 或其他录制器的原始 Playwright 脚本。
-- 标识页面、iframe（frame）、选择器（selector）以及用户动作意图的录制元数据。
-
-## 预期产出（未来）
-
-- 候选胶水骨架代码（glue skeleton code）。
-- 候选组件动作（component actions）。
-- 关于代码应归入骨架、组件、测试 spec 还是 `ModuleHints` 的评审意见。
-
-## 当前行为
-
-当用户调用本 skill 时，应说明实现尚未开始，并提议为该转换工作流创建设计或实施计划，而不是在本期从录制产物生成生产级胶水代码。
+---
+name: recording-to-glue
+description: 使用时机：当用户讨论或规划「将录制产出的 Playwright 脚本转换为 ep-stage 胶水骨架（glue skeleton）或组件（component）候选代码」时使用。
+version: 2026-07-05+57662df
+---
+
+# ep-stage: recording-to-glue
+
+本 skill 是一个规划中的能力入口。
+
+## 当前状态
+
+转换工作流在本期尚未实现。
+
+## 预期输入（未来）
+
+- 来自 `stage-recorder-ext` 或其他录制器的原始 Playwright 脚本。
+- 标识页面、iframe（frame）、选择器（selector）以及用户动作意图的录制元数据。
+
+## 预期产出（未来）
+
+- 候选胶水骨架代码（glue skeleton code）。
+- 候选组件动作（component actions）。
+- 关于代码应归入骨架、组件、测试 spec，还是作为待确认槽位进入 `unresolvedSlots` / `sourceTrace` 的评审意见。
+
+## 当前行为
+
+当用户调用本 skill 时，应说明实现尚未开始，并提议为该转换工作流创建设计或实施计划，而不是在本期从录制产物生成生产级胶水代码。

package/codex-skill/ep-stage/scripts/validate-skill.mjs

@@ -1,95 +1,98 @@
-#!/usr/bin/env node
-// validate-skill.mjs — 校验 ep-stage scope 下所有 skill 的 SKILL.md frontmatter
-// + 双发现目录（.claude/skills / .agents/skills）symlink 指向。
-//
-// version 字段维护契约（REQ-VER-003）：
-//   当 SKILL.md 内容（frontmatter 或正文）发生变更时，维护者必须手动把
-//   `version:` 更新为 `YYYY-MM-DD+<7位短SHA>`，其中 <短SHA> 取当前 HEAD。
-//   快捷生成命令：date +"%Y-%m-%d"+$(git rev-parse --short HEAD)
-//   pre-commit hook（.husky/pre-commit → check-skill-version-bump.mjs）会
-//   自动校验：改了 SKILL.md 但没改 version 行 → 阻塞 commit。
-import { lstatSync, readFileSync, realpathSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const epStageRoot = path.resolve(__dirname, '..');
-const packageRoot = path.resolve(epStageRoot, '../..');
-const repoRoot = path.resolve(packageRoot, '../..');
-
-// version 值正则：YYYY-MM-DD+<7位十六进制短SHA>
-const VERSION_PATTERN = /^\d{4}-\d{2}-\d{2}\+[0-9a-f]{7}$/;
-
-function readFrontmatter(skillRoot) {
-  const skillPath = path.join(skillRoot, 'SKILL.md');
-  const text = readFileSync(skillPath, 'utf8');
-  const match = text.match(/^---\n([\s\S]*?)\n---\n/);
-  if (!match) throw new Error(`${skillPath} missing YAML frontmatter`);
-
-  const frontmatter = match[1];
-  return {
-    name: frontmatter.match(/^name:\s*(.+)$/m)?.[1]?.trim(),
-    description: frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim(),
-    version: frontmatter.match(/^version:\s*(.+)$/m)?.[1]?.trim(),
-    skillPath,
-  };
-}
-
-function assertSkill(skillRoot, expectedName) {
-  const { name, description, version, skillPath } = readFrontmatter(skillRoot);
-  if (name !== expectedName) throw new Error(`Expected name ${expectedName} in ${skillPath}, got ${name ?? 'missing'}`);
-  if (!description?.startsWith('使用时机') && !description?.startsWith('Use when')) throw new Error(`${skillPath} description 必须以「使用时机」或「Use when」开头`);
-  if (description.length > 1024) throw new Error(`${skillPath} description exceeds 1024 characters`);
-  if (path.basename(skillRoot) !== name) throw new Error(`${skillPath} directory basename must match name`);
-  if (!version) throw new Error(`${skillPath} version 字段缺失；维护者改 SKILL.md 时必须同步更新 version（格式 YYYY-MM-DD+<7位短SHA>）`);
-  if (!VERSION_PATTERN.test(version)) throw new Error(`${skillPath} version 格式非法 "${version}"；应为 YYYY-MM-DD+<7位短SHA>，如 2026-06-23+a9e7576`);
-  return { name, descriptionLength: description.length, version, skillRoot };
-}
-
-function assertSymlink(linkPath, targetPath) {
-  const linkStat = lstatSync(linkPath);
-  if (!linkStat.isSymbolicLink()) throw new Error(`${linkPath} must be a symlink`);
-  if (realpathSync(linkPath) !== realpathSync(targetPath)) {
-    throw new Error(`${linkPath} does not point at ${targetPath}`);
-  }
-}
-
-// ep-stage scope 下四个 skill 的包内真相源目录。
-// 注：Task 0.2 已 git mv 改名 3 个 skill 目录（glue-* 前缀化）。
-// - glue-create-project：Task 2.1 已同步 SKILL.md frontmatter name → 'glue-create-project'。
-// - glue-generate-testcase：Task 3.2 已同步 SKILL.md frontmatter name → 'glue-generate-testcase'。
-// - glue-run-test：Task 4.3 已同步 SKILL.md frontmatter name → 'glue-run-test'。
-const skillSources = [
-  { name: 'glue-create-project', source: path.join(epStageRoot, 'glue-create-project') },
-  { name: 'glue-generate-testcase', source: path.join(epStageRoot, 'glue-generate-testcase') },
-  { name: 'glue-run-test', source: path.join(epStageRoot, 'glue-run-test') },
-  { name: 'recording-to-glue', source: path.join(epStageRoot, 'recording-to-glue') },
-];
-
-// 校验每个源 skill 的 SKILL.md frontmatter。
-const checks = skillSources.map(({ name, source }) => assertSkill(source, name));
-
-// 发现目录：Claude Code 扫 .claude/skills/，Codex 扫 .agents/skills/。
-// 两个工具都只扫直接子目录，每个子目录是一个 skill；用 symlink 指向包内源。
-const discoveryDirs = [
-  path.join(repoRoot, '.claude/skills'),
-  path.join(repoRoot, '.agents/skills'),
-];
-
-// 注：symlink 名总是与包内目录 basename 一致（Phase 0 重建后）。
-// Task 4.3 收敛后，3 个 glue-* skill 的 SKILL.md `name` 与目录 basename 完全一致；symlink 仍以 basename 为准。
-const symlinks = [];
-for (const dir of discoveryDirs) {
-  for (const { name, source } of skillSources) {
-    const linkName = path.basename(source);
-    assertSymlink(path.join(dir, linkName), source);
-    symlinks.push({ dir: path.relative(repoRoot, dir), name, linkName, pointsTo: path.relative(repoRoot, source) });
-  }
-}
-
-console.log(JSON.stringify({
-  ok: true,
-  packageRoot,
-  checks,
-  symlinks,
-}, null, 2));
+#!/usr/bin/env node
+// validate-skill.mjs — 校验 ep-stage scope 下所有 skill 的 SKILL.md frontmatter
+// + 双发现目录（.claude/skills / .agents/skills）symlink 指向。
+//
+// version 字段维护契约（REQ-VER-003）：
+//   当 SKILL.md 内容（frontmatter 或正文）发生变更时，维护者必须手动把
+//   `version:` 更新为 `YYYY-MM-DD+<7位短SHA>`，其中 <短SHA> 取当前 HEAD。
+//   快捷生成命令：date +"%Y-%m-%d"+$(git rev-parse --short HEAD)
+//   pre-commit hook（.husky/pre-commit → check-skill-version-bump.mjs）会
+//   自动校验：改了 SKILL.md 但没改 version 行 → 阻塞 commit。
+import { lstatSync, readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const epStageRoot = path.resolve(__dirname, '..');
+const packageRoot = path.resolve(epStageRoot, '../..');
+const repoRoot = path.resolve(packageRoot, '../..');
+
+// version 值正则：YYYY-MM-DD+<7位十六进制短SHA>
+const VERSION_PATTERN = /^\d{4}-\d{2}-\d{2}\+[0-9a-f]{7}$/;
+
+function readFrontmatter(skillRoot) {
+  const skillPath = path.join(skillRoot, 'SKILL.md');
+  const text = readFileSync(skillPath, 'utf8');
+  // Windows 工作树 core.autocrlf=true 时文件是 CRLF，先容忍 \r 再匹配。
+  const match = text.replace(/\r/g, '').match(/^---\n([\s\S]*?)\n---\n/);
+  if (!match) throw new Error(`${skillPath} missing YAML frontmatter`);
+
+  const frontmatter = match[1];
+  return {
+    name: frontmatter.match(/^name:\s*(.+)$/m)?.[1]?.trim(),
+    description: frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim(),
+    version: frontmatter.match(/^version:\s*(.+)$/m)?.[1]?.trim(),
+    skillPath,
+  };
+}
+
+function assertSkill(skillRoot, expectedName) {
+  const { name, description, version, skillPath } = readFrontmatter(skillRoot);
+  if (name !== expectedName) throw new Error(`Expected name ${expectedName} in ${skillPath}, got ${name ?? 'missing'}`);
+  if (!description?.startsWith('使用时机') && !description?.startsWith('Use when')) throw new Error(`${skillPath} description 必须以「使用时机」或「Use when」开头`);
+  if (description.length > 1024) throw new Error(`${skillPath} description exceeds 1024 characters`);
+  if (path.basename(skillRoot) !== name) throw new Error(`${skillPath} directory basename must match name`);
+  if (!version) throw new Error(`${skillPath} version 字段缺失；维护者改 SKILL.md 时必须同步更新 version（格式 YYYY-MM-DD+<7位短SHA>）`);
+  if (!VERSION_PATTERN.test(version)) throw new Error(`${skillPath} version 格式非法 "${version}"；应为 YYYY-MM-DD+<7位短SHA>，如 2026-06-23+a9e7576`);
+  return { name, descriptionLength: description.length, version, skillRoot };
+}
+
+function assertSymlink(linkPath, targetPath) {
+  const linkStat = lstatSync(linkPath);
+  if (!linkStat.isSymbolicLink()) throw new Error(`${linkPath} must be a symlink`);
+  if (realpathSync(linkPath) !== realpathSync(targetPath)) {
+    throw new Error(`${linkPath} does not point at ${targetPath}`);
+  }
+}
+
+// ep-stage scope 下四个 skill 的包内真相源目录。
+// 注：Task 0.2 已 git mv 改名 3 个 skill 目录（glue-* 前缀化）。
+// - glue-create-project：Task 2.1 已同步 SKILL.md frontmatter name → 'glue-create-project'。
+// - glue-generate-testcase：Task 3.2 已同步 SKILL.md frontmatter name → 'glue-generate-testcase'。
+// - glue-run-test：Task 4.3 已同步 SKILL.md frontmatter name → 'glue-run-test'。
+const skillSources = [
+  { name: 'glue-create-project', source: path.join(epStageRoot, 'glue-create-project') },
+  { name: 'glue-generate-testcase', source: path.join(epStageRoot, 'glue-generate-testcase') },
+  { name: 'glue-run-test', source: path.join(epStageRoot, 'glue-run-test') },
+  { name: 'recording-to-glue', source: path.join(epStageRoot, 'recording-to-glue') },
+];
+
+// 校验每个源 skill 的 SKILL.md frontmatter。
+const checks = skillSources.map(({ name, source }) => assertSkill(source, name));
+
+// 发现目录：Claude Code 扫 .claude/skills/，Codex 扫 .agents/skills/。
+// 两个工具都只扫直接子目录，每个子目录是一个 skill；用 symlink 指向包内源。
+const discoveryDirs = [
+  path.join(repoRoot, '.claude/skills'),
+  path.join(repoRoot, '.agents/skills'),
+];
+
+// 注：symlink 名总是与包内目录 basename 一致（Phase 0 重建后）。
+// Task 4.3 收敛后，3 个 glue-* skill 的 SKILL.md `name` 与目录 basename 完全一致；symlink 仍以 basename 为准。
+const symlinks = [];
+// Windows 工作树 symlink 会物化为普通目录/文本文件，无法做指向校验，跳过（Mac/Linux 仍强制）。
+const skipSymlinkCheck = process.platform === 'win32';
+for (const dir of discoveryDirs) {
+  for (const { name, source } of skillSources) {
+    const linkName = path.basename(source);
+    if (!skipSymlinkCheck) assertSymlink(path.join(dir, linkName), source);
+    symlinks.push({ dir: path.relative(repoRoot, dir), name, linkName, pointsTo: path.relative(repoRoot, source), checkSkipped: skipSymlinkCheck });
+  }
+}
+
+console.log(JSON.stringify({
+  ok: true,
+  packageRoot,
+  checks,
+  symlinks,
+}, null, 2));

package/dist/src/cli/generate-testcase.d.ts

@@ -1,36 +1,28 @@
-import type { TestcaseV2 } from '../testcase/testcase-v2.js';
 /**
- * testcase 子命令解析后的参数（REQ-CHAIN-01 / REQ-SCENE-01）。
+ * testcase 子命令解析后的参数（JSON5 新产线，Task 3）。
  *
- * - codeList：上游 code_list.md 绝对路径（必填）；
- * - testsDir：<projectDir>/src/tests/<需求名> 绝对路径（必填）；
- * - scenario：①档优先级（显式 CLI 参数）；
- * - hints：ModuleHints JSON 路径（可选；推断 scenario 用）；
- * - projectDir / requirementDir：可选覆盖，默认从 codeList 路径推断。
+ * - codeList：上游 _docs/code_list.json5 绝对路径（必填，必须是 .json5）
+ * - testsDir：<projectDir>/src/tests/<需求名> 绝对路径（必填）
+ * - projectDir / requirementDir：可选覆盖，默认从 codeList 路径推断；
+ *   projectDir 用于 projects.index.json5 回写，新产线不依赖旧 probe 物料解析。
  */
 export type GenerateTestcaseArgs = {
     codeList: string;
     testsDir: string;
-    scenario?: string;
-    hints?: string;
     projectDir?: string;
     requirementDir?: string;
+    directUrl?: string;
+    sourceRoot?: string;
 };
 /**
- * testcase 子命令产物 + 推断结果（供 skill Step 5 交互确认）。
+ * testcase 子命令产物路径（JSON5 新产线，Task 3）。
  */
 export type GenerateTestcaseResult = {
     testcasePath: string;
     testcaseMdPath: string;
     credentialsTemplatePath: string;
-    inference: {
-        scenario: string;
-        requiredSystems: TestcaseV2['requiredSystems'];
-        requiredRoles: TestcaseV2['requiredRoles'];
-        credentialsTemplatePath: string;
-        credentialsActualPath: string;
-        cachedSystemsHit: string[];
-    };
+    inferenceTracePath: string;
+    contractPath: string;
 };
 /**
  * 解析 testcase 子命令参数。
@@ -41,43 +33,18 @@ export type GenerateTestcaseResult = {
  */
 export declare function parseGenerateTestcaseArgs(argv: string[]): GenerateTestcaseArgs;
 /**
- * scenario 3 档决策（REQ-SCENE-01）：
- * 1. --scenario CLI 参数（最高优先级）
- * 2. ModuleHints 文件路径包含 `scenario=<value>` 字串（粗推断）
- * 3. 默认 "crud.single-page"（与 i18n 表 / skeleton scenario 一致）
- *
- * @param args - 解析后的参数。
- * @returns 决策结果。
- */
-export declare function decideScenario(args: GenerateTestcaseArgs): string;
-/**
- * 把 TestcaseV2 渲染成中文 testcase.md（REQ-UX-03）。
- *
- * 设计：
- * - 字段名 / 状态值通过 i18nTestcase() 翻译；
- * - `unresolved` 字段标题硬编码「未确认项」（i18n 表中 `unresolved` 解析为状态值「未解决」）；
- * - 每次重跑覆盖（REQ-DATA-03 由调用方 writeFileSync 触发）。
- *
- * @param testcase - TestcaseV2 顶层结构。
- * @returns Markdown 文本。
- */
-export declare function renderTestcaseMarkdown(testcase: TestcaseV2): string;
-/**
- * testcase 子命令主体（REQ-CHAIN-01 / REQ-CHAIN-02 / REQ-SCENE-01 / REQ-DATA-02）。
+ * testcase 子命令主体（JSON5 新产线，Task 3）。
  *
  * 流程：
- * 1. 决定 scenario（3 档优先级，写入 testcase 顶层 scenario 字段）；
- * 2. 调 runProbeAndCoverage 钻探上游物料 + 装配 TestcaseV2；
- * 3. 落盘 testcase.json5 + testcase.md（中文 i18n） + credentials.template.json5；
- * 4. 软链上游 code_list.md → <tests-dir>/code_list.md；
- * 5. 返回推断结果（供 skill Step 5 交互确认 systemUrl / credentialsCache 命中）。
- *
- * 注意：contract 提取通过 probe 内部完成，不直接复用 dev/extract-contract.ts 的 CLI 入口
- * （probe + extract-contract 共享同一组 buildCrudBusinessModuleContract + extractor 依赖，
- * 二者各自负责自己的 I/O 边界，保持职责单一）。
+ * 1. extractCodeListJson5 解析 code_list.json5；
+ * 2. assembleJson5ContractAndTestcase 装配 contract + testcase + inference-trace；
+ * 3. validateContract / validateTestcase schema 门禁；
+ * 4. 落盘 .ep-stage/contract.json5 + testcase.json5 + .ep-stage/inference-trace.json +
+ *    credentials.template.json5 + testcase.md；软链 code_list.json5；
+ * 5. 可选回写 projects.index.json5（仅当显式传入 projectDir）。
  *
  * @param args - 已解析参数。
- * @returns 产物路径 + 推断结果。
+ * @returns 产物路径。
  */
 export declare function runGenerateTestcase(args: GenerateTestcaseArgs): GenerateTestcaseResult;
 //# sourceMappingURL=generate-testcase.d.ts.map

package/dist/src/cli/generate-testcase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-testcase.d.ts","sourceRoot":"","sources":["../../../src/cli/generate-testcase.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;QAC/C,aAAa,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;QAC3C,uBAAuB,EAAE,MAAM,CAAC;QAChC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAqB9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAOjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAgDnE;AAsBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CA+CtF"}
+{"version":3,"file":"generate-testcase.d.ts","sourceRoot":"","sources":["../../../src/cli/generate-testcase.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAqB9E;AAqGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CAkEtF"}