메뉴
在不重新执行测试的前提下消费已有 API 测试产物。只要用户主要想查看 allure-results、allure-report、结构化 JSON 结果、确认报告是否已生成、把已有 allure-results 转成可看报告、排查为什么报告打不开、或判断仓库里有哪些现成结果可以直接看，都应优先使用这个 skill。当用户说"打开 Allure 报告""看看这次测试结果""报告打不开"时务必使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
TestSpec 需求分析和梳理（流程第 2 步）- 对需求做深度测试分析，运用等价类、边界值、状态迁移等方法，产出 requirements-analysis.md。当用户要「分析需求」「梳理测试点」「做需求分析」「拆解可测项」或执行 testspec-analysis / testspec analysis 时使用。也适用于用户说「这个 PRD 有哪些要测的」「帮我分析一下测试范围」「需求评审准备」的场景。注意：如果用户要的是简短的测试点清单而非深度分析，应使用 testspec-points。
TestSpec 生成测试用例（流程第 4 步）- 根据测试点（specs/*.md）生成完整测试用例并导出 Excel (.xlsx) 或 XMind (.xmind) 格式。当用户要「生成用例」「写测试用例」「导出 Excel」「导出 XMind」「生成测试用例表格」或执行 testspec-generate / testspec generate 时使用。也适用于用户说「把测试点展开成用例」「帮我出一份测试用例表」「生成 Excel 测试文档」的场景。使用内置 Python 脚本完成 Excel/XMind 文件生成，不依赖外部技能。
TestSpec 新建测试工作（流程第 1 步）- 创建测试变更目录，编写 proposal.md，并在用户提供已有 PRD/需求片段时净化成可验收的 requirements.md。当用户要「新建测试」「开始测试」「创建测试变更」「建一个测试项目」或执行 testspec-new / testspec new 时使用。也适用于用户说「我要测 XXX 功能」「帮我准备测试」「有个新需求要测」「帮我整理/审查 PRD」的场景——如果尚无 testspec/changes/ 目录，这是流程的起点。产出 testspec/changes/<name>/ 目录结构、proposal.md，必要时产出 requirements.md。
TestSpec 测试点（流程第 3 步）- 从需求分析中提炼「要测什么」的简短要点清单，产出 specs/testpoints.md。当用户要「写测试点」「提取测试要点」「列出要验证的内容」或执行 testspec-points / testspec points 时使用。也适用于用户说「这个功能要测哪些点」「帮我列测试清单」的场景。与测试用例区分：测试点只列验证目标（What），不写操作步骤（How）。产出供 testspec-generate 展开为完整测试用例。
TestSpec 用例评审（流程第 5 步）- 对生成的测试用例做 14 维度交叉验证（R1-R6 规则检查 + H1-H8 启发式检查），产出 review-report.md 评审报告。当用户要「评审用例」「检查用例质量」「审查测试用例」或执行 testspec-review / testspec review 时使用。也适用于用户说「用例写完了帮我看看」「检查一下覆盖度」「用例有没有问题」的场景。支持默认模式和 --deep 深度模式。
TestSpec 需求源更新与口径收敛（可重复执行的轻量 rebaseline）- 当已有 testspec/changes/<name>/ 后，用户补充、修改、删除、澄清、替换 PRD、接口文档、UI 图、原型图、产品回答、验收规则、权限规则、时间口径、收益映射、字段说明或需求范围时使用。适用于「产品改需求了」「补充接口文档」「新增 UI 图」「删掉这个需求」「同步最新 PRD」「口径收敛」「更新 requirements」「标记旧 analysis 过期」「用例写完后需求变了」「testspec-update / testspec update」。产出更新后的上游需求源、变更影响摘要、blocking_open_questions/dynamic_followups 分类，并标记 stale 下游产物。
| name | apitestspec-result-viewer |
| description | 在不重新执行测试的前提下消费已有 API 测试产物。只要用户主要想查看 allure-results、allure-report、结构化 JSON 结果、确认报告是否已生成、把已有 allure-results 转成可看报告、排查为什么报告打不开、或判断仓库里有哪些现成结果可以直接看，都应优先使用这个 skill。当用户说"打开 Allure 报告""看看这次测试结果""报告打不开"时务必使用。 |
基于已有测试结果生成或打开报告，并指出结构化结果文件位置。
当前阶段只负责消费已有测试产物，不负责重新执行。
allure-results、allure-report、reports/results.json 之类的结果产物apitestspec-scenario-runnerapitestspec-composerapitestspec-flow-configuratorapitestspec-surface-scanapitestspec-scenario-runnerapitestspec-flow-configurator详见 套件路由表。本 skill 对应阶段 5（已有结果产物，只想看报告）。只要核心问题是“怎么看已有结果”就留在这里；如果核心问题变成“还没跑”或“跑不起来”，交回 apitestspec-scenario-runner。
目标是快速定位现有报告和结果产物，让用户马上看到已有结果，而不是把任务扩展成环境改造或重新执行。
allure-results、allure-report、结构化 JSON 结果：进入本 skillproject.yaml优先使用项目内脚本：
python skills/apitestspec-result-viewer/scripts/serve_report.py [--no-open]
仅当脚本不适用时，再直接执行 allure generate 或 allure serve。
优先探测这些路径：
allure-results/allure-report/reports/results.jsonreports/summary.jsonreports/*.json如果这些路径都不存在，要明确说当前没有可消费产物，而不是假装可以继续。
apitestspec-scenario-runnerallure-resultsallure-reportallure-results 不存在时，不要假装可以生成报告不要擅自安装，只给引导：
brew install allure并明确说明：安装完成后，可在项目根目录执行 allure serve allure-results
回答时必须说明：
allure-resultsallure-report