---
name: rrweb-sgrobot-adapter
description: Generate SGrobot-compatible PlanTemplate.toml and runtime SKILL.toml artifacts from rrweb semantic traces. Use when adapting recorded browser workflows, rrweb traces, semantic-trace JSON, or browser automation recordings for SGrobot/sgclaw plan_templates and .sgclaw-workspace skills without changing SGrobot core.
---

# RRWeb SGrobot Adapter

Use this skill to turn one rrweb semantic trace into SGrobot runtime artifacts:

```text
plan_templates/<flow>/PlanTemplate.toml
.sgclaw-workspace/skills/<flow>-execute/SKILL.toml
.sgclaw-workspace/skills/<flow>-execute/scripts/execute_trace.js
.sgclaw-workspace/skills/<flow>-execute/trace.semantic.json
```

Do not treat `SKILL.md` as the SGrobot runtime artifact. In SGrobot:

- `PlanTemplate.toml` is the user-facing business task orchestration.
- `.sgclaw-workspace/skills/**/SKILL.toml` is the executable runtime skill.
- `.agents/skills/**/SKILL.md` is only an agent/Codex helper.

## Workflow

1. Read the semantic trace JSON and confirm it has `id`, `name`, `startUrl`, and non-empty `steps`.
2. Read [references/sgrobot-adapter.md](references/sgrobot-adapter.md) when you need SGrobot mapping details.
3. Generate artifacts with:

```bash
node scripts/generate_sgrobot_flow.mjs \
  --trace examples/basic-trace.json \
  --out /path/to/sgrobot-architecture-design \
  --default-mode dry-run
```

Use `--default-mode execute` only when the user explicitly wants the generated skill to mutate the target page. Generated execute-mode plans set `requires_approval = true` when the trace includes mutating actions.

4. Inspect the generated `PlanTemplate.toml` and `SKILL.toml` before handing off. The plan step `skills = ["..."]` must match the generated `[skill].name`.
5. In a live SGrobot repo, verify `/api/debug/plans` sees the plan and `/api/skill` sees the skill before running the digital employee task.

## Trace Shape

Minimal trace:

```json
{
  "id": "expense-approval",
  "name": "费用审批",
  "description": "打开审批页，填写意见并点击同意。",
  "startUrl": "https://oa.example.test/expense/123",
  "steps": [
    { "type": "assertText", "text": "费用审批", "label": "确认在审批页" },
    { "type": "fill", "selector": "textarea[name='comment']", "value": "同意", "label": "填写审批意见" },
    { "type": "click", "selector": "button[data-action='approve']", "label": "点击同意", "risk": "write" }
  ]
}
```

Supported first-version action types are `assertText`, `extractText`, `click`, `fill`, `input`, `type`, `select`, `check`, `uncheck`, and `submit`. Prefer stable CSS selectors; XPath is supported with `xpath=` or leading `//`.