lubancode-workflow
设计、审查或修改 LubanCode Workflow 时使用;把自然语言任务拆成有界、可校验、可恢复的图,选择 Node、Batch、Parallel、Branch、Shared、Looping、Nesting 与 Async,并生成或修订 workflow 包。普通一次性 Agent 任务不必使用。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-13
- Stars
- ★ 7
- Forks
- 2
01 前言 Front Matter
- name
- lubancode-workflow
- description
- 设计、审查或修改 LubanCode Workflow 时使用;把自然语言任务拆成有界、可校验、可恢复的图,选择 Node、Batch、Parallel、Branch、Shared、Looping、Nesting 与 Async,并生成或修订 workflow 包。普通一次性 Agent 任务不必使用。
02 资源文件 1
- 参考文档agents/openai.yaml216 B
03 SKILL.md 正文
LubanCode Workflow
官方文档根固定为 <技能目录>/../../docs。设计或审查 workflow 时,先读
features/workflows/designing-workflows.md;要写 YAML,再读
reference/workflow-schema.md;碰到 Async、恢复、取消或 journal,再读
architecture/workflow-runtime.md。用真实绝对路径打开,不把占位文字当目录。
先确认用户要的是可复用流程,不是一场临时探索。根据任务复杂度问必要问题;只问 会改变输入、产物、权限、失败路或图形的岔口,不固定问几轮。
设计时交付一张短账:
- 输入与最终产物。
- 节点表:每只节点的职责、种类、读值、写值、外部能力。
- Flow:入口、outcome、失败路与收口。
- Store 数据合同。
- 预算、权限、副作用、幂等与恢复边界。
按任务选原语,不求凑齐:
- 一步一责用 Node;先后关系由 Flow 的 edge 表达。
- 同一套活跑数组用 Batch:独立项选 map,有依赖或怕限流选 foreach,归并用 reduce。
- 多路互不依赖才用 Parallel;先选 all、all_settled、any、quorum 或 race。当前 runtime 会等全部分支归队,不把 any/quorum/race 当提前返回。
- 结果择路用 outcome、switch 或 fallback,条件只读结构化 Store。
- 按本轮质量决定是否再来,用 Looping。普通 edge 不得回环;loop 必有 until、软帽与定义硬帽。
- 成熟、独立、已有输入输出合同的整段流程才用 Nesting/subflow;当前
subflow_version尚不约束 resolver,须另验目标定义。 - 一只长 I/O 要等待并响应取消、总时限时用 Async。Async 不是 fan-out,也不是 fire-and-forget;多路同时跑仍用 Parallel。
写包前查真实能力:已有工具、Skill、transform、workflow 与宿主 executor 叫什么,
便写什么。不得杜撰能力。包落在
<project>/.lubancode/workflows/<id>/ 或 ~/.lubancode/workflows/<id>/,
workflow.yaml 直接住根,prompt 与模板用安全相对路径。
若用户只要设计,给预览与图便停,不落盘。若用户要创建或修改,先查目标目录; 已有定义不擅自覆盖。落盘后至少运行:
/workflow validate <id>
/workflow graph <id> ascii
能从当前环境跑真实 workflow 时,再用一份最小输入验成功路与失败路。不能运行便 明说验到了哪一层。
副作用节点若会 retry、loop 或 async 重放,必须有稳定 idempotency_key。
max_steps 要算进主图、loop 与 async body;Batch 另守 max_nodes。最终 result
只引用每条成功收口路径都有的产物。
04 同仓库更多 Skills
release-notes
汇一份发版说明。用户要写 release note、变更纪要或版本公告时使用;先读变更记录再动笔。
browser-testing
网页冒烟验收的章法:摘要、核对、给证据。要检查页面结构、链接、表单或按清单验收网页时使用。
packer
打包前清点文件。要核对目录内容、发布清单或打包完整性时使用。
packer
打包前清点文件。要核对目录内容、发布清单或打包完整性时使用。
release_check
名字两处坏:下划线不合规;目录叫 audit,名却叫 release_check,对不上。
release-check
发版前核对版本、测试与产物。本件内容无辜,坏在目录名:顶层是 skill/,少了末尾的 s。