用途：对已完成或接近完成的功能进行人工面向的 QA 验证。通过真实产品界面测试功能、捕获证据，并撰写本地 HTML 报告。这是高层验证流程，底层浏览器操作交给 agent-browser，需要持久回归覆盖时使用 automate-e2e-tests。
何时不适用：功能尚未实现到可运行时；无用户界面的纯 API 检查（可配置 test-api-feature）；编写自动化 E2E 测试（用 automate-e2e-tests）；仅做底层浏览器操作（用 agent-browser）；修复不稳定的测试套件或测试基础设施。
输入：功能描述、工单、计划或 PR diff；项目本地测试技能；应用的本地 URL、认证、种子数据、设备、模拟器或测试环境说明；已有验证报告或复现笔记（重测时）。若 URL、凭据、设备或环境无法找到，先问一个简洁问题再测试。
界面选择：Web/PWA 用 Agent Browser、Playwright、Chrome 或项目浏览器工具；原生移动端用模拟器、仿真器、设备、Appium、Detox、Maestro、XCUITest、Espresso 或手动设备装置；桌面端用项目桌面自动化或手动启动检查；仅 API 用批准客户端并记录请求/响应证据；Monorepo 测试拥有变更行为的应用或包。
验证计划：交互前定义需求、环境与 URL/设备/API 端点、认证/测试数据路径、正常路径、重要边界情况、错误或恢复状态、要捕获的证据、通过/失败标准。请求的行为是工作流时，不要停在邻近页面或部分状态。
证据目录：有配置则用项目报告位置，否则用 reports/<feature-slug>/，包含 index.html、screenshots/、videos/、logs/。HTML 报告使用相对链接以便附加到工单或 PR。
执行：确认环境可达；用批准的测试凭据、种子用户、保存状态或手动登录建立认证，不要编造凭据；先执行正常路径；再测边界情况（空状态、可选字段、边界值、权限、重复操作、离开/返回、慢加载、缺失数据）；在安全时测错误与恢复（无效输入、服务器拒绝、离线/网络失败、重试、取消、撤销、验证错误）；每次有意义状态变化后捕获证据；声明成功前检查证据；记录精确命令、工具、URL、设备与观察结果。浏览器验证时优先调用 agent-browser，不可用则用项目浏览器工具或 Playwright/Chrome。拒绝空白、全黑、过期、错误路由、裁剪过度或无法播放的证据。
状态模型：pass、fail、mixed、blocked。重要证据缺失时不得标记 pass。
HTML 报告：在 reports/<feature-slug>/index.html 创建自包含报告，包含标题与日期、需求或缺陷摘要、Git 分支与提交 SHA（如有）、状态、环境、运行的命令与结果、分步旅程及预期与实际、截图/视频/日志/追踪或请求响应证据（相对链接）、发现的问题、验证中应用的修复、剩余风险与未测路径、E2E 覆盖决定。项目无模板时以 references/report-template.html 为起点。
移交 E2E：报告完成后，若功能是核心用户旅程、修复需要回归保护、风险涉及认证/路由/持久化/移动或浏览器行为/多服务集成，或项目已有合适 E2E 框架，则调用 automate-e2e-tests；否则记录原因跳过。
失败处理：环境不可用记录精确 URL/设备/命令并标 blocked；认证不可用请求批准凭据或手动登录；工具不可用使用批准回退或标 blocked；发现缺陷捕获证据、范围内修复、重跑失败路径、记录前后；证据捕获失败用新会话重试一次，否则标 mixed；不安全路径不得执行破坏性、付费、生产或外部可见操作，除非明确批准。
最终回复：整体状态、报告路径、捕获的证据、发现的问题、E2E 覆盖决定、剩余风险。来源：Supatest AI supa-skills test-feature v1.1.1 通用起始版，建议在各项目运行 setup-task-to-pr 生成本地增强版本。