用途:为一次已实现的变更生成单个自包含 HTML 文件,引导人工测试者完成验证,涵盖如何搭建环境、做什么、预期结果,以及可把结果导出为 Markdown 的清单。
主要能力:解析输出目录(按 ${CLAUDE_PLUGIN_ROOT}/config.json 的 outputDir,其次为 SKILL.md 同级的 config.json,均无则参考 config.example.json 并询问用户绝对路径后写入技能级配置);确定测试范围(用户指定的功能、分支、PR 或提交范围,否则默认当前实现,如 git diff $(git merge-base main HEAD)...HEAD 或 git diff HEAD);阅读变更文件并追踪用户可见入口,从真实代码推导场景,覆盖正常路径、边界情况、错误处理与回归检查;生成含内联样式、脚本与 SVG 的单文件指南,包含头部信息、实现概述、环境搭建、测试流程图、测试场景卡片、带通过/失败/跳过切换、备注、进度条和“Copy results as Markdown”按钮的结果跟踪,并用 localStorage 持久化状态;按 <repo>-<branch-or-feature-slug>-manual-test-<yyyyMMdd-HHmm>.html 命名保存,必要时用 start <path> 打开,并报告路径、各类场景数量与假设。
适用场景:需要人工验证某次代码变更时。
限制:无法验证的前置条件(账号、外部服务、种子数据)会列为假设而非编造步骤;若范围内无用户可见行为(纯重构、仅文档)会说明并询问是否仍要仅回归指南;无法从仓库发现启动方式时会询问用户;不在 git 仓库且未指定功能时会停止并询问。