📦 User Guide Automation — User 图形界面de 自动化
v1.0.0Reusable 工作流 for generating formal, detAIled Markdown user 图形界面des from 网页 应用s using browser exploration or user-provided flows. Uses screensho...
by 详细分析 ▾
运行时依赖
安装命令
点击复制技能文档
Web 应用用户指南自动化 当用户希望从 Web 应用生成一份正式、详尽的用户指南，且最终需为可转 DOCX 的 Markdown 文档时，调用本技能。
核心思路 本流程基于浏览器探索，而非源码审查。指南内容全部来自实时浏览器会话：
- 用 browser_snapshot() 获取页面结构
- 用 browser_vision() 进行视觉确认
- 用 browser_click()、browser_type()、browser_scroll()、browser_press() 完成交互
- 必要时用 browser_console() 检查控制台
若用户给出操作流程，严格按该流程执行；未提供则自主探索并推断主要用户旅程。
当前仅支持 Sprint-1 / 草稿模式：仅输出 Markdown，但按最终文档结构编写，后续可直接转 DOCX，无需重写。
若提供参考文档（如 PDF 用户指南），先提取其结构模式，转化为可复用的 Markdown 蓝图，再撰写实际指南。需保留：
- 封面/前言样式
- 目录样式
- 章节编号方式
- 重复子流程模式（如 daftar/tambah/detail/edit/upload/hapus/arsip）
- 截图插入节奏
- 用语风格
默认文件命名
- guide.md（主文档）
- screenshots/（证据资产）
默认要求
- 格式：仅 Markdown (.md)
- 风格：正式
- 详细程度：详尽
- 截图：每步必截，不限关键步骤
- 受众：视 Web 应用而定（管理员、普通用户或混合）
- 模板：使用提供的 Markdown 蓝图；本技能不生成 DOCX
Slash 命令表单 运行 /user-guide-automation 时，以可复制格式收集最少信息： URL: 输出位置: 范围: 全站 / 指定功能（请列出功能） 可选但建议填写： 角色: 凭据: 流程: 模板路径: 输出文件名: 特殊备注:
规则
- 选特定功能范围时，仅在该功能内操作，除非需相关导航。
- 选全站时，覆盖主要旅程与核心功能组。
- 提供凭据时，仅用于目标应用与指定流程。
推荐工作流 1) 收集 确认或获取：
- 目标 Web 应用 URL
- 用户角色（如相关）
- 用户提供的流程（如有）
- DOCX 模板路径
- 输出文件名或文件夹
- 单功能或全工作流
- 截图目录行为（默认：在输出文件夹内创建 screenshots/）
若用户仅给顶级输出目录，按以下结构创建： {output_dir}/ ├── guide.md ├── screenshots/ │ ├── dashboard/ │ ├── ai-characters/ │ └── ... └── references/
每功能、页面组或工作流阶段一个子文件夹；文件夹名小写 kebab-case。
2) 探索 Web 应用 打开应用，识别真实用户旅程。按需在适当时机使用： browser_navigate(url=...) browser_snapshot() browser_vision(question=..., annotate=true) browser_click(ref=...) browser_type(ref=..., text=...) browser_scroll(direction=...) browser_press(key=...) browser_console(clear=true)
对含动画、懒加载或滚动加载的页面，勿凭单屏判断；小幅滚动、短暂暂停后再次 browser_snapshot() / browser_vision() 确认。
仅收集指南所需 UI 信息：页面标题、菜单名、按钮文案、字段标签、成功/错误提示、面包屑路径。不冗余提取。
3) 构建步骤列表 按真实交互顺序列出步骤。有用户流程则保持原顺序；无则根据 UI 推断实用顺序。每步包含：
- 步骤编号
- 动作动词
- 目标 UI 元素或页面
- 简短说明（如需）
- 截图引用
Sprint-1 Markdown 草稿先按文档章节组织，再列步骤；顶级章节顺序与后续 DOCX 模板一致，保证转换友好。
4) 每步截图 所有步骤均截图，含中间步骤。截图用作教学插图，非缺陷证据。若步骤改变页面状态，立即捕捉新状态。 经验：含登录流程时，先单独截登录页，再进入受保护区域。勿用后续仪表板截图代替。