Test Feature 是一个通用的 QA 验证起步技能，用于在功能完成或接近完成时，通过真实产品界面进行验证、捕获证据并编写本地 HTML 报告。它属于面向人类的 QA 工作流，适合在功能已经实现到可被操作之后使用。
用途 该技能用于对已完成或接近完成的功能进行验收式验证，覆盖需求确认、环境准备、路径执行、证据收集和报告输出。它强调在真实产品界面中验证行为，而不是只做代码检查或组件预览。
主要能力
- 通过真实产品界面验证功能，支持 Web/PWA、原生移动端、桌面端和仅 API 场景。
- 捕获截图、视频、日志、追踪或请求响应等证据。
- 生成自包含的本地 HTML 报告，默认位置为 reports/<feature-slug>/index.html。
- 使用 pass、fail、mixed、blocked 四种状态描述验证结果。
- 在验证过程中记录命令、工具、URL、设备和观察到的结果。
- 支持在验证后决定是否将行为转化为持久 E2E 覆盖。
使用方式 在使用前，需要读取功能描述、工单、计划或 PR diff，并查看项目本地测试技能、应用说明、既有验证报告或缺陷复现记录。如果应用 URL、凭证、设备或环境无法发现，需要先提出一个简洁的问题再开始测试。之后根据功能所属界面选择验证方式：Web/PWA 使用 Agent Browser、Playwright、Chrome 或项目浏览器工具；原生移动端使用模拟器、仿真器、设备、Appium、Detox、Maestro、XCUITest、Espresso 或手动设备测试；桌面端使用项目桌面自动化或手动启动检查流程；仅 API 场景使用批准的客户端并记录请求响应证据。
验证前需要先定义验证计划，包括需求、环境与 URL/设备/API 端点、认证与测试数据路径、正常路径、重要边界情况、错误或恢复状态、需要捕获的证据以及通过/失败标准。执行时先确认环境可达，再使用批准的测试凭证或已种子用户建立认证，随后执行正常路径、边界情况和安全范围内的错误与恢复状态，并在每次有意义的状态变化后捕获证据。证据需要检查，空白、黑屏、过期、错误路由、裁剪过度或不可播放的证据应被拒绝。
报告要求 HTML 报告必须包含标题和日期、需求或缺陷摘要、可用的 Git 分支和提交 SHA、状态、环境信息、运行过的命令与结果、带预期和实际结果的逐步流程、使用相对链接的证据、发现的问题、验证期间应用的修复、剩余风险和未测试路径，以及 E2E 覆盖决策。项目未提供验证报告模板时，可以使用 references/report-template.html 作为起点。
适用场景 适合在功能实现到可被操作之后进行人工式 QA 验证，包括 Web/PWA、原生移动、桌面和仅 API 场景。也适合作为缺陷复测，或在验证后判断是否需要转化为 E2E 回归覆盖。
限制 不要在功能尚未实现到可被操作时使用；不要用于纯 API 检查且无用户可见行为，除非项目没有 UI；不要用于编写自动化 E2E 测试；不要用于单独的低层浏览器操作；不要用于大范围修复不稳定测试套件或测试基础设施清理。环境不可用时应记录并标记 blocked；认证不可用时应请求批准凭证或手动登录，不要编造凭证；工具不可用时应使用批准的备用方案或标记 blocked 并附设置说明。除非明确批准，否则不应执行破坏性、付费、生产或对外可见的操作。