base-manual-capturelisted

# Base Manual Capture 把"打开系统、逐步操作、逐步截图、逐步确认"沉淀为域中立、工具中立的采集基座。本 Skill 只负责**采集**——产出截图与结构化操作记录；手册正文由 `pg-manual-builder` 一类写作层技能编写。 ## 何时使用 - 需要为一个可访问系统（有地址+测试账号）生成带截图的操作手册 - 需要按功能描述逐步走查系统并与用户确认业务流程/概念是否符合预期（B 阶段） - 需要刷新旧手册的截图（系统版本变化后重采） - 需要把已确认的操作路径固化为可回放脚本（C 化） 本 Skill **不负责**：写手册正文、判断业务规则是否正确（由用户在 B 阶段确认）、桌面端采集（当前仅 Web 通道）。 ## 前置输入 1. 系统访问地址 2. 测试账号（口令仅用于登录，**不落台账/记录**，见脱敏规则） 3. 功能描述（口述或简要均可）——要采哪条/哪几条流程 4. 手册目标读者（影响截图取舍与注意事项详略） 5. 输出目录：`project_root` / `manual_root`（与 `pg-manual-builder` 约定一致；截图落 `manual_root/captures/<flow>/`） 若功能描述模糊，先请用户给一句话流程目标（如"用户登录后创建工单并提交审核"），再开采。 ## 工具解析优先级 按以下顺序选用任一可用的浏览器自动化工具，任一可用即可执行： 1. **Playwright MCP**（首选，可精确 selector + 稳定截图） 2. **browser-use MCP**（会话式操作，Qoder 等自带） 3. **本地 playwright CLI**（`.agents/tools/ms-playwright` 或 `playwright` 命令） 开采前先做一次探活：能打开目标地址并成功登录即视为通道可用；都不可用则停止并提示用户配置。 ## 采集通道 - `capture_channel: web`（当前唯一实现） - Client/桌面端为**预留扩展位**，本版不实现；未来新增通道时复用同一套台账/记录契约 ## B 阶段主流程（核心） ### SOP-B0 采集范围确认（人工确认点，必做） 开采前先锁定“手册要覆盖哪些功能”，避免漏采： 1. 登录系统后先做一次**功能盘点**：遍历导航菜单/功能入口，列出发现的功能模块与子页面清单（含数量，如“综合查询含 5 类 20+ 子表单”） 2. 把清单交给用户**勾选确认**：哪些进手册（逐页详采）、哪些只截代表页、哪些不覆盖；未经确认不得自行裁定覆盖范围 3. 确认结果落为 **flow 清单**（写入 capture-trace 或独立 `flows.md`）：每个 flow 一行，标注 待采/已采/跳过 4. B 阶段退出条件同步收紧：**flow 清单全部处理完毕**（而非单条流程走完）才算采集完成，交给写作层前再向用户报一次覆盖对账（已采 N/应采 M） ### SOP-B1 环境确认 1. 用选定工具打开地址并登录，确认进入目标系统首页 2. 固定视口 `1920×1080`（保证截图尺寸一致，详见截图规范） 3. 显式确认 `project_root` / `manual_root`，建立 `manual_root/captures/<flow>/` 目录 4. 初始化空的 `capture-ledger.md` 与 `capture-trace.