Markdown

Workflows 概览

声明式多步 Agent DAG，使用能力衰减的隔离步骤。

工作流是声明式多步 Agent 流水线：每个节点交给隔离且能力衰减的子 Agent，依赖关系形成 DAG，步骤状态和副作用全部进入审计。

flowchart TD
scan[scan / scout] --> bugs[bugs / reviewer]
scan --> perf[perf / reviewer]
bugs --> report[report / writer]
perf --> report

两个并行审查分支汇入报告步骤。

编写工作流

工作区工作流放在 .carina/workflows/，用户级覆盖放在 ~/.carina/workflows/。

{
  "name": "review",
  "description": "并行审查后汇总报告",
  "steps": [
    {"id":"scan","agent":"scout","task":"List changed files."},
    {"id":"bugs","agent":"reviewer","task":"Review:\n${scan}","needs":["scan"]},
    {"id":"report","agent":"writer","task":"Synthesize:\n${bugs}","needs":["bugs"]}
  ]
}

${step_id} 插入已完成依赖的完整输出。
needs 是步骤顺序的权威约束。
没有相互依赖的 ready 步骤可以并行。
示例：examples/workflows/review.json。

运行与控制

carina workflow run review
carina workflow run review "focus on auth"
carina workflow run review --background
carina workflow list
carina workflow status RUN_ID
carina workflow pause RUN_ID
carina workflow resume RUN_ID
carina workflow stop RUN_ID
carina workflow restart RUN_ID

前台运行会等待终态；除 completed 外的终态都会返回非零退出码。pause 只停止接纳新 ready 节点，已经运行的步骤可以完成。

执行模式

BSP（默认）

按依赖层批量运行：同层全部完成后进入下一层。规则直观，但一个慢步骤会阻塞同层推进，单步失败终止整个 run。上限 64 步。

Streaming

{"execution_mode":"streaming"}

依赖一满足就立即调度，适合耗时差异大的图。默认只阻断失败节点的下游；在步骤设置 "fail_fast": true 可恢复全局终止。上限 1000 步。

权限与恢复

每个步骤的 profile 都是外层会话能力的子集。需要写入时，建议先让并行 reviewer 保持只读，再把变更集中到一个人工检查点之后的 patch 步骤。durable run 可以查询、暂停和重启，但恢复不会绕过当前策略。

权威来源

叙述：docs/workflows.md · schema：protocol/schemas/workflow-graph.schema.json
示例：examples/workflows/
CLI：carina workflow run|list|status|pause|resume|stop|restart
相关：子 Agent · 策略 · Workers

下一步

审查教程 — 端到端流水线
常用工作流 — 日常配方

这个页面有帮助吗？

本次会话中每个页面仅记录一次投票。