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

package/SKILL.md

@@ -1,27 +1,27 @@
----
-name: ep-stage-skill-package
-description: 使用时机：当需要维护 @epoint-testtech/ep-stage-skill 包源码、CLI 提取器、CRUD 契约生成器，或面向 Codex 的 ep-stage skill 资产时使用。
----
-
-# @epoint-testtech/ep-stage-skill 包
-
-本包负责面向 Codex 的 `ep-stage` skill 背后的确定性工具链：
-
-- 读取 `_docs/code_list.json5` 并生成 `contract.json5`、`testcase.json5`、`inference-trace.json`
-- 基于 `testcase.json5` 与 `contract.json5` 组装 glue 模式的 Playwright spec
-- 通过 AI Runtime Task、`ai-snippets.json5`、`repair-report.md` 支撑未命中骨架能力的 O-D-A-V 闭环
-
-Codex skill 范围位于：
-
-```text
-packages/ep-stage-skill/codex-skill/ep-stage/
-```
-
-为便于 Agent 发现，本仓库通过双目录暴露 skill（Claude Code 扫描 `.claude/skills/`，Codex 扫描 `.agents/skills/`），二者均以 symlink 指向包源码：
-
-```text
-.claude/skills/<skill>  ->  packages/ep-stage-skill/codex-skill/ep-stage/<skill>
-.agents/skills/<skill>  ->  packages/ep-stage-skill/codex-skill/ep-stage/<skill>
-```
-
-对于面向用户的行为，编辑 `codex-skill/ep-stage/*/SKILL.md`。
+---
+name: ep-stage-skill-package
+description: 使用时机：当需要维护 @epoint-testtech/ep-stage-skill 包源码、CLI 提取器、CRUD 契约生成器，或面向 Codex 的 ep-stage skill 资产时使用。
+---
+
+# @epoint-testtech/ep-stage-skill 包
+
+本包负责面向 Codex 的 `ep-stage` skill 背后的确定性工具链：
+
+- 读取 `_docs/code_list.json5` 并生成 `contract.json5`、`testcase.json5`、`inference-trace.json`
+- 基于 `testcase.json5` 与 `contract.json5` 组装 glue 模式的 Playwright spec
+- 通过 AI Runtime Task、`ai-snippets.json5`、`repair-report.md` 支撑未命中骨架能力的 O-D-A-V 闭环
+
+Codex skill 范围位于：
+
+```text
+packages/ep-stage-skill/codex-skill/ep-stage/
+```
+
+为便于 Agent 发现，本仓库通过双目录暴露 skill（Claude Code 扫描 `.claude/skills/`，Codex 扫描 `.agents/skills/`），二者均以 symlink 指向包源码：
+
+```text
+.claude/skills/<skill>  ->  packages/ep-stage-skill/codex-skill/ep-stage/<skill>
+.agents/skills/<skill>  ->  packages/ep-stage-skill/codex-skill/ep-stage/<skill>
+```
+
+对于面向用户的行为，编辑 `codex-skill/ep-stage/*/SKILL.md`。

package/codex-skill/ep-stage/glue-create-project/SKILL.md

@@ -1,223 +1,223 @@
----
-name: glue-create-project
-description: 使用时机：当用户表达「创建胶水项目 / 测试脚手架 / 新建 glue 项目」或显式触发 `/glue-create-project [名称或路径]` 时使用。本 skill 只创建胶水模式（glue）Playwright 测试脚手架，不收集登录信息，不写 .env / stage-context.md。
-version: 2026-08-12+925f4c4
-argument-hint: "<脚手架项目名或脚手架项目路径>"
----
-
-# ep-stage: glue-create-project
-
-本 skill 引导 Agent **包装** `@epoint-testtech/stage-create` CLI 的 glue 模式，不重新实现脚手架。用户视角全中文，不暴露 CLI 名称。
-
-> CLI 自 0.0.4-alpha.0 起已中性化：不再收集业务系统登录信息，不再写 `<projectDir>/.env`，也不再写 `<projectDir>/stage-context.md`。项目元信息全部沉到 `~/.ep-stage/projects.index.json5`（含 `stageCreateVersion`）。登录凭据由下游 `glue-generate-testcase` / `glue-run-test` 在需求级 `credentials.json5` 中收集。
-
-## 1. 自然语言映射规则
-
-用户在 Claude Code / Codex 里触发 skill 的典型形式：
-
-```text
-/glue-create-project my-project              # 裸名 → 落 <pwd>/e2e-test/my-project
-/glue-create-project path/my-project         # 含 / → 原样落点
-/glue-create-project /abs/path/my-project    # 绝对路径 → 原样落点
-/glue-create-project                         # 无参数 → 问项目名
-/glue-create-project my-project --debug      # 调试模式 → 跑本地 monorepo 的 stage-create dist
-```
-
-> **`--debug` flag**：正常调用走远程 `npx @epoint-testtech/stage-create@latest`。开发期想测试未发布的本地代码时传 `--debug`，skill 在 Step 3 改用 `node <repo>/packages/stage-create/dist/index.js`。前提：cwd 在 ep-stage monorepo 内（向上能找到 `pnpm-workspace.yaml`）；找不到时直接 exit 1 报错，不静默 fallback 到 npx。
-
-### 1.1 目标位置与项目名（路径解析三段式）
-
-CLI 接收 `[project-name]` 参数，内部用 `path.basename` 取项目名、`path.resolve` 取输出目录（基于 Agent cwd）：
-
-| 用户输入                                    | skill 传给 CLI 的值                         | 最终落点                                |
-|---------------------------------------------|---------------------------------------------|-----------------------------------------|
-| 含 `/` 或绝对路径                           | 原样透传                                    | `<cwd>/...` 或绝对路径；项目名取 basename |
-| 裸名（无 `/`）                              | 拼成 `e2e-test/<name>`                      | `<cwd>/e2e-test/<name>`                 |
-| 无参数                                      | 先问 `<name>`，再拼 `e2e-test/<name>`        | `<cwd>/e2e-test/<name>`                 |
-
-**逃生口**：想在当前 cwd 根直接建裸名（不进 `e2e-test/`），用 `./my-project`（含 `/`）。
-
-中文目录名 macOS/Linux 能建，但 npm scope 校验和跨平台兼容差。Agent 收到中文名时，AskUserQuestion 二选一：保留中文 / 换 kebab-case 建议（如 `我的项目` → `my-project`）。
-
-### 1.2 模式 — 固定 glue
-
-本 skill 只创建 glue 项目，固定传 `--mode glue`，不暴露 default 模式入口。
-
-### 1.3 工作目录 (cwd) 确认
-
-Agent 在调用 CLI 前必须：跑 `pwd` → 按 §1.1 算最终落点 → 中文复述"将在 `<最终落点>` 下创建项目，确认吗？" → 用户否认 → 让用户给绝对路径或先 `cd` 切换。
-
-典型陷阱：cwd 是 git 仓库根（存在 `.git/`）时必须额外二次确认，避免污染该仓库工作树。
-
-## 2. Agent 执行剧本（7 步任务清单协议）
-
-**任务清单协议（REQ-UX-01）**：
-
-- 加载 skill 后**最先**单行展示技能版本（取本 SKILL.md frontmatter 的 `version` 字段），格式 `技能版本：glue-create-project <version>`；随后**立即**打印初始任务清单（Step 0）。
-- 每完成一步，输出单行状态更新 `第 N 步 — <中文名> 已完成，进入第 N+1 步 — <下一中文名>...`（不重写完整清单）。
-- Step 7 输出全勾选终态清单 + 完成摘要。
-
-### Step 0 — 打印任务清单
-
-```markdown
-**创建胶水测试项目任务清单**
-
-- [ ] 第 1 步 — 抽取项目名与落点
-- [ ] 第 2 步 — 补齐核心参数（含 cwd 确认）
-- [ ] 第 3 步 — 调用脚手架 CLI
-- [ ] 第 4 步 — 验证脚手架产物
-- [ ] 第 5 步 — 安装依赖
-- [ ] 第 6 步 — 写入项目索引
-- [ ] 第 7 步 — 输出摘要
-```
-
-### Step 1 — 抽取项目名与落点
-
-从用户原始消息 / args 抽取目标路径/项目名（规则见 §1）。模式固定 glue。中文复述识别结果：
-
-> 已识别：项目名 = `xxx`，模式 = `胶水模式 (glue)`，落点 = `<pwd>/e2e-test/xxx`。
-
-识别失败/不确定 → Step 2 补齐。
-
-### Step 2 — 补齐核心参数（含 cwd 确认）
-
-只在缺失/有疑时触发，全中文：
-
-- 缺 `projectName`（无参数）→ free text 询问"请告诉我新项目的名称"，按 §1.1 拼 `e2e-test/<name>`。
-- 中文项目名 → AskUserQuestion 二选一：保留中文 / 换 `<kebab-case 建议>`。
-- cwd 是 git 仓库根 → AskUserQuestion 二选一：在此 cwd 创建 / 取消并手动 cd。
-
-> 本 skill 固定 glue 模式，不再收集登录信息，无需就模式或登录配置询问。
-
-### Step 3 — 调用脚手架 CLI
-
-固定流程（不 which、不扫 monorepo、不 cd 进项目、**不喂 stdin**）。`<targetPath>` 由 §1.1 算出。
-
-**正常模式**（用户 args 无 `--debug`）：
-
-```bash
-npx -y @epoint-testtech/stage-create@latest "<targetPath>" --mode glue
-```
-
-**调试模式**（用户 args 含 `--debug`，要求 cwd 在 ep-stage monorepo 内；详见 §1 `--debug` flag 说明）：
-
-```bash
-D="$PWD"; REPO=""
-while [ "$D" != "/" ]; do
-  if [ -f "$D/pnpm-workspace.yaml" ] && [ -f "$D/packages/stage-create/dist/index.js" ]; then
-    REPO="$D"; break
-  fi
-  D="$(dirname "$D")"
-done
-[ -z "$REPO" ] && { echo "错误：--debug 但找不到本地 monorepo（需 cwd 在 ep-stage 仓库内向上能找到 pnpm-workspace.yaml + packages/stage-create/dist/index.js）"; exit 1; }
-echo "调试模式：本地 $REPO/packages/stage-create/dist/index.js"
-node "$REPO/packages/stage-create/dist/index.js" "<targetPath>" --mode glue
-```
-
-CLI 中性化后**不读 stdin**，不询问登录 URL / 用户名 / 密码 / 知识库根。
-
-### Step 4 — 验证脚手架产物
-
-按 §4 验证产物。验证失败 → §3 错误处理报告，不发完成提示。
-
-### Step 5 — 安装依赖
-
-1. 先 `pnpm ping` 检测 registry 连通性：
-   - 连不上（超时/报错）→ 跳过自动安装，提示 `网络不通，依赖未自动安装，请手动执行: pnpm install --dir <projectDir>`。
-   - 连通 → 进入下一步。
-2. `pnpm install --dir "<projectDir>"`（**禁用 `cd`** 进入项目目录，必须用 `--dir`）。若 `<projectDir>` 位于某个 pnpm workspace 内（向上能找到 `pnpm-workspace.yaml`），改用 `pnpm install --dir "<projectDir>" --ignore-workspace` 做独立安装。
-3. **必须实时透传 pnpm 输出**（进度条、日志），不得静默执行。安装失败 → 如实报告 stderr，不谎报成功；骨架已生成，用户可手动重跑。
-
-### Step 6 — 写入项目索引
-
-CLI 0.0.4-alpha.0 已在 `~/.ep-stage/projects.index.json5` 的 `projects[]` 数组末尾追加本项目条目（字段精简，含 `stageCreateVersion`，**不含** `envPath/stageContextPath/knowledgeRoot/codeListPaths`）。Agent 校验：
-
-- 文件存在
-- 末尾条目 `projectDir` 与本次创建一致
-- 字段含 `projectName / projectDir / mode='glue' / createdAt / stageCreateVersion / requirements=[]`
-
-JSON5 项目条目范例（CLI 自动写）：
-
-```json5
-// ~/.ep-stage/projects.index.json5 项目条目范例（CLI 自动写，无 stageContextPath/envPath/knowledgeRoot）
-{
-  projectName: '<projectName>',
-  projectDir: '<绝对路径>',
-  mode: 'glue',
-  createdAt: '2026-06-25T...',
-  stageCreateVersion: '0.0.4-alpha.0',
-  requirements: [],
-}
-```
-
-条目缺失 → 提示"索引文件未登记本项目，后续 ep-stage skills/CLI 无法发现，请检查 stage-create CLI 版本（应 ≥ 0.0.4-alpha.0）"。
-
-### Step 7 — 输出摘要
-
-打印全勾选终态任务清单 + §5 精简完成提示。成功摘要只保留项目路径与下一步链路指令；产物校验、调用方式、模式、依赖安装细节只在失败或排障时说明，不进入成功摘要。
-
-## 3. 错误处理
-
-| CLI 错误（原文）                  | 触发时机    | Agent 中文呈现 + 建议                                                                                                |
-|-----------------------------------|-------------|----------------------------------------------------------------------------------------------------------------------|
-| `目录已存在: <path>` (exit 1)     | Step 3 前置 | "目录 `<path>` 已存在。我不会主动删除任何已存在目录。" → AskUserQuestion 三选一：换名重来 / 改 cwd / 取消              |
-| npm `404 / ENOTFOUND / ETIMEDOUT` | npx 拉包失败 | "无法从 npm 拉取 @epoint-testtech/stage-create" → 建议 ① 检查网络 ② `npm config get registry` ③ `npm i -g` 预装        |
-| 其他 exit !== 0                   | CLI 崩溃    | 把 stderr 原文中文转述并贴出，建议复制错误私聊开发                                                                   |
-
-**半成品回滚**：CLI 在校验失败时（目录已存在）在 `mkdirSync` 之前退出，无副作用。若 CLI 已 `mkdirSync` 后中途崩，Agent **不主动 `rm`**，提示用户手动检查 `<path>` 后决定是否 `rm -rf` 重试。理由：cwd 不一定可信，盲删可能误伤。
-
-**用户中途取消**：AskUserQuestion 阶段等待不超时；自然对话阶段说「算了/取消/stop」立即终止不调 CLI；已调 CLI 后用户取消 → CLI 无中途取消信号，等 CLI 退出后再复述结果。
-
-## 4. 验证清单
-
-CLI 退出后必须用 `ls` / `Read` 校验产物。验证失败视为整体失败，不要谎报成功。
-
-| 路径                                | 说明                          |
-|-------------------------------------|-------------------------------|
-| `<projectDir>/package.json`         | 模板渲染产出                  |
-| `<projectDir>/playwright.config.ts` | Playwright 基础配置           |
-| `<projectDir>/tsconfig.json`        | TS 配置                       |
-| `<projectDir>/src/skeletons/`       | 业务骨架目录（非空）          |
-| `<projectDir>/src/web/component/`   | 页面组件目录                  |
-| `<projectDir>/src/report/`          | 报告辅助目录                  |
-| `~/.ep-stage/projects.index.json5`  | 用户级索引，应新增本项目条目  |
-
-> **不再校验** `<projectDir>/.env`（CLI 不再写）和 `<projectDir>/stage-context.md`（CLI 不再写，元信息已沉到 projects.index.json5）。
-
-**不验证什么**：模板占位符 `{{projectName}}` 是否替换（已由 stage-create prepublish 校验）；业务系统登录配置（中性化后不再涉及）。
-
-## 5. 完成提示
-
-Step 7 验证与依赖安装都通过后，按以下中文格式呈现结果。不要用英文 success/done/created：
-
-```markdown
-**创建胶水测试项目任务清单**
-
-- [x] 第 1 步 — 抽取项目名与落点
-- [x] 第 2 步 — 补齐核心参数（含 cwd 确认）
-- [x] 第 3 步 — 调用脚手架 CLI
-- [x] 第 4 步 — 验证脚手架产物
-- [x] 第 5 步 — 安装依赖
-- [x] 第 6 步 — 写入项目索引
-- [x] 第 7 步 — 输出摘要
-
-1. 项目路径：`<projectDir 绝对路径>`
-2. 下一步指令：对某需求跑 `/glue-generate-testcase <需求目录下的 code_list.json5 路径>` 生成用例
-```
-
-其中“下一步指令”是 `glue-create-project` 到 `glue-generate-testcase` 的上下游链路承接入口，必须保留并靠前呈现。
-
-成功摘要中不要再列出以下细节：
-
-- 模式：本 skill 固定胶水模式，成功摘要无需重复。
-- 调用方式：`--debug` / npx 仅在排障时说明，成功摘要无需重复。
-- 产物校验明细：验证失败时报告，成功摘要无需列清单。
-- 依赖安装明细：失败或跳过时报告，成功摘要无需列耗时和包数。
-- 索引登记明细：索引缺失时报告；成功摘要无需展开 `~/.ep-stage/projects.index.json5`。
-
-**失败时不要发完成提示**：第 4 节任一验证项失败或依赖安装失败 → 按 §3 报告，不允许在失败信息里混合"项目创建完成"字样。
-
-## 6. 引导场景
-
-- **A（缺脚手架）**：N/A — 本 skill 本身即建脚手架的入口，不存在"缺脚手架"前置。
-- **其他**：cwd 是 git 仓库根 → Step 2 二次确认；中文目录名 → Step 2 建议改 kebab-case。
+---
+name: glue-create-project
+description: 使用时机：当用户表达「创建胶水项目 / 测试脚手架 / 新建 glue 项目」或显式触发 `/glue-create-project [名称或路径]` 时使用。本 skill 只创建胶水模式（glue）Playwright 测试脚手架，不收集登录信息，不写 .env / stage-context.md。
+version: 2026-07-01+1e1ed4d
+argument-hint: "<脚手架项目名或脚手架项目路径>"
+---
+
+# ep-stage: glue-create-project
+
+本 skill 引导 Agent **包装** `@epoint-testtech/stage-create` CLI 的 glue 模式，不重新实现脚手架。用户视角全中文，不暴露 CLI 名称。
+
+> CLI 自 0.0.4-alpha.0 起已中性化：不再收集业务系统登录信息，不再写 `<projectDir>/.env`，也不再写 `<projectDir>/stage-context.md`。项目元信息全部沉到 `~/.ep-stage/projects.index.json5`（含 `stageCreateVersion`）。登录凭据由下游 `glue-generate-testcase` / `glue-run-test` 在需求级 `credentials.json5` 中收集。
+
+## 1. 自然语言映射规则
+
+用户在 Claude Code / Codex 里触发 skill 的典型形式：
+
+```text
+/glue-create-project my-project              # 裸名 → 落 <pwd>/e2e-test/my-project
+/glue-create-project path/my-project         # 含 / → 原样落点
+/glue-create-project /abs/path/my-project    # 绝对路径 → 原样落点
+/glue-create-project                         # 无参数 → 问项目名
+/glue-create-project my-project --debug      # 调试模式 → 跑本地 monorepo 的 stage-create dist
+```
+
+> **`--debug` flag**：正常调用走远程 `npx @epoint-testtech/stage-create@latest`。开发期想测试未发布的本地代码时传 `--debug`，skill 在 Step 3 改用 `node <repo>/packages/stage-create/dist/index.js`。前提：cwd 在 ep-stage monorepo 内（向上能找到 `pnpm-workspace.yaml`）；找不到时直接 exit 1 报错，不静默 fallback 到 npx。
+
+### 1.1 目标位置与项目名（路径解析三段式）
+
+CLI 接收 `[project-name]` 参数，内部用 `path.basename` 取项目名、`path.resolve` 取输出目录（基于 Agent cwd）：
+
+| 用户输入                                    | skill 传给 CLI 的值                         | 最终落点                                |
+|---------------------------------------------|---------------------------------------------|-----------------------------------------|
+| 含 `/` 或绝对路径                           | 原样透传                                    | `<cwd>/...` 或绝对路径；项目名取 basename |
+| 裸名（无 `/`）                              | 拼成 `e2e-test/<name>`                      | `<cwd>/e2e-test/<name>`                 |
+| 无参数                                      | 先问 `<name>`，再拼 `e2e-test/<name>`        | `<cwd>/e2e-test/<name>`                 |
+
+**逃生口**：想在当前 cwd 根直接建裸名（不进 `e2e-test/`），用 `./my-project`（含 `/`）。
+
+中文目录名 macOS/Linux 能建，但 npm scope 校验和跨平台兼容差。Agent 收到中文名时，AskUserQuestion 二选一：保留中文 / 换 kebab-case 建议（如 `我的项目` → `my-project`）。
+
+### 1.2 模式 — 固定 glue
+
+本 skill 只创建 glue 项目，固定传 `--mode glue`，不暴露 default 模式入口。
+
+### 1.3 工作目录 (cwd) 确认
+
+Agent 在调用 CLI 前必须：跑 `pwd` → 按 §1.1 算最终落点 → 中文复述"将在 `<最终落点>` 下创建项目，确认吗？" → 用户否认 → 让用户给绝对路径或先 `cd` 切换。
+
+典型陷阱：cwd 是 git 仓库根（存在 `.git/`）时必须额外二次确认，避免污染该仓库工作树。
+
+## 2. Agent 执行剧本（7 步任务清单协议）
+
+**任务清单协议（REQ-UX-01）**：
+
+- 加载 skill 后**立即**打印初始任务清单（Step 0）。
+- 每完成一步，输出单行状态更新 `第 N 步 — <中文名> 已完成，进入第 N+1 步 — <下一中文名>...`（不重写完整清单）。
+- Step 7 输出全勾选终态清单 + 完成摘要。
+
+### Step 0 — 打印任务清单
+
+```markdown
+**创建胶水测试项目任务清单**
+
+- [ ] 第 1 步 — 抽取项目名与落点
+- [ ] 第 2 步 — 补齐核心参数（含 cwd 确认）
+- [ ] 第 3 步 — 调用脚手架 CLI
+- [ ] 第 4 步 — 验证脚手架产物
+- [ ] 第 5 步 — 安装依赖
+- [ ] 第 6 步 — 写入项目索引
+- [ ] 第 7 步 — 输出摘要
+```
+
+### Step 1 — 抽取项目名与落点
+
+从用户原始消息 / args 抽取目标路径/项目名（规则见 §1）。模式固定 glue。中文复述识别结果：
+
+> 已识别：项目名 = `xxx`，模式 = `胶水模式 (glue)`，落点 = `<pwd>/e2e-test/xxx`。
+
+识别失败/不确定 → Step 2 补齐。
+
+### Step 2 — 补齐核心参数（含 cwd 确认）
+
+只在缺失/有疑时触发，全中文：
+
+- 缺 `projectName`（无参数）→ free text 询问"请告诉我新项目的名称"，按 §1.1 拼 `e2e-test/<name>`。
+- 中文项目名 → AskUserQuestion 二选一：保留中文 / 换 `<kebab-case 建议>`。
+- cwd 是 git 仓库根 → AskUserQuestion 二选一：在此 cwd 创建 / 取消并手动 cd。
+
+> 本 skill 固定 glue 模式，不再收集登录信息，无需就模式或登录配置询问。
+
+### Step 3 — 调用脚手架 CLI
+
+固定流程（不 which、不扫 monorepo、不 cd 进项目、**不喂 stdin**）。`<targetPath>` 由 §1.1 算出。
+
+**正常模式**（用户 args 无 `--debug`）：
+
+```bash
+npx -y @epoint-testtech/stage-create@latest "<targetPath>" --mode glue
+```
+
+**调试模式**（用户 args 含 `--debug`，要求 cwd 在 ep-stage monorepo 内；详见 §1 `--debug` flag 说明）：
+
+```bash
+D="$PWD"; REPO=""
+while [ "$D" != "/" ]; do
+  if [ -f "$D/pnpm-workspace.yaml" ] && [ -f "$D/packages/stage-create/dist/index.js" ]; then
+    REPO="$D"; break
+  fi
+  D="$(dirname "$D")"
+done
+[ -z "$REPO" ] && { echo "错误：--debug 但找不到本地 monorepo（需 cwd 在 ep-stage 仓库内向上能找到 pnpm-workspace.yaml + packages/stage-create/dist/index.js）"; exit 1; }
+echo "调试模式：本地 $REPO/packages/stage-create/dist/index.js"
+node "$REPO/packages/stage-create/dist/index.js" "<targetPath>" --mode glue
+```
+
+CLI 中性化后**不读 stdin**，不询问登录 URL / 用户名 / 密码 / 知识库根。
+
+### Step 4 — 验证脚手架产物
+
+按 §4 验证产物。验证失败 → §3 错误处理报告，不发完成提示。
+
+### Step 5 — 安装依赖
+
+1. 先 `pnpm ping` 检测 registry 连通性：
+   - 连不上（超时/报错）→ 跳过自动安装，提示 `网络不通，依赖未自动安装，请手动执行: pnpm install --dir <projectDir>`。
+   - 连通 → 进入下一步。
+2. `pnpm install --dir "<projectDir>"`（**禁用 `cd`** 进入项目目录，必须用 `--dir`）。若 `<projectDir>` 位于某个 pnpm workspace 内（向上能找到 `pnpm-workspace.yaml`），改用 `pnpm install --dir "<projectDir>" --ignore-workspace` 做独立安装。
+3. **必须实时透传 pnpm 输出**（进度条、日志），不得静默执行。安装失败 → 如实报告 stderr，不谎报成功；骨架已生成，用户可手动重跑。
+
+### Step 6 — 写入项目索引
+
+CLI 0.0.4-alpha.0 已在 `~/.ep-stage/projects.index.json5` 的 `projects[]` 数组末尾追加本项目条目（字段精简，含 `stageCreateVersion`，**不含** `envPath/stageContextPath/knowledgeRoot/codeListPaths`）。Agent 校验：
+
+- 文件存在
+- 末尾条目 `projectDir` 与本次创建一致
+- 字段含 `projectName / projectDir / mode='glue' / createdAt / stageCreateVersion / requirements=[]`
+
+JSON5 项目条目范例（CLI 自动写）：
+
+```json5
+// ~/.ep-stage/projects.index.json5 项目条目范例（CLI 自动写，无 stageContextPath/envPath/knowledgeRoot）
+{
+  projectName: '<projectName>',
+  projectDir: '<绝对路径>',
+  mode: 'glue',
+  createdAt: '2026-06-25T...',
+  stageCreateVersion: '0.0.4-alpha.0',
+  requirements: [],
+}
+```
+
+条目缺失 → 提示"索引文件未登记本项目，后续 ep-stage skills/CLI 无法发现，请检查 stage-create CLI 版本（应 ≥ 0.0.4-alpha.0）"。
+
+### Step 7 — 输出摘要
+
+打印全勾选终态任务清单 + §5 精简完成提示。成功摘要只保留项目路径与下一步链路指令；产物校验、调用方式、模式、依赖安装细节只在失败或排障时说明，不进入成功摘要。
+
+## 3. 错误处理
+
+| CLI 错误（原文）                  | 触发时机    | Agent 中文呈现 + 建议                                                                                                |
+|-----------------------------------|-------------|----------------------------------------------------------------------------------------------------------------------|
+| `目录已存在: <path>` (exit 1)     | Step 3 前置 | "目录 `<path>` 已存在。我不会主动删除任何已存在目录。" → AskUserQuestion 三选一：换名重来 / 改 cwd / 取消              |
+| npm `404 / ENOTFOUND / ETIMEDOUT` | npx 拉包失败 | "无法从 npm 拉取 @epoint-testtech/stage-create" → 建议 ① 检查网络 ② `npm config get registry` ③ `npm i -g` 预装        |
+| 其他 exit !== 0                   | CLI 崩溃    | 把 stderr 原文中文转述并贴出，建议复制错误私聊开发                                                                   |
+
+**半成品回滚**：CLI 在校验失败时（目录已存在）在 `mkdirSync` 之前退出，无副作用。若 CLI 已 `mkdirSync` 后中途崩，Agent **不主动 `rm`**，提示用户手动检查 `<path>` 后决定是否 `rm -rf` 重试。理由：cwd 不一定可信，盲删可能误伤。
+
+**用户中途取消**：AskUserQuestion 阶段等待不超时；自然对话阶段说「算了/取消/stop」立即终止不调 CLI；已调 CLI 后用户取消 → CLI 无中途取消信号，等 CLI 退出后再复述结果。
+
+## 4. 验证清单
+
+CLI 退出后必须用 `ls` / `Read` 校验产物。验证失败视为整体失败，不要谎报成功。
+
+| 路径                                | 说明                          |
+|-------------------------------------|-------------------------------|
+| `<projectDir>/package.json`         | 模板渲染产出                  |
+| `<projectDir>/playwright.config.ts` | Playwright 基础配置           |
+| `<projectDir>/tsconfig.json`        | TS 配置                       |
+| `<projectDir>/src/skeletons/`       | 业务骨架目录（非空）          |
+| `<projectDir>/src/web/component/`   | 页面组件目录                  |
+| `<projectDir>/src/report/`          | 报告辅助目录                  |
+| `~/.ep-stage/projects.index.json5`  | 用户级索引，应新增本项目条目  |
+
+> **不再校验** `<projectDir>/.env`（CLI 不再写）和 `<projectDir>/stage-context.md`（CLI 不再写，元信息已沉到 projects.index.json5）。
+
+**不验证什么**：模板占位符 `{{projectName}}` 是否替换（已由 stage-create prepublish 校验）；业务系统登录配置（中性化后不再涉及）。
+
+## 5. 完成提示
+
+Step 7 验证与依赖安装都通过后，按以下中文格式呈现结果。不要用英文 success/done/created：
+
+```markdown
+**创建胶水测试项目任务清单**
+
+- [x] 第 1 步 — 抽取项目名与落点
+- [x] 第 2 步 — 补齐核心参数（含 cwd 确认）
+- [x] 第 3 步 — 调用脚手架 CLI
+- [x] 第 4 步 — 验证脚手架产物
+- [x] 第 5 步 — 安装依赖
+- [x] 第 6 步 — 写入项目索引
+- [x] 第 7 步 — 输出摘要
+
+1. 项目路径：`<projectDir 绝对路径>`
+2. 下一步指令：对某需求跑 `/glue-generate-testcase <需求目录下的 code_list.json5 路径>` 生成用例
+```
+
+其中“下一步指令”是 `glue-create-project` 到 `glue-generate-testcase` 的上下游链路承接入口，必须保留并靠前呈现。
+
+成功摘要中不要再列出以下细节：
+
+- 模式：本 skill 固定胶水模式，成功摘要无需重复。
+- 调用方式：`--debug` / npx 仅在排障时说明，成功摘要无需重复。
+- 产物校验明细：验证失败时报告，成功摘要无需列清单。
+- 依赖安装明细：失败或跳过时报告，成功摘要无需列耗时和包数。
+- 索引登记明细：索引缺失时报告；成功摘要无需展开 `~/.ep-stage/projects.index.json5`。
+
+**失败时不要发完成提示**：第 4 节任一验证项失败或依赖安装失败 → 按 §3 报告，不允许在失败信息里混合"项目创建完成"字样。
+
+## 6. 引导场景
+
+- **A（缺脚手架）**：N/A — 本 skill 本身即建脚手架的入口，不存在"缺脚手架"前置。
+- **其他**：cwd 是 git 仓库根 → Step 2 二次确认；中文目录名 → Step 2 建议改 kebab-case。