roxorlt/UEmaster / skills/flow-walkthrough
flow-walkthrough
Verified三栏流程联动原型——左侧流程图节点可点击,右侧同步展示对应原型页面,中间自动切换手机框/后台宽窗口。触发:流程联动原型、点流程节点看页面、评审演示页、需求走查 demo、过流程用的演示、流程图和原型联动、flow walkthrough、clickable flowchart linked to prototype pages、prototype walkthrough / product review demo。不适用:只要流程图(用 flow-canvas)、只要原型页面无流程联动诉求。
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| README.md | markdown | 2.1 KB |
| SKILL.md | skill md | 7.2 KB |
| agents/interface.yaml | config | 1.2 KB |
| contract/walkmap-v1.md | markdown | 2.6 KB |
| examples/pages/admin-create.html | other | 614 B |
| examples/pages/admin.html | other | 701 B |
| examples/pages/cashier.html | other | 903 B |
| examples/pages/diary.html | other | 905 B |
| examples/pages/form-full.html | other | 920 B |
| examples/pages/form-prefill.html | other | 617 B |
| examples/pages/form.html | other | 525 B |
| examples/pages/home-declined.html | other | 572 B |
| examples/pages/home-deposit.html | other | 546 B |
| examples/pages/home-none.html | other | 891 B |
| examples/pages/home-pending.html | other | 482 B |
| examples/pages/home-success.html | other | 544 B |
| examples/pages/login.html | other | 417 B |
| examples/pet-boarding.mmd | other | 1.2 KB |
| examples/pet-boarding.svg | other | 11.4 KB |
| examples/walkmap.json | config | 6.4 KB |
| manifest.json | config | 326 B |
| references/page-guide.md | markdown | 6.6 KB |
| scripts/build.py | script | 6.8 KB |
| scripts/selftest.py | script | 6.0 KB |
| templates/walkthrough.html | other | 15.1 KB |
README.md
View on GitHub# flow-walkthrough
三栏流程联动原型的 Agent Skill:左侧是 [flow-canvas](../flow-canvas/README.md) 产出的正交流程图画布(可点击、可缩放拖拽),点节点右侧同步展示对应原型页面,中间设备框自动在手机框 / 后台宽窗口间切换,右栏展示节点标注;页面有多个状态(弹窗 / toast / 只读态等)时右栏给出「页面状态切换」按钮,同一页面的状态之间可来回切,单状态页面不显示。产出单文件 HTML,离线可用,适合需求评审时"过流程"演示。
## 信任声明
- **零第三方依赖**:仅 Python 3.8+ 标准库
- **无网络请求**:任何阶段不访问网络
- **文件写入范围**:仅调用方指定的输出路径
- 产物为静态单文件 HTML,零运行时依赖
## 安装
本 skill 和 flow-canvas 放在同一个仓库 [UEmaster](../../README.md) 里,需要一起安装,方法见仓库根目录的 README。
安装后自检(Windows 上把 `python3` 换成 `python`):
```bash
python3 scripts/selftest.py
```
## 直接当 CLI 用
```bash
python3 scripts/build.py examples/walkmap.json -o walkthrough.html
python3 scripts/build.py examples/walkmap.json --check
```
打开 `walkthrough.html` 即可看到内置示例:虚构的「宠物寄养预约」完整走查(登录 → 选门店预约 → 门店确认 → 支付定金 → 预约成功),包含两组多状态页面和两个后台宽窗口页面。
## 输入契约
见 [contract/walkmap-v1.md](contract/walkmap-v1.md)。上游依赖 flow-canvas 的 flowspec/1 SVG 契约;页面片段可使用模板内置 `wt-*` 组件类与 `goNode(id)` 联动 API;`state_groups` 定义页面状态组,驱动右栏的「页面状态切换」。
## 工作流(agent 执行时)
1. 拿到流程 SVG(没有则先调 flow-canvas)与页面材料(原型 HTML / PRD / 无)
2. 自动生成节点-页面关联,**先输出关联确认表给用户过目**(含匹配依据与置信度)
3. 确认后构建单文件走查页;构建器校验契约版本、映射完整性、无 emoji
## License
MIT
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |