画工作流 <要做的事>(a129-flowgen).claude/skills/a129-flowgen/SKILL.md + 工具 MetaZero-OS/scripts/flowgen.py + 规范页 v1.2> "我有一些想做的工作流,或者是一些技能文件,想把它变成这个项目里的一个工作流。可以有一个指令吗?
> 我把要做的事加在指令后面,它就自动套用这个项目的格式,画出整个工作流,方便我修改,
> 最后能直接提取工作流的另一种文字表示(带循环那些)。"
| 环节 | 原本有没有 | 位置 |
|---|---|---|
| 工作流的文字格式(FlowText) | ✅ 有规范 v1.1 | web/terminal/batch/flow-dsl.html |
| 文字 → 图(解析器) | ✅ 有 | sandbox-board.html 的 importText |
| 图 → 文字(导出说明书 / Agents版) | ✅ 有,顶栏「📋 生成」 | sandbox-board.html genText/genAgentText |
| 文字 → 真执行(多 agent) | ✅ 有 | skill a129-flowrun |
| 现成案例 | ✅ 145 例 | web/terminal/batch/cases.json |
| 一句话 → 自动写出合格 FlowText + 校验 + 直开链接 | ❌ 只缺这一半 | 本次补上 |
结论:不新建平行系统,只补缺口(Rule-DEDUP-001)。
a129-flowgen触发口令(任一):画工作流 <要做的事> / flowgen <要做的事> / 工作流:<要做的事> /
做条工作流 <要做的事> / 把技能<名>变成工作流 / flowgen 技能:<名>。
它规定了"什么算一条合格工作流":入口必须是清单节点、每步一个动作且冒号后必须写验收标准、
互不依赖的步骤并联、批量/多轮一律用循环行(不许复制 N 份步骤)、承重工作流必须单列质量闸步骤
(对应 flowrun 的执行者≠验证者)、5–12 步为宜、回路只能用循环表达。
MetaZero-OS/scripts/flowgen.py`
spec 打印写法速查(我照着写,不靠记忆)
lint <文件> 解析仿真 + 校验(坏引用/重复编号/成环/循环成员/嵌套父/清单空格/孤儿步骤)
link <文件> 生成画板直开链接(#t=base64)
make <文件> 校验 + 结构预览 + 直开链接 一条龙
from-skill <技能名> 从 SKILL.md 抽草稿骨架
case-add ... 校验通过才准写进案例库 cases.json
`
关键点:它把画板 importText 的解析规则(格式A 说明书 + 格式B 简易格式)在 Python 侧 1:1 复刻,
所以"命令行说会成什么图"="画板真会成什么图"。
1. 回归对齐(命门):拿案例库 145 例真实工作流逐条喂进我的解析器 —— 解析出错=0。
(第一版只认格式B,10 条格式A 案例报错 → 补格式A 解析后归零。)
2. 端到端真浏览器验证:本地起 http 服务 + Chromium 打开 make 生成的直开链接:
nodes=6 / edges=5 / loops=[L1:逐家公司, L2:逐个维度 parent=L1] / domNodes=6 / pageerror:无
—— 与命令行预测的结构完全一致,截图确认嵌套循环框(紫框套青框)正确渲染。
3. 线上一致性:线上 sandbox-board 与本地文件 md5 相同(1be6c3cf…),即本地验过的行为=线上行为。
4. 规范页 v1.2 已上线并验真:curl 线上 /batch/flow-dsl 已含 a129-flowgen 指引;运行时冒烟通过不黑屏。
1. 说一句 画工作流 我要做的事…(或 把技能a129-stock-combo变成工作流)。
2. 我给回:FlowText 文件 + 画板直开链接 → 点开即成图,手机也能拖拽改。
3. 改完在画板顶栏「📋 生成」→ 复制【执行说明书】或点【🤖 Agents版】,粘回对话说 flowrun 即真跑。
1. 最强反对:"from-skill 抽出来的只是 SKILL.md 的标题层级,不是真工作流步骤,算不算半成品?"
—— 成立。所以技能里写死:草稿只是起点,必须真读一遍正文把"章节名"改写成"动作+验收标准",
不许直接把草稿当成品交付。
2. 循环清单的静态边界:画板只能展开"入口节点里已写死的清单";引用运行时才产生的清单(如
引用S2的子任务清单)时画板只当 1 项 —— lint 会明确警告并给两条改法(清单放入口 / 改条件循环)。
案例库里有 35 例属于这种写法,是既有约定而非本次引入的 bug。
3. 未验证:线上真机点击直开链接的视觉验收(我在容器内用同版本 Chromium 验过本地同文件),
留给主席手机实点;若点开不成图即本次不合格,回炉。
可证伪锚:主席对任意一句需求说 画工作流 …,若返回的链接点开后画板节点数 ≠ 命令行预测的步骤数、
或循环框缺失,即校验器与画板未对齐,判不合格。