Skip to main content

​
Run 对象

Run 是一次具体执行。它像锁版印刷：执行开始后，必须冻结当时的 Flow、Profile、Skill binding 和 Policy，避免后续修改影响复盘。

​
spec 字段

字段要求说明
flowRef必填指向要执行或解释的 Flow。
profileRefs可选本次 Run 追加或覆盖的 Profile。
policyRefs可选本次 Run 使用的 Policy。
bindings可选capability 到具体 Skill / Adapter 的解析。
snapshot推荐锁定 hash、generation 和 resolved refs。
mode可选explain、dryRun、execute。

​
最小示例

apiVersion: huoban.dev/v1alpha1
kind: Run
metadata:
  name: idea-to-spec-review-20260623
spec:
  flowRef:
    name: idea-to-spec-review
    generation: 4
  profileRefs:
    - name: huoban-project
      generation: 2
  mode: dryRun
  snapshot:
    flowSpecHash: sha256:...
    profileSpecHash: sha256:...
    skillBindingHash: sha256:...

​
status 字段

字段说明
phase当前阶段，例如 Planned、Running、WaitingForCheckpoint、Completed。
observedGenerationstatus 对应的 Run generation。
currentStage当前 stage id。
conditions细粒度状态。
observedSideEffects实际观测到的副作用。
artifacts产物引用。

​
常见 conditions

  • RunPlanned
  • StageStarted
  • ArtifactProduced
  • CheckpointRequired
  • CheckpointApproved
  • UndeclaredSideEffectObserved
  • RunCompleted
  • RunFailed

​
设计约束

正在执行的 Run 不应悄悄切换到新版本 Flow 或 Profile。用户修改 Flow 后，应创建新的 Run 或明确 resume 策略。