用途:从代码变更自动生成结构化的人工测试指南,让测试者能精准验证被改动的功能。适用于 MR/PR 提交后提供验证指引、发布前依据代码变更圈定人工回归范围、功能交付验收时从代码推导可测试的用户行为。
主要能力:识别输入类型并获取变更(URL 时尝试用 CLI 取 diff,失败则提示用户粘贴;无输入时用 git diff 或 git diff HEAD~1);分析变更,按功能模块分组文件清单,分类为新增/修改/修复/配置/删除,推断用户可感知的行为变化,并识别配置、依赖升级、数据库迁移、API 契约等隐式变更;按变更类型匹配测试策略(新增走正常路径加边界,修改验证改动点并回归,修复验证缺陷场景并回归,配置验证生效并回归,删除确认移除且相关功能不受影响);补充回归验证范围;按模板输出 Markdown 文件,默认保存到当前工作目录,命名如 <feature>manual_test_guide<YYYY-MM-DD>.md,用户可指定路径或文件名。
使用方式:触发词包括「生成测试指南」「测试指南」「人工测试指南」「测试指引」「test guide」「根据代码生成测试」「从代码生成测试指南」「从 MR 生成测试指南」「从 PR 生成测试指南」,可带参数如「生成测试指南:https://gitlab.example.com/merge_requests/123」。每个测试项含测试目标、前置条件、面向非开发者的测试步骤、预期结果和优先级(P0 核心业务/数据写入/安全,P1 辅助功能/UI/性能,P2 样式/文案/内部重构)。对话中只输出简要摘要:保存路径、测试项统计、3–5 个核心改动点、回归范围,完整测试项仅写入文件。
限制与注意事项:输入格式、输出模板、示例、文件命名规则和对话输出策略详见 reference.md,本资料未提供其具体内容;未获取到 diff 时不应凭空生成测试项;测试步骤避免开发者术语;修复类需包含原始缺陷场景;人工测试指南中不应混入自动化测试;写文件前需确认当前工作目录,文件名不得含空格或特殊字符,生成后需在对话中报告完整保存路径。