user-journey-verifier
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseUser Journey Verifier
用户旅程验证器
Verify the outcome through the same path the user relies on.
Verification does not authorize fixes. Do not edit code, install dependencies, change configuration, deploy, or mutate production or external systems unless the user separately requests that action.
通过用户所依赖的相同路径验证结果。
验证工作不具备修复权限。请勿编辑代码、安装依赖、修改配置、部署,或变更生产环境及外部系统,除非用户单独提出此类操作请求。
Goal
目标
Produce direct evidence that the requested user-visible behavior works from its real entry point to its final state or artifact.
提供直接证据,证明所要求的用户可见行为从真实入口点到最终状态或产物均正常运行。
Define the Journey
定义用户旅程
Establish before running checks:
- the actor and starting state
- the exact entry point and actions
- the expected observable outcome
- the environment, data, and artifact version that matter
- any states or scale conditions material to acceptance
Use the user's stated path when one is provided. A substitute path cannot prove the requested path: directly invoking an export function does not verify a browser download button, and inspecting source data does not verify the generated workbook.
If the authoritative environment, reference artifact, or required access is missing, report the gap rather than silently substituting another source.
When supporting a conformance audit, use its specific acceptance criteria and evidence gaps to scope the journey. Report observations against those requirements without waiting for a conforming verdict; the journey supplies evidence needed to establish it.
在执行检查前需明确:
- 参与者与起始状态
- 确切的入口点与操作步骤
- 预期可观测结果
- 相关的环境、数据与产物版本
- 对验收至关重要的所有状态或规模条件
若用户提供了明确路径,必须使用该路径。替代路径无法证明请求路径的有效性:直接调用导出函数不能验证浏览器的下载按钮,检查源数据也不能验证生成的工作簿。
若缺少权威环境、参考产物或所需访问权限,需报告该缺口,不得静默替换为其他来源。
在支持合规审计时,需依据其特定的验收标准和证据缺口来界定旅程范围。无需等待合格判定,直接针对这些要求报告观察结果;旅程会提供判定所需的证据。
Verify End to End
端到端验证
Reuse direct journey evidence already obtained within the same implementation task when it covers the same relevant implementation or artifact version, entry point, acceptance criteria, environment, inputs, and conditions. Identify the observations being reused and confirm that no intervening change invalidates them. Another skill invoking this verifier does not by itself require a rerun.
When evidence is missing or invalidated by changes, failures, or new concerns, exercise the narrowest complete journey that resolves the gap. Retain applicable evidence for unaffected acceptance checks. Use available browser, document, PDF, spreadsheet, image, log, or shell capabilities only as needed for the actual outcome.
Check the relevant layers:
- Entry point: the user can start the journey as expected
- Behavior: actions, state transitions, errors, and recovery behave correctly
- Result: the final screen, download, record, or artifact contains the promised outcome
- Presentation: layout, copy, dimensions, ordering, formatting, and responsive behavior match acceptance when relevant
- Persistence: refresh, retry, restart, or later retrieval preserves state when the contract requires it
Use representative data and scale when the defect or requirement depends on them. Do not claim broad coverage from a happy-path fixture that omits the reported condition.
Local or test verification may perform normal reversible actions required by the journey, such as uploading a fixture or creating disposable test state. Keep artifacts outside the working tree when practical, clean up through the application's normal mechanisms when safe, and do not treat test authority as permission for production or external mutation.
若同一实现任务中已获取的直接旅程证据涵盖了相同的相关实现/产物版本、入口点、验收标准、环境、输入及条件,可复用该证据。需明确说明复用的观察结果,并确认中间无变更导致其失效。其他Skill调用本验证器本身并不要求重新运行。
当证据缺失,或因变更、故障、新问题导致证据失效时,执行能弥补该缺口的最小范围完整旅程。保留未受影响的验收检查的适用证据。仅在实际结果需要时,使用可用的浏览器、文档、PDF、电子表格、图像、日志或shell能力。
需检查以下相关层级:
- 入口点:用户可按预期启动旅程
- 行为:操作、状态转换、错误与恢复均表现正确
- 结果:最终屏幕、下载内容、记录或产物包含所承诺的结果
- 呈现:布局、文案、尺寸、排序、格式及响应式行为(若相关)符合验收要求
- 持久性:当契约要求时,刷新、重试、重启或后续检索仍能保留状态
当缺陷或需求依赖于数据和规模时,需使用具有代表性的数据和规模。请勿仅凭省略了所报告条件的 happy-path fixture 就声称覆盖广泛。
本地或测试验证可执行旅程所需的常规可逆操作,例如上传fixture或创建一次性测试状态。在可行的情况下,将产物保存在工作树之外;在安全的情况下,通过应用的常规机制进行清理;不得将测试权限视为生产环境或外部系统变更的许可。
Verdicts
判定结果
Classify each acceptance check as:
- : directly observed through the required path
pass - : observed behavior contradicts acceptance
fail - : the required path or evidence could not be exercised
unverified
Valid reused observations count as direct evidence. State when a verdict relies on them rather than implying that a new execution occurred.
Automated tests, typechecks, builds, logs, and code inspection can support a verdict, but they cannot replace missing user-visible evidence when the outcome is visual, interactive, or artifact-based.
每项验收检查需归类为以下之一:
- :通过要求的路径直接观测到
pass - :观测到的行为与验收要求不符
fail - :无法执行要求的路径或获取所需证据
unverified
有效的复用观察结果可视为直接证据。需明确说明判定是否依赖于复用结果,而非暗示执行了新的验证。
自动化测试、类型检查、构建、日志和代码审查可作为判定的辅助依据,但当结果是可视化、交互式或基于产物的时,它们无法替代缺失的用户可见证据。
Output
输出要求
Lead with the journey-level verdict: pass, fail, or unverified.
Report:
| Acceptance check | Evidence | Result |
|---|
For a failure, include the shortest reliable reproduction and the observed-versus-expected difference. Name a likely implementation area only when evidence supports it; do not turn verification into speculative diagnosis.
For an unverified result, state the exact missing access, environment, data, or tool and the next check that would close the gap.
首先给出旅程级别的判定结果:pass、fail 或 unverified。
报告格式:
| 验收检查项 | 证据 | 结果 |
|---|
若为失败情况,需包含最短可靠复现步骤以及实际观测与预期的差异。仅在有证据支持时,才可指出可能的问题所在领域;不得将验证变成推测性诊断。
若为未验证结果,需明确说明缺失的具体访问权限、环境、数据或工具,以及可弥补该缺口的下一步检查。
Stop Rules
停止规则
Stop when every material acceptance check has direct evidence or an explicit verification gap. Never report success solely because a different path, unit test, build, or generated artifact succeeded.
当所有关键的验收检查都有直接证据或明确的验证缺口时,即可停止验证。绝不能仅因为另一条路径、单元测试、构建或生成的产物成功,就报告验证通过。