retest-generator（复测工具生成器）

为已由 AI 验证成功的技能功能，在目标技能目录下生成一键复测脚本 + 使用文档，让用户之后无需 AI 即可独立复现该测试。

核心理念

AI 测试消耗算力 = 花钱。 已验证成功的测试流程，应固化成用户可独立运行的脚本，避免重复消耗 AI 算力。

触发条件

当用户在以下情境中调用本技能：

用户与 AI 已在当前对话中成功测试了某技能的某功能
用户希望之后能独立复现该测试，不再依赖 AI

典型触发语：

"为 coze-caller 生成复测工具"
"生成手动测试脚本"
"我要手动复测 XX 技能"
"把这个测试过程固化成脚本"

AI 行为规范（关键）

生成依据优先级（严格按序）

第一优先：当前对话中已成功测试的真实过程（黄金蓝本）
- AI 实际执行的命令链
- 实际传入的参数格式
- 实际得到的输出（session_id、chat_id、status、content 等）
- 测试中踩过的坑、修正过的问题（如 JSON 输出在 stderr、路径必须绝对等）
- 四步流程的真实串联逻辑
第二优先：目标技能的 SKILL.md 和参考文档
- 补充参数定义、边界条件、异常处理
- 确认脚本路径、配置文件位置
第三优先：已验证的成熟范式
- spawnSync 调用封装脚本（非 execSync）
- 合并 stdout + stderr 后用 indexOf('{') ~ lastIndexOf('}') 提取 JSON
- ESM 语法（import，配合 "type": "module"）
- 轮询逻辑用 await sleep(interval * 1000)

⚠️ 强制要求：AI 生成脚本前，必须先回顾当前对话中与目标技能相关的成功测试过程。禁止仅凭技能文档凭空推导，因为文档不会记录实际运行时的细节坑点。

执行流程

步骤 1：识别目标技能和功能

从用户请求中识别：

目标技能名：如 coze-caller
要复测的功能：如"智能体调用"、"工作流执行"

步骤 2：回顾测试上下文

AI 回顾当前对话中：

测试该功能时执行了哪些命令？
每步的输入参数从哪里来（配置文件 / 上一步输出 / 用户输入）？
每步的输出字段是什么？传给下一步哪个参数？
遇到了什么问题？如何修正的？
涉及异步吗？轮询逻辑是什么？

步骤 3：读取目标技能文档（补充）

读取以下文件补充细节：

$SKILL_DIR/SKILL.md（目标技能的技能说明）
$SKILL_DIR/references/ 下的相关参考文档
$SKILL_DIR/config/ 下的配置文件结构
$SKILL_DIR/.env 的配置项（如轮询间隔）

步骤 4：在目标技能目录下生成文件

输出位置： 目标技能/手动测试技能/

生成以下 3 个文件：

4.1 `retest.js`（一键复测脚本）

必须包含：

命令行参数解析（如 node retest.js "今天天气怎么样？"）
路径定义（基于 __dirname 推导目标技能的 scripts、temp、config 目录）
工具函数：extractJson、runScript（spawnSync + 合并 stdout/stderr）、parseEnv
主流程：按测试顺序串联封装脚本，自动传递中间参数
轮询逻辑（若涉及异步状态查询）
清晰的步骤输出（▶ 第 N 步 / ✓ 输出 xxx）
错误处理（exit 1 + 友好错误信息）

代码范式（必须沿用）：

import { spawnSync } from "node:child_process";
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
import { dirname, join, resolve } from "node:path";
import { fileURLToPath } from "node:url";

const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);

// 目标技能根目录（手动测试技能 的上一级）
const SKILL_DIR = resolve(__dirname, "..");
const SCRIPTS_DIR = join(SKILL_DIR, "scripts");

// 从脚本输出提取 JSON（封装脚本可能把 JSON 输出到 stderr）
function extractJson(text) {
  const start = text.indexOf("{");
  const end = text.lastIndexOf("}");
  if (start === -1 || end === -1 || end < start) {
    throw new Error("脚本输出中未找到 JSON：\n" + text);
  }
  return JSON.parse(text.slice(start, end + 1));
}

// 用 spawnSync 调用封装脚本，合并 stdout+stderr
function runScript(args, label) {
  console.log(`\n▶ ${label}`);
  const r = spawnSync("node", args, { cwd: SCRIPTS_DIR, encoding: "utf-8" });
  if (r.status !== 0) {
    throw new Error(
      `脚本执行失败（exit ${r.status}）：\n${r.stdout || ""}${r.stderr || ""}`,
    );
  }
  const combined = `${r.stdout || ""}\n${r.stderr || ""}`;
  return extractJson(combined);
}

4.2 `使用文档.md`

必须包含：

文件清单
前置条件
快速使用（3 步：编辑输入 → 运行 → 查看结果）
四步流程详解（每步的输入参数表格 + 输出参数表格 + 实际命令）
完整运行示例
常见问题表格

4.3 `package.json`

{
  "type": "module"
}

步骤 5：告知用户使用方式

生成完成后，向用户说明：

文件生成位置
如何运行复测脚本（给出具体命令示例）
如何更换测试输入

命名规范

脚本名统一用 retest.js（若目标技能已有该文件则覆盖，因为用户调用本技能意味着要更新复测工具）
文档名统一用 使用文档.md
配置文件根据功能需要命名（如 question.txt、input.json 等）

重要约束

禁止凭空推导：必须基于当前对话的真实测试过程生成脚本
禁止直接调用目标技能的 HTTP API：复测脚本必须通过目标技能的封装脚本调用
所有路径用绝对路径：临时文件放在目标技能的 scripts/temp/ 下
沿用成熟范式：spawnSync + 合并 stdout/stderr + extractJson，避免重复踩坑
ESM 语法：与目标技能 scripts 目录风格一致
不判断技能是否已验证：这是用户自己的责任，用户只会在测试成功后才调用本技能

retest-generator