待完善的自测版本、上传上来只是方便多项目自测

web-debug-skill

专为各大主流 AI 编辑器助手（如 Trae, Cursor, Windsurf 等）打造的前端自动化测试与链路追踪专属技能 (AI Skill)。

🎯 核心目的：触发 AI 自动化测试

当前端业务逻辑复杂时，排查问题往往需要编写测试、配置 Babel、引入 Istanbul 并在代码中插桩。

web-debug-skill 的核心目的就是为 AI 助手提供了一个“零侵入”的沙盒环境，使得 AI 能够在一个指令下：

1. 自动分析你的代码并生成测试用例。
2. 在不修改你项目 package.json 的前提下，自动挂载内置的 Babel 与 Mocha。
3. 执行无埋点插桩测试，并为你输出精美的 Markdown 测试报告与链路覆盖率。

🚀 快速开始：给你的 AI 助手装备该技能

只需要两步，即可让你的 AI 助手掌握强大的自动化测试能力。我们推荐您将其作为项目的开发依赖安装，以获得极致的响应速度并支持离线执行。

1. 安装与初始化技能 (Skill 注入)

方案 A：作为项目开发依赖安装（推荐，极速响应，支持离线） 将工具安装到你的项目中。由于我们在 package.json 中配置了 postinstall 钩子，在执行 npm install 完成后，会自动弹出交互式菜单引导您完成技能注入，无需再手动执行 npx：

npm install web-debug-skill --save-dev

方案 B：免安装直接运行（适合临时体验） 如果您不想污染项目的 package.json，可以直接使用 npx 从 npm 缓存中拉取并执行：

# 不带参数将进入交互式选择菜单
npx web-debug-skill init

# 或者直接指定安装到特定的 IDE
npx web-debug-skill init cursor

# 或者安装到自定义的路径
npx web-debug-skill init ./my-custom-skills-dir

这会在当前项目对应的编辑器技能目录下（如 .trae/skills/, .cursor/rules/ 等）生成标准化的 SKILL.md 和策略文档，向 AI 助手注入操作指南。

2. 召唤 AI 自动化测试

直接向你的 AI 助手（如 Trae 或 Cursor 的 Chat 窗口）发送自然语言指令，例如：

“请使用 web-auto-test 技能，为 utils/api.js 编写测试用例并排查代码链路。”

AI 将会自动遵循技能模板中定义的规范：

• 阶段一：调用工具排查当前基础环境。
• 阶段二：分析 utils/api.js，并自动生成 Mocha 规范的单元测试文件。
• 阶段三：调用底层的追踪引擎执行测试，并在聊天窗口为你呈现结构化的 Markdown 测试结果表格。

直接使用命令行工具

1. 基础环境与语法排查 (check)

扫描并验证 Node 环境及代码基础语法。

npx web-debug-skill check [目标文件路径]

2. 零侵入链路测试 (trace)

拦截用户代码并注入 Istanbul 探针，随后执行指定的测试文件，输出 Markdown 格式的测试结果与覆盖率报告。

npx web-debug-skill trace <您的测试文件.test.js>

许可证

ISC