用途:以资深文档体验专家的方式审查文档页或指南,既读文本,也在真实产品中按文档步骤走一遍,报告哪些做得好、哪里会让读者卡住,以及具体怎么改。与 guidewright-capture(文档编写技能)配套,后者生成带注释的走查,本技能负责按标准审查。适用于任何产品的文档。
主要能力:产出按优先级排序的 markdown 审查报告,每条发现都指明位置、说明对读者的影响并给出修复建议,末尾附可直接粘贴的改写建议。走查是核心差异点,能发现只读审查看不到的过时截图、按钮改名、缺失步骤、死胡同、未说明的前置条件,以及文档路径并非真实用户会走的路径。若文档是概念性的、没有 UI 流程,则跳过走查,仅按审查维度评估。
使用方式:先确定被审查的具体页面(文档仓库路径、PR 或粘贴文本),模糊时用一个问题确认。阅读文档并建立读者模型。若描述 UI 流程,用浏览器驱动 MCP(Chrome DevTools MCP 或 Playwright MCP)在真实 UI 中逐步走查;两者都有时由使用者选择,只有一个就用它,都没有则建议启用,或退化为只读审查并明确说明未能对照真实 UI 验证。按 references/lenses.md 的维度评分(Diátaxis 类型匹配、任务导向、可查找性/独立性、渐进披露、极简、可扫读、平实语言、可访问性、准确性)。报告固定结构:Verdict、What works、Findings(按 Blocker/Major/Minor 分级)、Drift from the live UI、Suggested rewrites。
限制与安全:走查前需确认浏览器驱动可用;启动应用/开发栈并驱动 UI 前先与用户确认;复用已打开的浏览器页面,不要杀掉或重启配置,不要多个驱动共用同一配置;保存报告或应用改写时应在隔离的 git worktree 中进行,避免与并行运行冲突;登录凭据和环境 URL 向用户索取,绝不读取 .env 等密钥文件。不要为凑数堆砌小问题,按读者影响排序。具体安装命令与价格信息暂未提供。