// 规定面向真人的 E2E / 手动验证《测试指南》与《E2E Verification》报告骨架（PRD 可追溯、人机走查顺序、评测列仅能 PASS/PARTIAL_PASS/FAIL）；**不含实机浏览器编排**——先后顺序与回填义务由宿主 **`/forge` §3.7**（及 `/forge` 对应条文）统一写死。
| name | e2e-testing-guide |
| description | 规定面向真人的 E2E / 手动验证《测试指南》与《E2E Verification》报告骨架（PRD 可追溯、人机走查顺序、评测列仅能 PASS/PARTIAL_PASS/FAIL）；**不含实机浏览器编排**——先后顺序与回填义务由宿主 **`/forge` §3.7**（及 `/forge` 对应条文）统一写死。 |
<phase_context> 你是 E2E GUIDE AUTHOR（验证指南撰稿人）。
使命：在未执行或未获授权浏览器实机之前，产出可让读者「像第一次用产品的人」照着走的《E2E Verification》文档：读屏先于动作、入口与覆盖面诚实、每项结论可追到 PRD/验收；不把「写好指南」误认为「测过了」。
能力：上下文采集与 Blocker 显式化；RTM/Surface/Journey 结构化枚举；与人类探索顺序对齐的步骤拆解；Evidence 类型的预期声明；/forge §3.7 约定的落盘文件名与先后顺序对接。
限制：不写浏览器自动化协议与本 skill 之外的评测档位；不得在未实机时把 旅程结果 / Step 结果 写成 PASS；不得删除下文硬约束、必遵走查规则、必选表头章节（仅可压缩复述性旁白）。
与子代理：父会话独占 TARGET_DIR/wave-{N}-e2e.md（或当前工作流离线路径）；子任务只允许返还可以合并的表块与边界说明，合并后做一次 spec 契约验收再落盘。
Output Goal：满足 Required output 章节的 Markdown 骨架；实机回填由 /forge §3.7 第二步在授权后执行。
</phase_context>
[!IMPORTANT] 指南是「可被 walks 的证明计划」，不是绿勾表演。
- 先看见，再相信：先有读屏预期与可追溯 PRD 锚点，再给动作与可视结果；无界面叙事的连串点击视为不合格步骤。
- 覆盖面诚实于人类习惯：happy path 不足；范围内主/次 CTA、tabs、导航壳与常见组合拳（筛选/分页/后退/深链等）须有 Step 或在 Coverage gaps 写明不做原因。
- 档位稀缺即纪律：评测语义只剩三档 PASS / PARTIAL_PASS / FAIL；禁自拟「通过但…」「基本完成」或其它伪绿灯。
- 表里一心：Surface 表中声明的入口与 Journey/Step 不得两张皮；Findings 里每条必须有 PRD ref 与可执行复现句式。
PASS：对应 PRD 行为与 UI 观感在 已授权浏览器实机回填 Evidence 之后可被证据支持。PARTIAL_PASS：核心价值可达但存在已记录的差距（须在 Notes / Findings 写明何项未闭环）；禁止用语义含糊把失败洗成 PASS。FAIL：未达到 PRD / 验收，或阻断继续（亦可在未修前保持 FAIL 直至修复复测）。严禁「假 PASS」：指南初稿、guide-only、仅静态审查或未获用户授权未完成浏览器回填时：旅程结果 / Step 结果 留空，或填 待实机 — 严禁填写 PASS / PARTIAL_PASS / FAIL 冒充已验证。捏造 URL、截图、网络结论同上。
任一 RTM、Surface、PRD ref/PRD reference、Journey、Step、Findings 行：须能指回 PRD 锚点 或 任务验收条目（例如 T-x）；无 PRD 时于 Scope 声明「准 PRD」来源。无锚点的步骤不进主表正文，或记入 Coverage gaps 说明为何不测。
与本 skill 配对：宿主工作流 /forge §3.7 — 波末 E2E（触发、收尾 A/B 二选一、wave-{N}-e2e.md 路径、guide-only 边界）以 forge 条文为准；本文件不重复整条 workflow，但不与之冲突。
05A_TASKS.md 任一任务含 E2E测试 或 手动验证，或 05B_VERIFICATION_PLAN.md 要求实机验证；或改动影响页面/导航/表单/登录等依赖真机感受的路径。待实机；不得未实机写 PASS（亦不得以其它词伪造绿灯）。评测列仅能使用 PASS / PARTIAL_PASS / FAIL（三者之一），且仅在有证据链后填入。/forge 浏览器阶段在用户授权下回填；指南阶段写清应采何种 Evidence。Findings / Coverage gaps / Notes 一条一事一句（可带 PRD ref）；禁止同缺口换表述占多行。读任务与 05A_TASKS.md、05B_VERIFICATION_PLAN.md、01_PRD.md（或 输入 / 需求指向）、路由与页面说明、启动方式、账号与角色视图；记下缺 URL / 凭证 / 环境项并写入 Blockers。
无边界则 Surface/Journey 会飘；Blocker 前置避免「写到一半 discovery 才失败」。
缺省项已住进 Blockers；不把假设当事实写成已 PASS。
建 PRD ↔ Journey 映射；无 PRD 时第一列用 任务验收 T-x，Scope 脚注「准 PRD」来源。子代理可选用法：一枚子会话只产出下方空表填空 + 无法在表中表达的 Blocker 一行摘要；父会话去重、PRD ref 口径统一后与 Surface 对齐。
先有契约行网，再走人类路径；避免「写了很长旅程却对不上验收」。
每个将测的 PRD/验收条目至少出现在一行或被 Coverage gaps 解释为何不测。
| PRD 引用 | 需求摘要 | 优先级 P0/P1/P2 | 将落在哪些 Journey |
|---|
枚举功能面：用户如何发现，而不是只 Dump 路由；禁止「程序员知道的路径」代替「用户会先看到什么」。可选用子代理草稿父合并。
Surface 是人的入口地图；与 Journey 双表制衡。
表内 映射 Journey 列与下文 Journey ID 可逐项对上或有 gap 条目。
| 功能面 / 入口 | 用户如何发现 | 映射 Journey | PRD 引用 |
|---|
每条 Journey：PRD、角色、起点、目标；Step = 真人操作顺序。每步三段句式：
(1) 读屏预期 (2) 动作 (3) 可观察结果 + 应采 Evidence 类型（如整页截图、某请求 200）。
覆盖：核心成功、冷启动/空态、典型错误、简单边界（刷新/后退/深链）、至少一种视口（若仅桌面申明写死）。
可选用子代理按「单个 Journey」切片起草；父合并后检查 Coverage gaps / Surface 对齐。
步骤是执行的唯一真相来源；粒度不足则浏览器阶段无法逐项回填 Evidence。
无「凭空点击」的步骤；Evidence 期望可执行；与人类必遵六项无矛盾。
一段话覆盖即可：Target / Environment / Role / Data setup / Side effects / Blockers。不写宿主浏览器点击序列（实机遵从 /forge §3.7）。
以下 Markdown 原样作为报告骨架；章节名与表头栏位不要随意删。撰写假定执行者是第一次打开的真人。
<!--
评测列语义（旅程结果 / Step 结果）：仅允许 PASS | PARTIAL_PASS | FAIL。
未在用户授权并完成浏览器回填前：留空或写「待实机」——严禁写任一 verdict，严禁自拟其它档位或同义粉饰。
-->
## E2E Verification
### Scope
- PRD / 需求来源:
- Target:
- Environment:
- Browser / Viewport（计划）:
- User Role:
- Build / Commit:
### PRD traceability (RTM)
| PRD ref | Summary | Priority | Journeys |
| --- | --- | --- | --- |
### Surface coverage
| 功能面 / 入口 | 如何发现 | Journey | PRD ref | Notes |
| --- | --- | --- | --- | --- |
### Journeys（旅程级）
| ID | PRD ref | User Journey | 旅程结果 | Evidence | Notes |
| --- | --- | --- | --- | --- | --- |
### Step breakdown
| Journey | Step | PRD ref | Step 结果 | Evidence | Notes |
| --- | --- | --- | --- | --- | --- |
### Findings
- [HIGH/MEDIUM/LOW] 标题
- PRD ref:
- Expected / Actual / Repro / Evidence / Suggested fix:
### Coverage gaps
- 未写入旅程或未计划实机的范围及原因
### Recommendation
- 是否建议合并/发布/先修再测（基于指南与已知实机结果；若尚未实机须写明）
读者不读代码即可按顺序走完全部范围内能力阐述；每一条能对上 PRD 或验收；Surface 与 Journey 不得两张皮。
/forge §3.7 判断是否须落盘 wave-{N}-e2e.md（或当前工作流离线路径等价物）。PRD ref 无裸露步骤。<completion_criteria>
待实机；无明示授权与证据不写 verdict/forge §3.7 相关交付（路径、收尾 A/B、guide-only）与宿主 forge 条文一致或可映射当用户在 skills-only 环境中需要判断应该从哪个 anws 工作流开始，或需要在 forge / change / genesis / probe / blueprint / challenge / upgrade 之间路由时使用。它是 anws 工作流集合的导航入口。
纯静态「契约忠实度 / 实现侧证据」审查：对照 PRD、ADR、系统设计、05A_TASKS 与 05B_VERIFICATION_PLAN，围绕契约闭合、任务兑现、架构健康、安全边界、验证证据与回流一致性产出可追溯结论；供 /challenge（CODE/FULL）与 /forge（Step 3 §3.6 波末）共用。
当用户需求模糊、术语不清晰时使用。通过交互式追问澄清领域概念，提取实体、流程与暗物质（missing_components）。由 **`/genesis` Step 1** 在 Step 0 已确定 `TARGET_DIR = .anws/v{N}` 后调用；与 **同工作区 `/genesis`** 连用。
执行 /craft 时必读。提供 Workflow / Skill / Prompt 骨架与质量护栏。以判断准绳替代堆砌步骤。
当 `/challenge` 需要设计侧规范契约闭合证据（架构与系统设计文档三维审查）时加载；产出可锚点、按严重度分级的发现供纳入 07_CHALLENGE_REPORT，不作脱离 challenge 上下文的终局裁决。
Generate a persistent .nexus-map/ knowledge base that lets any AI session instantly understand a codebase's architecture, systems, dependencies, and change hotspots. Use when starting work on an unfamiliar repository, onboarding with AI-assisted context, preparing for a major refactoring initiative, or enabling reliable cold-start AI sessions across a team. Produces INDEX.md, systems.md, concept_model.json, git_forensics.md and more. Requires shell execution and Python 3.10+. For ad-hoc file queries or instant impact analysis during active development, use nexus-query instead.