csspilot 0.3.1 → 0.4.0

package/dist/index.js

@@ -10449,8 +10449,8 @@ function makeCiCommand() {
 }
 
 // src/commands/init/doctor.ts
-import { existsSync as existsSync6 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync7 } from "node:fs";
+import { join as join22 } from "node:path";
 
 // ../../packages/core/src/errors/index.ts
 var TestPilotError = class extends Error {
@@ -30183,7 +30183,17 @@ var configSchema = external_exports.strictObject({
     cliPath: external_exports.string().min(1).optional()
   }).optional()
 });
+function interpolateEnvRefs(value) {
+  return value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (match, name) => process.env[name] ?? match);
+}
+function loadProjectEnvFile(root = process.cwd()) {
+  try {
+    process.loadEnvFile(join3(root, ".env"));
+  } catch {
+  }
+}
 async function loadTestpilotConfig(cwd = process.cwd()) {
+  loadProjectEnvFile(cwd);
   const file2 = join3(cwd, "testpilot.yaml");
   let raw;
   try {
@@ -30199,19 +30209,44 @@ async function loadTestpilotConfig(cwd = process.cwd()) {
     const detail = result.error.issues.map((issue2) => `${issue2.path.map(String).join(".")}: ${issue2.message}`).join("; ");
     throw new Error(`testpilot.yaml \u914D\u7F6E\u4E0D\u5408\u6CD5:${detail}`);
   }
+  const parsed = result.data;
+  const environment = parsed.environment ? Object.fromEntries(
+    Object.entries(parsed.environment).map(([name, entry]) => {
+      if (name === "default" || typeof entry === "string") {
+        return [name, entry];
+      }
+      if (entry === void 0) {
+        return [name, void 0];
+      }
+      return [
+        name,
+        { baseUrl: entry.baseUrl === void 0 ? void 0 : interpolateEnvRefs(entry.baseUrl) }
+      ];
+    })
+  ) : void 0;
   return {
-    version: result.data.version,
+    version: parsed.version,
     // 用例目录:旧字段 casesDir 优先,其次 test.caseDirectory,最后默认值
-    casesDir: result.data.casesDir ?? result.data.test?.caseDirectory ?? DEFAULT_CASES_DIR,
-    testDirectory: result.data.test?.directory,
-    projectName: result.data.project?.name,
-    environment: result.data.environment,
-    adapters: result.data.adapters,
-    workspace: result.data.workspace,
-    server: result.data.server,
-    web: result.data.web,
-    api: result.data.api,
-    miniapp: result.data.miniapp
+    casesDir: parsed.casesDir ?? parsed.test?.caseDirectory ?? DEFAULT_CASES_DIR,
+    testDirectory: parsed.test?.directory,
+    projectName: parsed.project?.name,
+    environment,
+    adapters: parsed.adapters,
+    workspace: parsed.workspace,
+    server: parsed.server ? {
+      baseUrl: parsed.server.baseUrl === void 0 ? void 0 : interpolateEnvRefs(parsed.server.baseUrl)
+    } : void 0,
+    web: parsed.web ? {
+      baseUrl: parsed.web.baseUrl === void 0 ? void 0 : interpolateEnvRefs(parsed.web.baseUrl)
+    } : void 0,
+    api: parsed.api ? {
+      baseUrl: parsed.api.baseUrl === void 0 ? void 0 : interpolateEnvRefs(parsed.api.baseUrl),
+      timeoutMs: parsed.api.timeoutMs
+    } : void 0,
+    miniapp: parsed.miniapp ? {
+      projectPath: parsed.miniapp.projectPath === void 0 ? void 0 : interpolateEnvRefs(parsed.miniapp.projectPath),
+      cliPath: parsed.miniapp.cliPath === void 0 ? void 0 : interpolateEnvRefs(parsed.miniapp.cliPath)
+    } : void 0
   };
 }
 
@@ -32134,8 +32169,12 @@ async function collectEnvVarRefs(root) {
     return [];
   }
   const names = /* @__PURE__ */ new Set();
-  for (const match of text.matchAll(ENV_REF_PATTERN)) {
-    names.add(match[1]);
+  for (const line of text.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("#")) continue;
+    for (const match of trimmed.matchAll(ENV_REF_PATTERN)) {
+      names.add(match[1]);
+    }
   }
   return [...names].sort();
 }
@@ -32227,6 +32266,144 @@ function adaptersFor(type) {
   return ["playwright"];
 }
 
+// src/commands/init/skill-installer.ts
+import { existsSync as existsSync6, readFileSync as readFileSync3 } from "node:fs";
+import { access as access2, cp, mkdir as mkdir11, writeFile as writeFile9 } from "node:fs/promises";
+import { dirname as dirname7, join as join21 } from "node:path";
+import { fileURLToPath } from "node:url";
+var CORE_FILES = ["SKILL.md", "manifest.yaml"];
+var CORE_DIRS = ["rules", "workflows"];
+async function exists3(path) {
+  try {
+    await access2(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readManifestVersion(dir) {
+  const manifestPath = join21(dir, "manifest.yaml");
+  if (!existsSync6(manifestPath)) return void 0;
+  return /^version:\s*([^\s#]+)/m.exec(readFileSync3(manifestPath, "utf8"))?.[1];
+}
+function resolveSkillSourceDir() {
+  const fromEnv = process.env.TESTPILOT_SKILL_DIR;
+  if (fromEnv) return fromEnv;
+  const bundled = fileURLToPath(new URL("./skills/testpilot", import.meta.url));
+  if (existsSync6(bundled)) return bundled;
+  const inRepo = fileURLToPath(new URL("../../../../../skills/testpilot", import.meta.url));
+  return existsSync6(inRepo) ? inRepo : void 0;
+}
+async function copyCoreFiles(src, dest) {
+  for (const name of CORE_FILES) {
+    await cp(join21(src, name), join21(dest, name), { recursive: true, force: true });
+  }
+  for (const dir of CORE_DIRS) {
+    if (existsSync6(join21(src, dir))) {
+      await cp(join21(src, dir), join21(dest, dir), { recursive: true, force: true });
+    }
+  }
+}
+async function syncSkillFiles(root, options = {}) {
+  const dest = join21(root, ".agents", "skills", "testpilot");
+  const bundledVersion = readManifestVersion(resolveSkillSourceDir() ?? "");
+  if (!await exists3(join21(dest, "manifest.yaml"))) {
+    const src = resolveSkillSourceDir();
+    if (!src) {
+      throw new Error(
+        "\u65E0\u6CD5\u5B9A\u4F4D TestPilot Skill \u6E90\u76EE\u5F55;\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF TESTPILOT_SKILL_DIR \u6307\u5B9A skills/testpilot \u8DEF\u5F84"
+      );
+    }
+    await mkdir11(dirname7(dest), { recursive: true });
+    await cp(src, dest, { recursive: true });
+    return { core: "created", bundledVersion, dest };
+  }
+  const installedVersion = readManifestVersion(dest);
+  const bundled = resolveSkillSourceDir();
+  if (!bundled) {
+    return { core: "current", installedVersion, dest };
+  }
+  if (!options.force && installedVersion === bundledVersion) {
+    return { core: "current", installedVersion, bundledVersion, dest };
+  }
+  await copyCoreFiles(bundled, dest);
+  return {
+    core: "updated",
+    installedVersion,
+    bundledVersion,
+    dest
+  };
+}
+async function installSkill(root, info, adapters) {
+  const dest = join21(root, ".agents", "skills", "testpilot");
+  const sync = await syncSkillFiles(root);
+  const core = sync.core === "created" ? "created" : sync.core === "updated" ? "updated" : "reused";
+  const coreVersion = sync.core === "updated" || sync.core === "created" ? { from: sync.installedVersion, to: sync.bundledVersion } : void 0;
+  const config2 = await loadTestpilotConfig(root).catch(() => void 0);
+  const defaultEnvironment = typeof config2?.environment?.default === "string" ? config2.environment.default : "\u672A\u8BBE\u7F6E";
+  const defaultWorkspace = config2?.workspace?.default ?? "\u672A\u8BBE\u7F6E(\u53EF\u5728 yaml workspace.default \u914D\u7F6E)";
+  const refsDir = join21(dest, "references");
+  const files = [
+    ["project.md", () => renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace)],
+    ["test-conventions.md", renderTestConventionsMd],
+    ["adapters.md", () => renderAdaptersMd(adapters)]
+  ];
+  let references = "reused";
+  for (const [name, render] of files) {
+    const file2 = join21(refsDir, name);
+    if (await exists3(file2)) continue;
+    await mkdir11(refsDir, { recursive: true });
+    await writeFile9(file2, render(), "utf8");
+    references = "created";
+  }
+  return coreVersion ? { core, coreVersion, references, dest } : { core, references, dest };
+}
+function renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace) {
+  const available = adapters.filter((item) => item.available).map((item) => item.id);
+  return `# Project
+
+\u81EA\u52A8\u751F\u6210\u4E8E \`csspilot init\`,\u63CF\u8FF0\u672C\u9879\u76EE\u7684 TestPilot \u63A5\u5165\u4FE1\u606F;Agent \u4F18\u5148\u4ECE\u8FD9\u91CC\u4E86\u89E3\u9879\u76EE\u3002
+
+- Project name: ${info.name}
+- Project type: ${info.type}
+- Language: ${info.language}
+- Package manager: ${info.packageManager}
+- Test directory: tests/e2e
+- Case directory: tests/e2e/cases
+- Available adapters: ${available.length > 0 ? available.join(", ") : "(none detected)"}
+- Default environment: ${defaultEnvironment}
+- Default workspace: ${defaultWorkspace}
+`;
+}
+function renderTestConventionsMd() {
+  return `# Test Conventions
+
+\u672C\u9879\u76EE E2E \u6D4B\u8BD5\u7EA6\u5B9A,Agent \u751F\u6210/\u4FEE\u6539 Case \u65F6\u5FC5\u987B\u9075\u5B88:
+
+1. E2E Case \u4F4D\u4E8E tests/e2e/cases
+2. Case \u4F7F\u7528 TestPilot DSL
+3. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 Playwright
+4. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 WeChatIDE
+5. \u4E0D\u5141\u8BB8\u5728 Case \u4E2D\u5199\u660E\u6587\u5BC6\u7801(\u7528 accountRef \u5F15\u7528)
+6. \u4F18\u5148\u590D\u7528\u5DF2\u6709 Case
+7. \u65B0\u589E Case \u5FC5\u987B\u901A\u8FC7 csspilot validate
+8. Case ID \u5FC5\u987B\u552F\u4E00
+`;
+}
+function renderAdaptersMd(adapters) {
+  const lines = adapters.map(
+    (item) => `- ${item.id}: ${item.available ? "\u53EF\u7528" : "\u4E0D\u53EF\u7528"}${item.required ? "(\u9879\u76EE\u9700\u8981)" : "(\u53EF\u9009)"} \u2014 ${item.detail}`
+  );
+  return `# Adapters
+
+\u6267\u884C\u7AEF\u68C0\u6D4B\u7ED3\u679C(\u4EE5 \`csspilot doctor\` \u6700\u65B0\u8F93\u51FA\u4E3A\u51C6):
+
+${lines.join("\n")}
+
+Agent \u6C38\u8FDC\u4E0D\u76F4\u63A5\u64CD\u4F5C Adapter;Case \u7ECF Execution Engine \u8C03\u5EA6\u5230\u5BF9\u5E94 Adapter \u6267\u884C\u3002
+`;
+}
+
 // src/commands/init/doctor.ts
 async function runDoctor(root) {
   const sections = [];
@@ -32251,25 +32428,37 @@ async function runDoctor(root) {
   const projectItems = [
     ok(`Project ${info.name}(${info.type})`),
     info.git.commit ? ok(`Git repository(${info.git.branch ?? "detached"} \xB7 ${info.git.commit.slice(0, 7)})`) : warn("Git repository \u672A\u68C0\u6D4B\u5230", "Case Metadata \u65E0\u6CD5\u540C\u6B65\u5230 Server"),
-    existsSync6(join21(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
-    existsSync6(join21(root, "testpilot.yaml")) ? ok("testpilot.yaml") : error62("testpilot.yaml", "\u8FD0\u884C npx csspilot init \u751F\u6210")
+    existsSync7(join22(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
+    existsSync7(join22(root, "testpilot.yaml")) ? ok("testpilot.yaml") : error62("testpilot.yaml", "\u8FD0\u884C npx csspilot init \u751F\u6210")
   ];
   push("Project", projectItems);
   const config2 = await loadTestpilotConfig(root).catch(() => void 0);
   const casesDir = config2?.casesDir ?? "tests/e2e/cases";
-  const cases = await collectCases([join21(root, casesDir)], { root }).catch(() => []);
+  const cases = await collectCases([join22(root, casesDir)], { root }).catch(() => []);
   const invalidCount = cases.filter((item) => !item.valid).length;
-  const testDir = join21(root, "tests", "e2e");
+  const testDir = join22(root, "tests", "e2e");
   push("Test", [
-    existsSync6(testDir) ? ok("tests/e2e") : error62("tests/e2e", "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
-    existsSync6(join21(root, casesDir)) ? ok(`cases directory(${casesDir})`) : error62(`cases directory(${casesDir})`, "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
+    existsSync7(testDir) ? ok("tests/e2e") : error62("tests/e2e", "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
+    existsSync7(join22(root, casesDir)) ? ok(`cases directory(${casesDir})`) : error62(`cases directory(${casesDir})`, "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
     cases.length === 0 ? warn("Case validation \u8DF3\u8FC7(\u672A\u627E\u5230\u7528\u4F8B)", "\u5728 tests/e2e/cases \u521B\u5EFA Case") : invalidCount === 0 ? ok(`Case validation(${cases.length} \u4E2A\u7528\u4F8B\u5168\u90E8\u6709\u6548)`) : error62(`Case validation(${invalidCount}/${cases.length} \u4E2A\u7528\u4F8B\u6821\u9A8C\u5931\u8D25)`, "\u8FD0\u884C npx csspilot validate \u67E5\u770B\u8BE6\u60C5")
   ]);
-  const skillDir = join21(root, ".agents", "skills", "testpilot");
-  push("Agent", [
-    existsSync6(join21(skillDir, "manifest.yaml")) ? ok("TestPilot Skill(.agents/skills/testpilot)") : error62("TestPilot Skill", "\u8FD0\u884C npx csspilot init \u5B89\u88C5"),
-    existsSync6(join21(skillDir, "references", "project.md")) ? ok("Project testing guide(references/)") : warn("Project testing guide \u7F3A\u5931", "references/ \u7531 init \u751F\u6210;\u53EF\u91CD\u65B0\u8FD0\u884C npx csspilot init")
-  ]);
+  const skillDir = join22(root, ".agents", "skills", "testpilot");
+  const installedSkillVersion = readManifestVersion(skillDir);
+  const skillSource = resolveSkillSourceDir();
+  const bundledSkillVersion = skillSource ? readManifestVersion(skillSource) : void 0;
+  const skillItems = [
+    installedSkillVersion ? ok(`TestPilot Skill(.agents/skills/testpilot,v${installedSkillVersion})`) : error62("TestPilot Skill", "\u8FD0\u884C npx csspilot init \u5B89\u88C5"),
+    existsSync7(join22(skillDir, "references", "project.md")) ? ok("Project testing guide(references/)") : warn("Project testing guide \u7F3A\u5931", "references/ \u7531 init \u751F\u6210;\u53EF\u91CD\u65B0\u8FD0\u884C npx csspilot init")
+  ];
+  if (installedSkillVersion && bundledSkillVersion && installedSkillVersion !== bundledSkillVersion) {
+    skillItems.push(
+      warn(
+        `Skill \u53EF\u66F4\u65B0(v${installedSkillVersion} -> v${bundledSkillVersion})`,
+        "\u8FD0\u884C npx csspilot update \u5E76\u63D0\u4EA4 .agents/skills/ \u53D8\u66F4"
+      )
+    );
+  }
+  push("Agent", skillItems);
   const adapters = await detectAdapters(root, info.type);
   push(
     "Adapters",
@@ -32354,11 +32543,11 @@ function makeDoctorCommand() {
 import { join as join25 } from "node:path";
 
 // src/commands/init/config-initializer.ts
-import { access as access2, mkdir as mkdir11, writeFile as writeFile9 } from "node:fs/promises";
-import { basename as basename2, join as join22 } from "node:path";
-async function exists3(path) {
+import { access as access3, mkdir as mkdir12, readFile as readFile8, writeFile as writeFile10 } from "node:fs/promises";
+import { basename as basename2, join as join23 } from "node:path";
+async function exists4(path) {
   try {
-    await access2(path);
+    await access3(path);
     return true;
   } catch {
     return false;
@@ -32399,28 +32588,72 @@ ${adapters}
 # server:
 #   baseUrl: http://127.0.0.1:3000
 
-# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740
+# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740(\u6BCF\u4EBA\u7684\u5730\u5740\u4E0D\u540C,\u503C\u653E .env)
 # web:
-#   baseUrl: http://127.0.0.1:8080
+#   baseUrl: \${WEB_BASE_URL}
 
-# \u5C0F\u7A0B\u5E8F\u7AEF:\u586B\u5165\u5C0F\u7A0B\u5E8F\u9879\u76EE\u76EE\u5F55\u540E\u5373\u53EF\u6267\u884C target: miniapp \u7684\u6B65\u9AA4
+# \u5C0F\u7A0B\u5E8F\u7AEF:\u586B\u5165\u5C0F\u7A0B\u5E8F\u9879\u76EE\u76EE\u5F55\u540E\u5373\u53EF\u6267\u884C target: miniapp \u7684\u6B65\u9AA4(\u8DEF\u5F84\u6BCF\u4EBA\u4E0D\u540C,\u8D70 .env)
 # miniapp:
-#   projectPath: path/to/miniprogram
-#   cliPath: C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat
+#   projectPath: \${MINIAPP_PROJECT_PATH}
+#   cliPath: \${MINIAPP_CLI_PATH}
 `;
 }
+function renderDotEnvExample() {
+  return `# TestPilot \u73AF\u5883\u53D8\u91CF\u793A\u4F8B:\u590D\u5236\u4E3A .env \u5E76\u586B\u5165\u771F\u5B9E\u503C(.env \u542B\u654F\u611F\u4FE1\u606F,\u4E0D\u8981\u63D0\u4EA4\u5230 Git)
+# \u4F18\u5148\u7EA7:\u771F\u5B9E\u73AF\u5883\u53D8\u91CF > .env \u6587\u4EF6;testpilot.yaml \u4E2D\u7684 \${VAR} \u5F15\u7528\u8FD0\u884C\u65F6\u81EA\u52A8\u6CE8\u5165
+
+# \u73AF\u5883\u914D\u7F6E(environment \u6BB5)
+TEST_BASE_URL=http://127.0.0.1:8080
+STAGING_BASE_URL=https://staging.example.com
+
+# Web \u7AEF\u76F8\u5BF9 url \u7684\u57FA\u51C6(\u53D6\u6D88 testpilot.yaml \u4E2D web \u6BB5\u6CE8\u91CA\u540E\u751F\u6548)
+# WEB_BASE_URL=http://127.0.0.1:8080
+
+# \u5C0F\u7A0B\u5E8F\u7AEF(\u53D6\u6D88 testpilot.yaml \u4E2D miniapp \u6BB5\u6CE8\u91CA\u540E\u751F\u6548)
+# MINIAPP_PROJECT_PATH=path/to/miniprogram
+# MINIAPP_CLI_PATH=C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat
+
+# TestPilot Server(Control Plane,\u53EF\u9009)
+# TESTPILOT_SERVER_URL=http://127.0.0.1:3000
+`;
+}
+async function ensureGitignoreEntry(root, entry, comment = "TestPilot \u672C\u5730\u73AF\u5883\u53D8\u91CF") {
+  const gitignorePath = join23(root, ".gitignore");
+  if (!await exists4(gitignorePath)) {
+    await writeFile10(gitignorePath, `# ${comment}
+${entry}
+`, "utf8");
+    return "created";
+  }
+  const content = await readFile8(gitignorePath, "utf8");
+  if (content.split(/\r?\n/).some((item) => item.trim() === entry)) {
+    return "exists";
+  }
+  const separator = content.endsWith("\n") || content === "" ? "" : "\n";
+  await writeFile10(gitignorePath, `${content}${separator}# ${comment}
+${entry}
+`, "utf8");
+  return "updated";
+}
 async function initTestPilotConfig(root, info, adapters) {
-  const yamlPath = join22(root, "testpilot.yaml");
+  const yamlPath = join23(root, "testpilot.yaml");
   let yaml = "reused";
-  if (!await exists3(yamlPath)) {
-    await writeFile9(yamlPath, renderTestpilotYaml(info), "utf8");
+  if (!await exists4(yamlPath)) {
+    await writeFile10(yamlPath, renderTestpilotYaml(info), "utf8");
     yaml = "created";
   }
-  const runtimeDir = join22(root, ".testpilot", "artifacts");
-  await mkdir11(runtimeDir, { recursive: true });
-  const keep = join22(runtimeDir, ".gitkeep");
-  if (!await exists3(keep)) {
-    await writeFile9(keep, "", "utf8");
+  const envExamplePath = join23(root, ".env.example");
+  let envExample = "reused";
+  if (!await exists4(envExamplePath)) {
+    await writeFile10(envExamplePath, renderDotEnvExample(), "utf8");
+    envExample = "created";
+  }
+  const gitignore = await ensureGitignoreEntry(root, ".env");
+  const runtimeDir = join23(root, ".testpilot", "artifacts");
+  await mkdir12(runtimeDir, { recursive: true });
+  const keep = join23(runtimeDir, ".gitkeep");
+  if (!await exists4(keep)) {
+    await writeFile10(keep, "", "utf8");
   }
   const existing = await readProjectLink(root);
   const defaultAdapter = defaultAdapterFor(info.type);
@@ -32439,7 +32672,14 @@ async function initTestPilotConfig(root, info, adapters) {
   }
   if (link.serverUrl === void 0 && serverUrl) link.serverUrl = serverUrl;
   const projectLinkFile = await writeProjectLink(link, root);
-  return { yaml, runtimeDir: join22(root, ".testpilot"), projectLink: link, projectLinkFile };
+  return {
+    yaml,
+    runtimeDir: join23(root, ".testpilot"),
+    projectLink: link,
+    projectLinkFile,
+    envExample,
+    gitignore
+  };
 }
 async function createProjectOnServer(root, info, _adapters, serverUrl) {
   const git = info.git;
@@ -32468,106 +32708,6 @@ function randomId() {
   return Math.random().toString(16).slice(2, 10);
 }
 
-// src/commands/init/skill-installer.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { access as access3, cp, mkdir as mkdir12, writeFile as writeFile10 } from "node:fs/promises";
-import { dirname as dirname7, join as join23 } from "node:path";
-import { fileURLToPath } from "node:url";
-async function exists4(path) {
-  try {
-    await access3(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function resolveSkillSourceDir() {
-  const fromEnv = process.env.TESTPILOT_SKILL_DIR;
-  if (fromEnv) return fromEnv;
-  const bundled = fileURLToPath(new URL("./skills/testpilot", import.meta.url));
-  if (existsSync7(bundled)) return bundled;
-  const inRepo = fileURLToPath(new URL("../../../../../skills/testpilot", import.meta.url));
-  return existsSync7(inRepo) ? inRepo : void 0;
-}
-async function installSkill(root, info, adapters) {
-  const dest = join23(root, ".agents", "skills", "testpilot");
-  let core = "reused";
-  if (!await exists4(join23(dest, "manifest.yaml"))) {
-    const src = resolveSkillSourceDir();
-    if (!src) {
-      throw new Error(
-        "\u65E0\u6CD5\u5B9A\u4F4D TestPilot Skill \u6E90\u76EE\u5F55;\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF TESTPILOT_SKILL_DIR \u6307\u5B9A skills/testpilot \u8DEF\u5F84"
-      );
-    }
-    await mkdir12(dirname7(dest), { recursive: true });
-    await cp(src, dest, { recursive: true });
-    core = "created";
-  }
-  const config2 = await loadTestpilotConfig(root).catch(() => void 0);
-  const defaultEnvironment = typeof config2?.environment?.default === "string" ? config2.environment.default : "\u672A\u8BBE\u7F6E";
-  const defaultWorkspace = config2?.workspace?.default ?? "\u672A\u8BBE\u7F6E(\u53EF\u5728 yaml workspace.default \u914D\u7F6E)";
-  const refsDir = join23(dest, "references");
-  const files = [
-    ["project.md", () => renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace)],
-    ["test-conventions.md", renderTestConventionsMd],
-    ["adapters.md", () => renderAdaptersMd(adapters)]
-  ];
-  let references = "reused";
-  for (const [name, render] of files) {
-    const file2 = join23(refsDir, name);
-    if (await exists4(file2)) continue;
-    await mkdir12(refsDir, { recursive: true });
-    await writeFile10(file2, render(), "utf8");
-    references = "created";
-  }
-  return { core, references, dest };
-}
-function renderProjectMd(info, adapters, defaultEnvironment, defaultWorkspace) {
-  const available = adapters.filter((item) => item.available).map((item) => item.id);
-  return `# Project
-
-\u81EA\u52A8\u751F\u6210\u4E8E \`csspilot init\`,\u63CF\u8FF0\u672C\u9879\u76EE\u7684 TestPilot \u63A5\u5165\u4FE1\u606F;Agent \u4F18\u5148\u4ECE\u8FD9\u91CC\u4E86\u89E3\u9879\u76EE\u3002
-
-- Project name: ${info.name}
-- Project type: ${info.type}
-- Language: ${info.language}
-- Package manager: ${info.packageManager}
-- Test directory: tests/e2e
-- Case directory: tests/e2e/cases
-- Available adapters: ${available.length > 0 ? available.join(", ") : "(none detected)"}
-- Default environment: ${defaultEnvironment}
-- Default workspace: ${defaultWorkspace}
-`;
-}
-function renderTestConventionsMd() {
-  return `# Test Conventions
-
-\u672C\u9879\u76EE E2E \u6D4B\u8BD5\u7EA6\u5B9A,Agent \u751F\u6210/\u4FEE\u6539 Case \u65F6\u5FC5\u987B\u9075\u5B88:
-
-1. E2E Case \u4F4D\u4E8E tests/e2e/cases
-2. Case \u4F7F\u7528 TestPilot DSL
-3. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 Playwright
-4. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 WeChatIDE
-5. \u4E0D\u5141\u8BB8\u5728 Case \u4E2D\u5199\u660E\u6587\u5BC6\u7801(\u7528 accountRef \u5F15\u7528)
-6. \u4F18\u5148\u590D\u7528\u5DF2\u6709 Case
-7. \u65B0\u589E Case \u5FC5\u987B\u901A\u8FC7 csspilot validate
-8. Case ID \u5FC5\u987B\u552F\u4E00
-`;
-}
-function renderAdaptersMd(adapters) {
-  const lines = adapters.map(
-    (item) => `- ${item.id}: ${item.available ? "\u53EF\u7528" : "\u4E0D\u53EF\u7528"}${item.required ? "(\u9879\u76EE\u9700\u8981)" : "(\u53EF\u9009)"} \u2014 ${item.detail}`
-  );
-  return `# Adapters
-
-\u6267\u884C\u7AEF\u68C0\u6D4B\u7ED3\u679C(\u4EE5 \`csspilot doctor\` \u6700\u65B0\u8F93\u51FA\u4E3A\u51C6):
-
-${lines.join("\n")}
-
-Agent \u6C38\u8FDC\u4E0D\u76F4\u63A5\u64CD\u4F5C Adapter;Case \u7ECF Execution Engine \u8C03\u5EA6\u5230\u5BF9\u5E94 Adapter \u6267\u884C\u3002
-`;
-}
-
 // src/commands/init/test-structure.ts
 import { existsSync as existsSync8, readdirSync as readdirSync2 } from "node:fs";
 import { mkdir as mkdir13, writeFile as writeFile11 } from "node:fs/promises";
@@ -32625,6 +32765,12 @@ async function runInit(root, options = {}) {
   console.log(`\u2713 Runtime \u76EE\u5F55      ${join25(".testpilot", "artifacts")}`);
   const serverMode = config2.projectLink.serverUrl ? `Server:${config2.projectLink.serverUrl}` : "\u672C\u5730\u6A21\u5F0F";
   console.log(`\u2713 \u9879\u76EE\u5173\u8054          ${config2.projectLink.projectId}(${serverMode})`);
+  console.log(
+    config2.envExample === "created" ? "\u2713 \u73AF\u5883\u53D8\u91CF\u793A\u4F8B      .env.example(\u590D\u5236\u4E3A .env \u586B\u5165\u771F\u5B9E\u503C)" : "\u2713 \u73AF\u5883\u53D8\u91CF\u793A\u4F8B      .env.example(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
+  );
+  console.log(
+    config2.gitignore === "exists" ? "\u2713 Git \u5FFD\u7565          .env(\u5DF2\u5728 .gitignore)" : `\u2713 Git \u5FFD\u7565          .env(\u5DF2\u5199\u5165 .gitignore)`
+  );
   const testStructure = await initTestStructure(root, project);
   const reuseNote = project.existingE2eDirs.filter((dir) => dir !== "tests/e2e");
   console.log(
@@ -32634,9 +32780,15 @@ async function runInit(root, options = {}) {
     console.log(`  \u26A0 \u68C0\u6D4B\u5230\u5176\u4ED6 E2E \u76EE\u5F55:${reuseNote.join(", ")}(\u4FDD\u7559\u4E0D\u52A8,\u672A\u5F3A\u5236\u8FC1\u79FB)`);
   }
   const skill = await installSkill(root, project, adapters);
-  console.log(
-    skill.core === "created" ? `\u2713 Skill \u5B89\u88C5        ${join25(".agents", "skills", "testpilot")}` : "\u2713 Skill \u5B89\u88C5        .agents/skills/testpilot/(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)"
-  );
+  if (skill.core === "updated") {
+    console.log(
+      `\u2713 Skill \u66F4\u65B0        .agents/skills/testpilot/(v${skill.coreVersion?.from ?? "?"} -> v${skill.coreVersion?.to ?? "?"})`
+    );
+  } else {
+    console.log(
+      skill.core === "created" ? `\u2713 Skill \u5B89\u88C5        ${join25(".agents", "skills", "testpilot")}` : "\u2713 Skill \u5B89\u88C5        .agents/skills/testpilot/(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)"
+    );
+  }
   console.log(
     skill.references === "created" ? "\u2713 Agent \u4E0A\u4E0B\u6587      references/{project,test-conventions,adapters}.md" : "\u2713 Agent \u4E0A\u4E0B\u6587      references/(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
   );
@@ -32866,6 +33018,37 @@ function makeSyncMetadataCommand() {
   });
 }
 
+// src/commands/update.ts
+import { writeFile as writeFile12 } from "node:fs/promises";
+import { join as join27 } from "node:path";
+function makeUpdateCommand() {
+  const update = new Command("update").description("\u540C\u6B65 TestPilot \u63A5\u5165\u7269\u5230\u5F53\u524D CLI \u7248\u672C(Skill / .env.example;\u4E0D\u89E6\u78B0 .env \u4E0E\u7528\u4F8B)").option("--force", "Skill \u7248\u672C\u4E00\u81F4\u65F6\u4E5F\u5F3A\u5236\u8986\u76D6\u672C\u5730\u4FEE\u6539", false).action(async (options) => {
+    const root = process.cwd();
+    const dest = join27(".agents", "skills", "testpilot");
+    const skill = await syncSkillFiles(root, { force: options.force });
+    switch (skill.core) {
+      case "created":
+        console.log(`\u2713 Skill \u5B89\u88C5       ${dest}(v${skill.bundledVersion ?? "?"})`);
+        break;
+      case "updated":
+        console.log(
+          `\u2713 Skill \u66F4\u65B0       ${dest} v${skill.installedVersion ?? "?"} -> v${skill.bundledVersion ?? "?"}`
+        );
+        break;
+      default:
+        console.log(`\u2713 Skill \u5DF2\u662F\u6700\u65B0   v${skill.bundledVersion ?? "?"}`);
+    }
+    await writeFile12(join27(root, ".env.example"), renderDotEnvExample(), "utf8");
+    console.log("\u2713 .env.example     \u5DF2\u540C\u6B65\u4E3A\u5F53\u524D\u7248\u672C\u7684\u793A\u4F8B(.env \u4E0D\u53D7\u5F71\u54CD)");
+    const gitignore = await ensureGitignoreEntry(root, ".env");
+    console.log(
+      gitignore === "exists" ? "\u2713 .gitignore       \u5DF2\u5FFD\u7565 .env" : "\u2713 .gitignore       \u5DF2\u8FFD\u52A0\u5FFD\u7565 .env"
+    );
+    console.log("\u63D0\u793A:\u63D0\u4EA4 .agents/skills/ \u4E0E .env.example \u7684\u53D8\u66F4,\u56E2\u961F\u4E0E AI \u5373\u53EF\u4F7F\u7528\u6700\u65B0\u80FD\u529B");
+  });
+  return update;
+}
+
 // src/commands/validate.ts
 function makeValidateCommand() {
   return new Command("validate").description("\u6821\u9A8C\u7528\u4F8B DSL").argument("[paths...]", "\u7528\u4F8B\u6587\u4EF6\u6216\u76EE\u5F55,\u9ED8\u8BA4\u6309\u9879\u76EE\u914D\u7F6E").action(async (paths) => {
@@ -32902,10 +33085,10 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.3.1";
+var CLI_VERSION = "0.4.0";
 async function createCli() {
   const program2 = new Command();
-  program2.name("csspilot").description("TestPilot \u2014 AI Native \u8DE8\u7AEF\u4E1A\u52A1\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD CLI").version(CLI_VERSION).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeCiCommand());
+  program2.name("csspilot").description("TestPilot \u2014 AI Native \u8DE8\u7AEF\u4E1A\u52A1\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD CLI").version(CLI_VERSION).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeUpdateCommand()).addCommand(makeCiCommand());
   return program2;
 }
 export {

package/dist/skills/testpilot/SKILL.md

@@ -12,6 +12,7 @@ TestPilot is a **tool, not a business test project**. Business cases always belo
 
 Use TestPilot when the user wants to:
 
+- review test requirements for testability
 - create business test cases
 - validate test cases
 - run tests
@@ -20,12 +21,13 @@ Use TestPilot when the user wants to:
 ## Core workflow
 
 1. Understand user requirement
-2. Inspect project
-3. Identify test target
-4. Create TestPilot Case (`tests/e2e/cases/*.yaml`)
-5. Validate Case (`npx csspilot validate`)
-6. Run Case (`npx csspilot run`)
-7. Analyze result (`npx csspilot report`)
+2. Review requirements & produce test points (`workflows/test-requirements-review.md`)
+3. Inspect project
+4. Identify test target
+5. Create TestPilot Case (`tests/e2e/cases/*.yaml`, linked to test point IDs)
+6. Validate Case (`npx csspilot validate`)
+7. Run Case (`npx csspilot run`)
+8. Analyze result (`npx csspilot report`)
 
 ## Important rules
 
@@ -72,4 +74,5 @@ Read `references/` first (generated by `csspilot init` for this project):
 - `rules/dsl.md` — case structure and the V0.1 action set
 - `rules/locator.md` — locator forms and the no-invention rule
 - `rules/assertion.md` — assertions and variable references
-- `workflows/` — step-by-step workflows (create / validate / run / analyze)
+- `workflows/test-requirements-review.md` — requirements review, test point checklist
+- `workflows/` — step-by-step workflows (review / create / validate / run / analyze)

package/dist/skills/testpilot/manifest.yaml

@@ -2,12 +2,13 @@
 # `npx csspilot init` 会把整个 skills/testpilot/ 安装到业务项目 .agents/skills/testpilot/
 id: testpilot
 name: TestPilot
-version: 0.2.0
+version: 0.4.0
 
 description: >
   AI Native cross-platform testing skill.
 
 capabilities:
+  - test-requirements-review
   - create-case
   - validate
   - run
@@ -37,4 +38,4 @@ permissions:
       - npx
       - pnpm
       - npm
-      - testpilot
+      - csspilot