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 |
scripts/selftest.py
View on GitHub#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""flow-walkthrough 自检脚本:环境检查 + golden 走查构建断言。
用法: python3 scripts/selftest.py
退出码: 0 = 全部通过;1 = 存在失败项。
"""
import sys
if hasattr(sys.stdout, "reconfigure"):
sys.stdout.reconfigure(encoding="utf-8")
sys.stderr.reconfigure(encoding="utf-8")
import json
import os
import subprocess
import sys
import tempfile
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
BUILD = os.path.join(HERE, "build.py")
results = []
def check(name, ok, detail=""):
results.append((name, bool(ok)))
print("%s %s%s" % ("PASS" if ok else "FAIL", name, (" [%s]" % detail) if detail and not ok else ""))
def run(args):
return subprocess.run([sys.executable, BUILD] + args, capture_output=True, text=True, encoding="utf-8")
def main():
check("python 版本 >= 3.8", sys.version_info >= (3, 8), sys.version.split()[0])
tmp = tempfile.mkdtemp(prefix="flowwalk-selftest-")
out = os.path.join(tmp, "walkthrough.html")
p = run([os.path.join(ROOT, "examples", "walkmap.json"), "-o", out])
check("golden 走查构建成功", p.returncode == 0, (p.stderr or p.stdout).strip()[:120])
if p.returncode == 0:
rep = json.loads(p.stdout.splitlines()[0])
check("页面数 = 13", rep["pages"] == 13, str(rep["pages"]))
check("状态组数 = 2", rep.get("state_groups") == 2, str(rep.get("state_groups")))
check("映射节点数 = 15", rep["nodes"] == 15, str(rep["nodes"]))
check("SVG 节点与映射一致(无警告)", not rep["warnings"], "; ".join(rep["warnings"])[:100])
html = open(out, encoding="utf-8").read()
check("单文件产物含嵌入 SVG", 'data-flowspec="1"' in html)
check("联动脚本存在", "setViewByNode" in html and "goNode" in html)
check("画布拖拽/缩放存在", "pointerdown" in html and "setZoom" in html)
check("画布全屏切换存在", "toggleFs" in html and "退出全屏" in html)
check("选中框定位逻辑存在", "sel-ring" in html and "getBBox" in html)
check("全部页面均已内联", all(('id="p-%s"' % x) in html for x in
["login", "home-none", "form", "form-prefill", "form-full", "home-pending", "admin",
"home-declined", "home-deposit", "cashier", "diary", "home-success", "admin-create"]))
check("模板含扩展线框组件", all(c in html for c in [".wt-screen", ".wt-statusbar", ".wt-nav", ".wt-list-item",
".wt-modal", ".wt-dialog", ".wt-toast", ".wt-browserbar", ".wt-table"]))
check("示例页面用到了扩展组件", all(c in html for c in ['class="wt-statusbar"', 'class="wt-modal"', 'class="wt-table"']))
check("页面状态切换已渲染", "renderStates" in html and '"home"' in html and '"form"' in html and "st-btn" in html)
check("代表节点自动归属状态", '"state": "home/success"' in html and '"state": "form/full"' in html)
emoji = [ch for ch in html if 0x1F000 <= ord(ch) <= 0x1FAFF or 0x2600 <= ord(ch) <= 0x27BF]
check("产物无 emoji", not emoji, "".join(emoji[:5]))
# 错误场景:引用不存在页面必须明确报错
badmap = os.path.join(tmp, "bad.json")
with open(badmap, "w", encoding="utf-8") as f:
json.dump({"spec": "walkmap/1", "svg": "../examples/pet-boarding.svg",
"pages": [], "nodes": {"A": {"page": "p-nope"}}}, f)
p = run([badmap, "--check"])
ok = p.returncode != 0 and "未定义页面" in (p.stdout + p.stderr)
check("坏映射明确报错", ok, (p.stdout + p.stderr).strip()[:100])
# 状态组错误场景:单状态组、引用未定义节点、节点 state 不在组里 都必须报错
badst = os.path.join(tmp, "badstate.json")
with open(badst, "w", encoding="utf-8") as f:
json.dump({"spec": "walkmap/1", "svg": "../examples/pet-boarding.svg",
"pages": [{"id": "p", "frame": "phone", "file": "../examples/pages/login.html"}],
"state_groups": {"g1": {"title": "x", "states": [{"id": "a", "label": "A", "node": "A"}]},
"g2": {"title": "y", "states": [{"id": "a", "label": "A", "node": "A"},
{"id": "b", "label": "B", "node": "ZZ"}]}},
"nodes": {"A": {"page": "p"}, "B1": {"page": "p", "state": "nope/x"}}}, f)
p = run([badst, "--check"])
txt = p.stdout + p.stderr
check("单状态组报错", p.returncode != 0 and "只有 1 个状态" in txt, txt.strip()[:100])
check("状态引用未定义节点报错", "引用了未定义节点 ZZ" in txt, txt.strip()[:100])
check("节点 state 不在组里报错", "不在任何状态组里" in txt, txt.strip()[:100])
# 状态组警告场景:两个状态共用同一页面
warnst = os.path.join(tmp, "warnstate.json")
with open(warnst, "w", encoding="utf-8") as f:
json.dump({"spec": "walkmap/1", "svg": "../examples/pet-boarding.svg",
"pages": [{"id": "p", "frame": "phone", "file": "../examples/pages/login.html"}],
"state_groups": {"g": {"title": "x", "states": [{"id": "a", "label": "A", "node": "A"},
{"id": "b", "label": "B", "node": "B1"}]}},
"nodes": {"A": {"page": "p"}, "B1": {"page": "p"}}}, f)
p = run([warnst, "--check"])
rep = json.loads(p.stdout) if p.stdout.strip().startswith("{") else {"warnings": []}
check("两个状态共用同一页面给警告", any("使用同一页面" in w for w in rep.get("warnings", [])), (p.stdout + p.stderr).strip()[:100])
fails = [r for r in results if not r[1]]
print("\n%d/%d 通过" % (len(results) - len(fails), len(results)))
if fails:
print("失败项:" + "; ".join(r[0] for r in fails))
sys.exit(1)
print("flow-walkthrough 自检全部通过")
if __name__ == "__main__":
main()
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: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | 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: 321k | 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: 321k | Updated | Claude CodeCodex | Verified | Install |