断点续跑
Checkpoint 把 flow 拆成可记录的步骤，中断后用同一个 run-id 续跑，已完成步骤零重复执行。
flowcast轻量 workflow 编排框架
断点续跑 · HITL · 多 CLI/agent 调度 · 自改安全沙箱 · 质量门，以及其上的 L3 codegen 编排层。最小依赖（仅 agentproc SDK）· 纯 ESM · Node ≥ 20。
Skip to content
人工介入（HITL）
可插拔 HITL 后端（terminal / 企业微信），在关键节点阻塞等人工决策或单向通知，支持异步协作。
多 CLI/agent 调度
claude / cursor / gemini / codex / aider / recursive 各有 adapter，统一 runAgent 驱动，可路由、可并行、可互换。
自改安全沙箱
withSelfModGuard 在 git baseline 上隔离自改，质量门失败硬回滚，让 agent 安全地改自己的代码。
质量门
runGate / runGates 把测试、lint、构建等检查纳入 flow，失败可 rollback / resume-fix / autofix。
L3 codegen 编排
编排需求 → 动态生成 flow 代码 → 校验（语法 + import 白名单 + dry-run）→ 隔离执行（续跑锁定）。不做 DAG。
并发子 flow
fanOut 限并发 + worktree 隔离 + 每任务日志 + 结果汇总；runFlow 把一条 flow 当隔离子进程跑。
可观测看板
扫描 .flowcast/runs 与 worktree，重建父子运行树、推断僵尸进程，生成只读单文件 HTML 看板。
最小依赖
运行时仅依赖 agentproc SDK，纯 ESM，配置与密钥全部外置（${ENV} 运行时插值），明文永不入仓。
三层架构
flowcast 的核心心智模型是把"自我迭代"拆成三层，每层职责单一、可独立组合：
L3 编排层 (orchestrator/) 接单 → 动态生成 flow 代码 → 校验 → 执行（续跑锁定）
L2 引擎 (核心原语) 定义并跑好「单个 flow」：Checkpoint / 自改沙箱 / 质量门 / HITL / dry-run
L1 执行器 (adapters.js + executor.js) 怎么驱动一个 CLI/agent + provider 能力分层 + 路由- L1 执行器：把各种 coding agent（Claude / Cursor / recursive 内核 …）当作可互换、可路由、可并行的无状态 worker。
- L2 引擎：flowcast 本体——把一个 flow 跑得可审计、可观测、可断点续跑。原语都是一等公民，flow 只是它们的薄编排。
- L3 编排：更高一层的任务调度器——接单、分拆需求、动态生成 flow 代码并跨 agent 调度。codegen 为唯一主路径，不做 DAG。
30 秒上手
bash
# 1. 全局安装 CLI
npm install -g flowcast
# 2. 在你的目标仓里装包（orchestrate 生成的 flow 会 import flowcast）
cd <你的目标仓> && npm install flowcast
# 3. 扫描本机环境并生成配置（新用户第一步，交互式）
flowcast init
# 4. 把一段编排需求交给 flowcast：生成多步 flow → 校验 → 执行
flowcast orchestrate "把 README 里的 TODO 清单逐条实现" --repo .
# 先 dry-run 验证骨架（不烧 API、不跑构建）
FLOWCAST_DRY_RUN=1 flowcast orchestrate "审计 src/ 的 lint 问题并修复" --repo .orchestrate 适合什么？
多步骤、可中断、需要断点续跑的任务（如「审计并修复 lint 后跑测试」「逐条实现 TODO 清单」）。 一句话能搞定的单步任务，直接在 claude/cursor 里说一句即可，不必用 orchestrate。