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/build.py
View on GitHub#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""flow-walkthrough 构建器(零依赖,Python 标准库)。
输入 walkmap JSON(契约见 contract/walkmap-v1.md):flow-canvas 产出的 SVG +
页面片段集合 + 节点到页面的映射与标注(可选:页面状态组 state_groups),
组装成单文件三栏联动 HTML。
用法:
python3 build.py walkmap.json -o out.html
python3 build.py walkmap.json --check # 仅校验,输出报告 JSON
"""
import sys
if hasattr(sys.stdout, "reconfigure"):
sys.stdout.reconfigure(encoding="utf-8")
sys.stderr.reconfigure(encoding="utf-8")
import argparse
import json
import os
import re
import sys
SPEC = "walkmap/1"
HERE = os.path.dirname(os.path.abspath(__file__))
TEMPLATE = os.path.join(os.path.dirname(HERE), "templates", "walkthrough.html")
EMOJI_RANGES = [(0x1F000, 0x1FAFF), (0x2600, 0x27BF), (0x2B00, 0x2BFF),
(0xFE0F, 0xFE0F), (0x2705, 0x2705), (0x274C, 0x274C)]
def find_emoji(text):
return [ch for ch in text if any(a <= ord(ch) <= b for a, b in EMOJI_RANGES)]
def main():
ap = argparse.ArgumentParser(description="flow-walkthrough 构建器")
ap.add_argument("walkmap")
ap.add_argument("-o", "--output")
ap.add_argument("--check", action="store_true")
args = ap.parse_args()
base = os.path.dirname(os.path.abspath(args.walkmap))
wm = json.loads(open(args.walkmap, encoding="utf-8").read())
errors, warnings = [], []
spec = wm.get("spec", "")
if not spec.startswith("walkmap/"):
errors.append("缺少 spec 字段(期望 %s)" % SPEC)
elif spec.split("/")[1].split(".")[0] != SPEC.split("/")[1]:
errors.append("walkmap 主版本不兼容:%s" % spec)
svg_path = os.path.join(base, wm.get("svg", ""))
svg = ""
if not os.path.isfile(svg_path):
errors.append("svg 文件不存在:%s" % wm.get("svg"))
else:
svg = open(svg_path, encoding="utf-8").read()
if 'data-flowspec="1"' not in svg:
errors.append("SVG 缺少 data-flowspec=\"1\" 契约标记(需要 flow-canvas flowspec/1 产物)")
pages, page_frame = {}, {}
for p in wm.get("pages", []):
f = os.path.join(base, p["file"])
if not os.path.isfile(f):
errors.append("页面文件不存在:%s" % p["file"])
continue
pages[p["id"]] = open(f, encoding="utf-8").read()
page_frame[p["id"]] = p.get("frame", "phone")
nodes = wm.get("nodes", {})
for nid, meta in nodes.items():
if meta.get("page") not in pages:
errors.append("节点 %s 引用了未定义页面 %s" % (nid, meta.get("page")))
# 页面状态组:同一页面的多个状态互切(右侧「页面状态切换」)
groups = wm.get("state_groups", {}) or {}
state_owner = {}
if not isinstance(groups, dict):
errors.append("state_groups 必须是对象:{组id: {title, states:[...]}}")
groups = {}
for gid, g in groups.items():
states = g.get("states") or []
if len(states) < 2:
errors.append("状态组 %s 只有 %d 个状态:单状态页面不建组、右侧不放按钮" % (gid, len(states)))
seen_page = {}
for st in states:
sid, rep = st.get("id"), st.get("node")
if not sid or not st.get("label"):
errors.append("状态组 %s 的状态缺少 id 或 label" % gid)
continue
if rep not in nodes:
errors.append("状态组 %s 的状态 %s 引用了未定义节点 %s" % (gid, sid, rep))
continue
key = "%s/%s" % (gid, sid)
declared = nodes[rep].get("state")
if declared and declared != key:
errors.append("节点 %s 是状态 %s 的代表节点,但又声明了 state=%s" % (rep, key, declared))
nodes[rep]["state"] = key
state_owner[key] = rep
pg = nodes[rep].get("page")
if pg in seen_page:
warnings.append("状态组 %s 的状态 %s 与 %s 使用同一页面 %s:页面无差异就不是真正的状态,建议合并"
% (gid, seen_page[pg], sid, pg))
seen_page[pg] = sid
for nid, meta in nodes.items():
st = meta.get("state")
if not st:
continue
if st not in state_owner:
errors.append("节点 %s 的 state=%s 不在任何状态组里" % (nid, st))
elif meta.get("page") != nodes[state_owner[st]].get("page"):
warnings.append("节点 %s 声明状态 %s,但页面 %s 与该状态代表节点 %s 的页面不同"
% (nid, st, meta.get("page"), state_owner[st]))
svg_nodes = set(re.findall(r'data-node="([\w-]+)"', svg))
map_nodes = set(nodes.keys())
for nid in sorted(svg_nodes - map_nodes):
warnings.append("SVG 节点 %s 未配置映射(点击将无响应)" % nid)
for nid in sorted(map_nodes - svg_nodes):
warnings.append("映射中的节点 %s 在 SVG 里不存在" % nid)
default = wm.get("default_node") or (sorted(map_nodes)[0] if map_nodes else "")
if default and default not in nodes:
errors.append("default_node %s 不在映射中" % default)
report = {"pages": len(pages), "nodes": len(nodes), "svg_nodes": len(svg_nodes),
"state_groups": len(groups), "errors": errors, "warnings": warnings}
if args.check or errors:
print(json.dumps(report, ensure_ascii=False, indent=1))
sys.exit(1 if errors else 0)
if not args.output:
raise SystemExit("错误:需要 -o 指定输出文件(或使用 --check)")
def page_divs(frame):
out = []
for pid, html in pages.items():
if page_frame[pid] == frame:
out.append('<div class="page" id="%s">\n%s\n</div>' % (pid, html))
return "\n".join(out)
css_vars = "".join(" %s: %s;\n" % (k, v) for k, v in wm.get("css_vars", {}).items())
html = (open(TEMPLATE, encoding="utf-8").read()
.replace("__TITLE__", wm.get("title", "流程走查"))
.replace("__CSS_VARS__", css_vars)
.replace("__SVG__", svg)
.replace("__PAGES_PHONE__", page_divs("phone"))
.replace("__PAGES_WIDE__", page_divs("wide"))
.replace("__NODES_JSON__", json.dumps(nodes, ensure_ascii=False))
.replace("__STATE_GROUPS_JSON__", json.dumps(groups, ensure_ascii=False))
.replace("__PAGE_FRAME_JSON__", json.dumps(page_frame, ensure_ascii=False))
.replace("__DEFAULT__", default))
bad = find_emoji(html)
if bad:
raise SystemExit("错误:产物含 emoji 字符 %s" % bad[:5])
with open(args.output, "w", encoding="utf-8", newline="\n") as f:
f.write(html)
print(json.dumps(report, ensure_ascii=False))
print("已生成 %s" % args.output)
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 |