如何用 Beads 把 TOML formula 实例化为 molecule 并执行工作流步骤-北京尧图网络

如何用 Beads 把 TOML formula 实例化为 molecule 并执行工作流步骤【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads你手里有一个用 TOML 写好的工作流模板formula想把它变成 beads 项目里一组真实可执行的工作项然后按依赖顺序一步步推进直到完成。这条路径在 Beads 里是固定的三步formula 经bd cook变成 proto模板 epic再经bd mol pour实例化为 molecule带父子关系和依赖边的 issue 图最后用bd ready/bd update --claim/bd close循环执行各步骤。本文基于 Formulas 文档、Molecules 文档和 cook 命令参考给出完整操作路径。前提bd已可用且你当前处于一个 beads 项目里项目内存在.beads/目录formula 搜索路径会解析到它。写好 TOML formula 并放入搜索目录formula 是声明式工作流模板推荐用 TOML 编写。最小可用结构包含顶层formula名称、type标准步骤序列用workflow、[vars.*]变量定义、[[steps]]步骤定义。仓库自带的 feature-workflow 示例可以直接作为起点formula feature-workflow description Standard feature development workflow: design, implement, review, merge. version 1 type workflow [vars.feature_name] description Name of the feature to implement required true [[steps]] id design title Design {{feature_name}} type human [[steps]] id implement title Implement {{feature_name}} needs [design] [[steps]] id test title Run test suite needs [implement] [[steps]] id review title Code review needs [test] type human [[steps]] id merge title Merge to main needs [review]几个要点步骤通过needs声明依赖没有needs的步骤之间没有顺序关系。变量支持required、default、pattern、enum约束步骤标题里用{{变量名}}引用。步骤的type决定生成的 issue 类型默认task可选bug、feature、epic、chore人工签核不用 step type 表达而是用[steps.gate]块见 Gates 文档。formula 的搜索目录按顺序为resolved-beads-dir/formulas/当前项目、checkout-root/.beads/formulas/、~/.beads/formulas/用户级、$GT_ROOT/.beads/formulas/设置了GT_ROOT时见 formula 命令参考。把文件放到项目级或用户级目录即可例如# 把示例 formula 复制到项目级目录在 formula 文件所在目录执行 cp feature-workflow.formula.toml .beads/formulas/ # 或放到用户级所有项目可见 cp feature-workflow.formula.toml ~/.beads/formulas/复制位置依据 examples/formulas/README.md 中的用法说明。确认 formula 对 bd 可见# 列出所有搜索路径上可见的 formula bd formula list # 查看某个 formula 的变量、步骤与依赖详情 bd formula show feature-workflow # 专门验证 formula 可访问、可 cook做 pre-flight 检查 bd mol seed feature-workflowbd formula list应能看到你刚放入的feature-workflow。如果 formula 里含 gate 块pour 之前建议用bd formula show formula --json核对解析结果——TOML 中的未知键会被静默丢弃。可选先用 bd cook 预览解析结果bd cook有两种模式见 cook 命令参考编译期默认--modecompile{{variable}}占位符原样保留适合建模、估算、交接运行期--moderuntime或提供了任意--var变量被实际替换要求所有变量都有值--var提供或 formula 里的默认值。默认情况下 cook 只把解析后的 formula 以 JSON 打印到 stdout不写数据库# 编译期保留 {{feature_name}} 占位符 bd cook feature-workflow # 运行期替换变量看 pour 之前每一步的确切标题 bd cook feature-workflow --var feature_namedark-mode # 预览将要创建的内容 bd cook feature-workflow --dry-run--persist会把 proto 写进数据库ID 与 formula 名一致、带template标签这是旧版行为适合同一个 proto 反复复用大多数工作流不需要它因为bd mol pour可以直接接收 formula 名并内联 cook。把 formula 实例化为 molecule对持久化工作需要审计记录、跨多个会话用bd mol pour# 先预览将要创建的 root 和子步骤 bd mol pour feature-workflow --var feature_namedark-mode --dry-run # 确认无误后正式 pour bd mol pour feature-workflow --var feature_namedark-mode--var的值必须匹配 formula 中[vars.*]的约束例如 release 示例中version要求符合^\d\.\d\.\d$。pour 成功后会创建一个 molecule root issue如bd-xyz和一组子步骤 issuebd-xyz.1、bd-xyz.2等root 与子步骤之间是父子关系步骤之间按needs连成依赖边结果持久化在.beads/中并随 git 同步。记下输出中的 root ID下文以molecule-id指代它。可选分支如果工作不需要审计记录一次性发布流程、运维循环、健康检查用bd mol wisp proto --var ...创建临时 wisp 而不是 pourformula 中声明phase:vapor时 pour 会给出警告提示该公式更适合 wisp见 mol 命令参考。验证 molecule 结构与 ready 前沿# 查看 molecule 结构、变量与步骤 bd mol show molecule-id # 高亮当前可并行运行的步骤 bd mol show molecule-id --parallel # 查看完整层级 bd dep tree molecule-id # 只列出该 molecule 中依赖已全部完成、可以立即执行的步骤 bd ready --mol molecule-idbd ready --mol只返回没有活跃 blocker 的步骤这正是执行入口ready 命令参考。按 ready → claim → close 循环执行步骤多会话执行循环来自 Molecules 文档# 1. 拿 ready 工作 bd ready --mol molecule-id # 2. 认领一个步骤 bd update bd-xyz.1 --claim # 3. 完成实际工作后关闭 bd close bd-xyz.1 --reason Done # 4. 再查下一次 ready 的步骤重复直到 molecule 完成 bd ready --mol molecule-id三条容易踩的坑文档明确列出子步骤默认并行。步骤编号或名字里的 1/2/3 不产生顺序只有显式依赖formula 里的needs、线上用bd dep add B-id A-id依赖方在前才会串行化。别忘了关闭工作。上游步骤不 close下游会永远 blocked用bd close id --reason Done收尾并用bd blocked检查是谁在等谁。依赖方向别写反。Phase 2 needs Phase 1 对应bd dep add phase2 phase1写完用bd blocked验证。如果 formula 步骤带[steps.gate]块实例化时会生成 gate issue 并作为该步骤的 blockergate 关闭前该步骤不会进入 ready。人工 gate 用bd gate resolve gate-id关闭timer 和 GitHub gate 用bd gate check评估真实世界状态后自动关闭详见 Gates 文档。跟踪进度并收尾# 逐步状态[done] / [current] / [ready] / [blocked] / [pending] bd mol current molecule-id # 进度摘要completed/total、速率、ETA bd mol progress molecule-id注意一个生命周期细节关闭最后一个子步骤不会自动关闭 molecule rootepic 会保持 open 直到显式关闭。收尾阶段可选bd mol squash molecule-id把临时子 issue 压缩成一个持久 digest issuebd mol burn molecule-id直接删除 molecule、不产生 digest——这是破坏性操作数据会永久丢失仅用于放弃的流程或测试运行建议先bd mol burn id --dry-run预览bd mol stale列出子步骤全部关闭但 root 仍 open的 molecule用于发现漏收尾的工作。完成状态的判定依据bd mol current molecule-id中所有步骤显示[done]或bd mol progress显示 completed 等于 total。之后你得到的是一组按依赖顺序执行完毕的 issue 记录root epic 可按需显式关闭。【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

如何用 Beads 把 TOML formula 实例化为 molecule 并执行工作流步骤

相关推荐

SQL时间截取全指南：日期函数、性能优化与避坑实践

合泰BS84C12C触摸库LIBV413 V3详解：库结构与灵敏度校准

oh-my-pi snapcompact 抽取式 QA 探针：qa-text.md 提示词设计与文本载体验证管线解析

更多资讯

Bun 运行时深度解析：性能原理、迁移实践与工程选型指南

Roo Code 2.2.21：基于预测文件长度的截断写入检测可靠性改进解析

Excel时间差计算全指南：从跨午夜陷阱到工时统计实战

Qt工业软件实战：激光焊接控制系统的PLC通信与权限设计

新手也能上手！盘点2026年实力封神的的AI论文网站

如何用 Beads 把 TOML formula 实例化为 molecule 并执行工作流步骤

今日更新

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？