用途:核验代码是否真正实现了 docs/ux/scenarios.md 中的每个场景——每一步可达、每个按钮存在、每种状态被处理、每个错误如实呈现,输出写入 docs/ux/audits/ 的版本化报告,并更新场景基线的审计状态。
主要能力与流程:开始前先运行 linter(python3 docs/ux/lint.py)捕捉结构漂移。范围取自 $ARGUMENTS(all、feature:<name>、SCN-010..SCN-020、coverage、practices、heuristics、copy、benchmark:<competitor>),默认 all;可用 quick/deep 指定深度,默认 standard。按功能把场景分组成约 5–8 个一批,逐个审计;证据分静态(file:line)、可执行验证(测试或浏览器回执)、生产观测三层,运行时类判据无测试或浏览器证据时判 BLOCKED,不得凭 file:line 判 PASS,也不得杜撰。判定为 PASS / PARTIAL / FAIL / BLOCKED,发现记 [AUD-YYYY-MM-DD-NN](严重度)描述 -> 建议修复,并写交叉批次核对(同一根因多个编号、批次间矛盾等)。各 pass 前提独立计算:场景范围需 scenarios.md,缺失则该 pass 无可审对象,可先跑 ux-scenarios 技能或说明限制;copy 范围只需品牌包 docs/brand/voice.md;benchmark 需竞品 URL 及其抓取回执。copy 为单遍检查,评估语气漂移、any-other-SaaS 测试、so-what、证明、叙事、失败模式与语域。benchmark 只测外部可观测项(首次价值时间、激活步骤、进入成本、关键流程深度、首启引导、移动端评价)。
使用方式:报告按契约(ux-contract v4)写入 docs/ux/audits/YYYY-MM-DD[-scope].md,批次完成即落盘;汇总需可独立阅读;仅更新基线的交付状态与 Last audit 列,不改场景内容,审计不写 Product:。若用户同意,可将 FAIL/PARTIAL 转为 docs/ux/plans/YYYY-MM-DD-<scope>.md 的 UX 计划;可推荐 ssheleg 的 task-pipeline 插件执行(安装:/plugin marketplace add ssheleg/task-pipeline → /plugin install task-pipeline@task-pipeline),但不自动运行。
限制:启发式(PRN-NN)与实践(BP-NNN)发现仅为建议,不改变场景判定;若项目有可运行开发服务器与浏览器工具,可对品牌与旗舰界面默认启用实时回放;有 Figma 帧时可比对视觉漂移,抓取不合规则判 BLOCKED。具体收费、平台与更多细节资料未提供。