Chrome Workflow Build

Chrome工作流构建器

概述

这是一个元技能（Meta-skill），支持双模式将浏览器自动化操作转换为可复用的Claude Skills：

• 模式1（执行并记录）：通过智能记录、分析和生成，将实时执行的浏览器操作链路转换为Skill
• 模式2（DATASAVER录制转换）：将DATASAVER录制工作流.json文件分析、验证并转换为Skill

规则1：严格按阶段顺序执行

• 模式1：阶段1(LOG.md) → 阶段2(WORKFLOW.md) → 阶段3(CREATOR.md)
• 模式2：阶段1(DATASAVER录制工作流转换模块) → 阶段2(CREATOR.md)
• 禁止跳过任何阶段，每个阶段必须完整执行后才能进入下一阶段
• 禁止偷懒：不能只做部分工作就声称完成

规则2：中间产物必须生成

每个阶段必须生成对应的输出文件，缺少任何一个都视为阶段未完成：

| 阶段 | 必须生成的文件 | |------|---------------| | 模式1-阶段1 | workflow-logs/[skill-name]-log.json | | 模式1-阶段2 | workflow-workflows/[skill-name]-workflow.json | | 模式2-阶段1 | workflow-workflows/[skill-name]-workflow.json | | 最终阶段 | workflow-skills/[skill-name]/SKILL.md |

快速开始

本Skill支持双输入模式：

模式1：执行并记录（适用于新需求）

1. 立即使用chrome-server MCP 提供的工具执行任务
2. 将执行步骤记录到结构化日志并抽取的Workflow
3. 基于Workflow生成可供未来使用的可复用Skill

模式2：DATASAVER录制工作流转换（适用于已有DATASAVER录制文件）

1. 提供DATASAVER录制工作流.json文件
2. 分析并验证转换为workflow.json
3. 基于Workflow生成可供未来使用的可复用Skill

工作流程

模式1：执行并记录流程

阶段1：执行并记录

执行浏览器任务，同时记录每个工具调用和决策。 加载 [LOG.md](LOG.md) 并严格遵循它的指令工作

阶段2：提取工作流（仅在阶段1完成后）

分析执行日志以提取可复用的工作流模式。 加载 [WORKFLOW.md](WORKFLOW.md) 并严格遵循它的指令工作

阶段3：生成Skill（仅在阶段2完成后）

从提取的工作流创建、验证并生成新的Skill。 加载 [CREATOR.md](CREATOR.md) 并严格遵循它的指令工作

模式2：DATASAVER录制工作流转换流程

阶段1：DATASAVER录制工作流分析提取workflow

读取DATASAVER录制工作流.json文件，分析、验证并提取为workflow.json。 加载 [DATASAVER.md](DATASAVER.md) 并严格遵循它的指令工作

阶段2：生成Skill

从生成的工作流创建、验证并生成新的Skill。 加载 [CREATOR.md](CREATOR.md) 并严格遵循它的指令工作

决策树

 用户请求分析
  ├─ 1. 判断输入类型
  │  ├─ 提供DATASAVER录制工作流.json文件? → 模式2: DATASAVER录制工作流转换流程
  │  ├─ 描述浏览器操作需求? → 模式1: 执行并记录流程
  │  └─ 其他 → 不使用此Skill
  │
  ├─ 2. 模式1: 执行并记录流程
  │  │
  │  阶段1：执行并记录（LOG.md）
  │     ↓
  │  【确认点】展示最终执行结果，询问用户是否正确
  │     ├─ 正确 → 进入Skill发现检查
  │     └─ 有问题 → 根据用户反馈调整后重新执行
  │     ↓
  │   Skill发现检查（LOG模式-执行后立即发现）
  │     加载 SKILL_DISCOVERY.md 执行智能发现
  │     ├─ 发现高度匹配Skill（>=90分）→ 强制询问用户 → 等待用户决策
  │     │   ├─ 用户确认"满足需求" → 停止创建流程 + 文字指导使用 → 结束（不保存日志）
  │     │   └─ 用户选择"不满足" → 保存日志 → 继续阶段2和3
  │     └─ 无匹配（=90分）→ 强制询问用户 → 等待用户决策
        │   ├─ 用户确认"满足需求" → 停止创建流程 + 文字指导使用 → 结束
        │   └─ 用户选择"不满足" → 继续转换流程
        └─ 无匹配（生成后，将 skill-name 作为全局变量，在后续所有步骤中使用。**
2. **执行阶段** - **必须读取并使用 [LOG.md](LOG.md)**
   - 调用chrome-server MCP工具
   - 实时记录执行步骤
   - 处理错误和异常情况
   - 保存结构化日志
3. **分析阶段** - **必须读取并使用 [WORKFLOW.md](WORKFLOW.md)**
   - 加载执行日志
   - 分析工具调用序列
   - 提取参数模式
   - 生成工作流定义
4. **生成阶段** - **必须读取并使用 [CREATOR.md](CREATOR.md)**
   - 创建Skill目录结构
   - 生成SKILL.md文件
   - 验证Skill结构和功能
   - 发布完成报告
   - 如果存在skill发布tool则直接调用发布到服务端

 ### 模式2完整工作流执行路径 

  1. **DATASAVER录制工作流文件读取**
     - 用户提供DATASAVER录制工作流.json文件路径
     - 验证文件格式
     - 提取顶级description用户需求作为核心指导要义
     - 提取name字段生成 [skill-name]
       - 格式：[skill-name]
       - 规则：小写英文字母、连字符（^[a-z-]+$）
       - 示例：
         - "在小红书发布笔记" → skill-name = "xiaohongshu-post"
         - "收集抖音短剧信息" → skill-name = "douyin-drama-collection"
          **生成后，将 skill-name 作为全局变量，在后续所有步骤中使用。**
  2. **分析转换阶段** - **必须读取 [DATASAVER.md](DATASAVER.md)**
     - **步骤1-2**：读取DATASAVER录制工作流.json，构建执行顺序（如7个节点）
     - **步骤3**：分析并抽取必要步骤
       - 应用FILTER_STEP.md规则过滤（trigger、trigger-event等）
       - 从7步抽取到5步必要步骤清单
       - 记录过滤原因到datasaver_note
     - **步骤4**：**必须逐步执行验证**（核心，不能跳过）
       - **必须**对所有必要步骤**逐一实际调用chrome工具执行**，不能仅分析
       - 验证选择器有效性
       - 失效则动态查找新selector并重新执行
       - 记录验证结果
     - **步骤5**：生成workflow.json（必须等步骤4全部验证完成后）
       - 包含验证通过的步骤
       - datasaver_note记录original/new selector
       - datasaver_conversion_report记录转换统计
     - **步骤6**：输出转换摘要（等待用户确认）
  3. **生成阶段** - **必须读取并使用 [CREATOR.md](CREATOR.md)**
     - 创建Skill目录结构
     - 生成SKILL.md文件
     - 验证Skill结构和功能
     - 发布完成报告
     - 如果存在skill发布tool则直接调用发布到服务端

## 输出文件说明

### 日志文件(模式1)
- 位置：`[当前工作目录]/workflow-logs/`
- 格式：`[skill-name]-log.json`
- 内容：完整的执行记录

### 工作流文件(模式1和模式2)
- 位置：`[当前工作目录]/workflow-workflows/`
- 格式：`[skill-name]-workflow.json`
- 内容：提取的工作流定义

### 生成的Skill(模式1和模式2)
- 位置：`[当前工作目录]/workflow-skills/[skill-name]/`
- 结构：标准Skill目录结构
- 发布：如果环境中有用于发布 Skill 的 create_workflow tool，则会调用自动发布到服务端

## 错误处理

### 模式1阶段1失败（执行错误）
- **症状**：chrome工具调用失败
- **处理**：记录错误，询问用户是否重试或调整策略
- **不继续**后续阶段

### 模式1阶段2失败（提取失败）
- **症状**：无法识别可复用模式
- **处理**：说明原因（如步骤太少、太多用户干预）
- **输出**：日志文件仍可用于参考

### 模式2阶段1失败（转换失败）
- **症状**：DATASAVER录制工作流.json格式错误、关键步骤验证失败、无法推断操作意图、验证通过率过低
- **处理**：根据具体失败原因停止转换，说明原因（如文件格式问题、页面结构变化、选择器全部失效、缺少description）
- **建议**：检查DATASAVER录制工作流文件格式、确认页面可访问、为关键步骤添加description、重新录制DATASAVER工作流
- **输出**：部分转换结果和详细错误信息供参考

### 阶段3失败（生成失败）
- **症状**：验证不通过
- **处理**：最多重试3次，每次修复后重新验证

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ClawCap](https://github.com/ClawCap)
- **Source:** [ClawCap/ManoBrowser](https://github.com/ClawCap/ManoBrowser)
- **License:** MIT

Install and usage instructions live in the source repository linked above.