AIOX工作流YAML编写指南自己定义多代理编排流程【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-coreAIOX工作流YAML是Synkra AIOS框架中定义多代理协作编排的核心配置格式。通过一份结构化的YAML文件你可以把谁先做、谁后做、失败了怎么办全部写清楚让多个AI代理按你的设计自动接力完成任务——无需逐条下指令。 30秒理解工作流 你的AI项目流水线在深入YAML语法之前先建立一个直觉概念一句话解释生活类比Workflow工作流多代理协作的完整定义一条装配线Phase阶段逻辑分组的步骤集合装配线的工序段Step步骤单个代理执行的一个动作装配线上的一个工位Transition转移步骤间的流转条件工位之间的传送带State状态跨会话的进度记录装配线的工单一个典型的多代理编排长这样——SM写需求 → PO验收 → Dev实现 → QA把关四个角色自动接力┌─────────────────────────────────────────────────────────────┐ │ AIOX 多代理编排流程Story Cycle │ │ │ │ sm:创建Story → po:10点校验 → dev:编码测试 → qa:门禁│ │ │ │ │ │ │ │ ▼ ▼ ▼ ▼ │ │ Draft Story Ready / 打回 代码单测 Quality Gate│ └─────────────────────────────────────────────────────────────┘这套流程的完整定义就在 story-development-cycle.yaml 里一个文件管住四个代理的协作顺序。 工作流YAML文件结构速览AIOX工作流文件由三大块组成从上到下依次是元信息 → 阶段划分 → 步骤序列顶层字段作用必填workflow工作流的身份卡片ID、名称、版本、类型✅phases把步骤分成若干逻辑阶段✅sequence逐步定义每个动作谁做、做什么、产出什么✅execution_modes声明支持哪些执行模式⬜ 可选metadata元数据是否需要用户确认、是否支持引导式提问⬜ 可选一份最小可用的工作流YAML长这样摘自 story-development-cycle.yamlworkflow: id: story-development-cycle name: Story Development Cycle version: 1.0 type: generic # greenfield | brownfield | generic description: - 从创建到交付的完整Story开发闭环。 metadata: elicit: true # 支持引导式提问 confirmation_required: true # 关键节点需用户确认新手提示id是工作流的唯一标识后续所有*run-workflow命令都靠它来定位。命名建议用小写短横线风格如my-feature-flow。完整的工作流清单和详细说明见 workflows-guide.md。✍️ 三步写出你的第一个多代理编排第一步规划四件事在动笔之前先在纸上或脑子里回答四个问题目标这个流程解决什么问题参与者哪些代理需要上场sm、po、dev、qa、architect……顺序谁先谁后有没有可以并行的条件哪里需要判断失败后回退到哪一步第二步定义 phases sequence这是工作流的灵魂。每个步骤必须指定agent谁做和action做什么并通过next字段串联phases: - phase_1: 需求创建 - phase_2: 需求校验 - phase_3: 代码实现 - phase_4: 质量评审 sequence: - step: create_story id: create phase: 1 agent: sm action: 从backlog创建下一条Story outputs: - story_file - story_id next: validate # 完成后流转到 validate - step: validate_story id: validate phase: 2 agent: po action: 用10点清单校验Story requires: create # 依赖 create 完成 outputs: - validation_report next: implement on_failure: create # 校验不通过 → 打回给 SM 重写几个关键细节字段说明示例agent执行该步骤的代理名sm、dev、qarequires前置依赖必须等谁完成createnext成功后的下一步validateon_failure失败后的回退目标create打回重做outputs该步骤的产出物story_file、code第三步保存并运行工作流文件按存放位置分为三种上下文上下文存放路径适用场景Core.aiox-core/development/workflows/全局通用流程Squadsquads/{squad-name}/workflows/某个团队专属流程Hybridsquads/{squad-name}/workflows/跨团队共享保存后用一行命令启动*run-workflow my-feature-flow start查看进度、继续执行、跳过可选步骤、中止——全部通过同一命令的不同子操作完成*run-workflow my-feature-flow status # 查看当前进度 *run-workflow my-feature-flow continue # 继续下一步 *run-workflow my-feature-flow skip # 跳过可选步骤 *run-workflow my-feature-flow abort # 中止工作流更多命令和用法详见 meta-agent-commands.md。⚙️ 执行模式给流程装上油门档位AIOX提供三种执行模式控制代理与人类的交互密度。在execution_modes中声明即可模式交互量适用场景典型提示次数YOLO最少你完全信任流程放手让它跑0–1 次Interactive⚖️适中关键节点人工确认平衡效率与控制5–10 次Pre-Flight最多执行前完整规划适合高风险变更10–15 次execution_modes: - mode: yolo description: 自主执行最少交互 prompts: 0-1 - mode: interactive description: 决策检查点 教育性反馈 prompts: 5-10 default: true # 设为默认模式 - mode: preflight description: 执行前完整规划与依赖分析 prompts: 10-15新手建议第一次跑自定义工作流时选interactive熟悉后切yolo提效。 状态持久化关掉终端进度还在工作流的执行状态会自动保存到.aiox/{instance-id}-state.yaml格式如下instance_id: wf-abc123 workflow_name: story-development-cycle status: active current_step: 2 total_steps: 4 steps: - id: create status: completed completed_at: 2026-02-02T10:00:00Z - id: validate status: in_progress - id: implement status: pending - id: review status: pending这意味着你可以在会话A中启动工作流跑到第2步关掉终端去喝杯咖啡 ☕下次打开会话运行*run-workflow story-development-cycle continue系统自动加载状态从第2步继续状态管理由 workflow-state-manager.js 负责执行引擎在 workflow-executor.js 中实现。 进阶从模板到生产级工作流使用官方模板快速起步AIOX内置了一份工作流生成模板 workflow-template.yaml支持变量替换{{WORKFLOW_ID}}、{{STEP_AGENT}}等覆盖agent、task、subprocess、condition四种步骤类型以及retry、skip、fallback三种错误处理策略。你也可以让架构代理自动生成工作流骨架architect *create-workflow系统会引导你回答6个问题目标上下文、名称、主目标、阶段、代理编排、资源需求然后自动生成符合规范的YAML文件。并行阶段用 depends_on 编排DAG当多个步骤之间没有依赖关系时可以用depends_on声明并行让引擎同时调度phases: - id: phase_0 name: 项目探测 agent: project-integrator task: integrate-project.md - id: phase_1 name: CLAUDE.md 工程 agent: project-integrator depends_on: [phase_0] # 只依赖 phase_0 - id: phase_2 name: 配置与权限 agent: config-engineer depends_on: [phase_0] # 只依赖 phase_0与 phase_1 并行 - id: phase_6 name: 全量审计 agent: claude-mastery-chief depends_on: [phase_1, phase_2, phase_3, phase_4, phase_5] # 汇聚点完整的并行阶段示例可参考 wf-project-setup.yaml。检查点与门禁给每个阶段装质检关卡Squad级工作流支持在每个阶段设置checkpoint包含gate通过条件和veto否决条件checkpoint: gate: CLAUDE.md 存在且 200 行 veto: CLAUDE.md 500 行且未经用户批准引擎在每个阶段完成后检查满足gate→ 继续下一阶段触发veto→ 暂停并请求人工介入都不满足 → 按execution_modes中的默认策略处理✅ 最佳实践清单#建议原因1每个 phase 只做一件事职责清晰调试时能快速定位2notes字段写详细未来接手的人包括你自己会感谢现在的你3为可选步骤标记optional: true简单场景可以跳过复杂场景强制执行4加on_failure回退路径失败不是终点回退到正确步骤才是5写decision_guidance区块明确什么时候用 / 什么时候别用减少误触发6先跑interactive模式验证确认流程正确后再切yolo常见错误排查报错信息原因解决方法Workflow {name} not found文件名与id不匹配检查workflow.id是否与文件名一致No active workflow instance未先start就执行continue先运行*run-workflow {name} startCannot skip non-optional step尝试跳过非可选步骤完成该步骤或中止工作流 延伸阅读资源路径工作流总览指南docs/guides/workflows-guide.md各工作流详细文档docs/aiox-workflows/README.md工作流执行器源码.aiox-core/core/orchestration/workflow-executor.js工作流状态管理.aiox-core/development/scripts/workflow-state-manager.js工作流验证器.aiox-core/development/scripts/workflow-validator.js工作流注册表.aiox-core/workflow-intelligence/registry/workflow-registry.js官方工作流模板.claude/templates/workflow-template.yamlStory开发周期示例.aiox-core/development/workflows/story-development-cycle.yamlSquad并行工作流示例squads/claude-code-mastery/workflows/wf-project-setup.yaml元代理命令参考docs/meta-agent-commands.md掌握这份YAML结构后你就拥有了定义任意多代理协作流程的能力——从简单的两步校验到包含并行分支、条件回退、质量门禁的复杂生产线都在这一个文件里。【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AIOX工作流YAML编写指南：自己定义多代理编排流程
AIOX工作流YAML编写指南自己定义多代理编排流程【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-coreAIOX工作流YAML是Synkra AIOS框架中定义多代理协作编排的核心配置格式。通过一份结构化的YAML文件你可以把谁先做、谁后做、失败了怎么办全部写清楚让多个AI代理按你的设计自动接力完成任务——无需逐条下指令。 30秒理解工作流 你的AI项目流水线在深入YAML语法之前先建立一个直觉概念一句话解释生活类比Workflow工作流多代理协作的完整定义一条装配线Phase阶段逻辑分组的步骤集合装配线的工序段Step步骤单个代理执行的一个动作装配线上的一个工位Transition转移步骤间的流转条件工位之间的传送带State状态跨会话的进度记录装配线的工单一个典型的多代理编排长这样——SM写需求 → PO验收 → Dev实现 → QA把关四个角色自动接力┌─────────────────────────────────────────────────────────────┐ │ AIOX 多代理编排流程Story Cycle │ │ │ │ sm:创建Story → po:10点校验 → dev:编码测试 → qa:门禁│ │ │ │ │ │ │ │ ▼ ▼ ▼ ▼ │ │ Draft Story Ready / 打回 代码单测 Quality Gate│ └─────────────────────────────────────────────────────────────┘这套流程的完整定义就在 story-development-cycle.yaml 里一个文件管住四个代理的协作顺序。 工作流YAML文件结构速览AIOX工作流文件由三大块组成从上到下依次是元信息 → 阶段划分 → 步骤序列顶层字段作用必填workflow工作流的身份卡片ID、名称、版本、类型✅phases把步骤分成若干逻辑阶段✅sequence逐步定义每个动作谁做、做什么、产出什么✅execution_modes声明支持哪些执行模式⬜ 可选metadata元数据是否需要用户确认、是否支持引导式提问⬜ 可选一份最小可用的工作流YAML长这样摘自 story-development-cycle.yamlworkflow: id: story-development-cycle name: Story Development Cycle version: 1.0 type: generic # greenfield | brownfield | generic description: - 从创建到交付的完整Story开发闭环。 metadata: elicit: true # 支持引导式提问 confirmation_required: true # 关键节点需用户确认新手提示id是工作流的唯一标识后续所有*run-workflow命令都靠它来定位。命名建议用小写短横线风格如my-feature-flow。完整的工作流清单和详细说明见 workflows-guide.md。✍️ 三步写出你的第一个多代理编排第一步规划四件事在动笔之前先在纸上或脑子里回答四个问题目标这个流程解决什么问题参与者哪些代理需要上场sm、po、dev、qa、architect……顺序谁先谁后有没有可以并行的条件哪里需要判断失败后回退到哪一步第二步定义 phases sequence这是工作流的灵魂。每个步骤必须指定agent谁做和action做什么并通过next字段串联phases: - phase_1: 需求创建 - phase_2: 需求校验 - phase_3: 代码实现 - phase_4: 质量评审 sequence: - step: create_story id: create phase: 1 agent: sm action: 从backlog创建下一条Story outputs: - story_file - story_id next: validate # 完成后流转到 validate - step: validate_story id: validate phase: 2 agent: po action: 用10点清单校验Story requires: create # 依赖 create 完成 outputs: - validation_report next: implement on_failure: create # 校验不通过 → 打回给 SM 重写几个关键细节字段说明示例agent执行该步骤的代理名sm、dev、qarequires前置依赖必须等谁完成createnext成功后的下一步validateon_failure失败后的回退目标create打回重做outputs该步骤的产出物story_file、code第三步保存并运行工作流文件按存放位置分为三种上下文上下文存放路径适用场景Core.aiox-core/development/workflows/全局通用流程Squadsquads/{squad-name}/workflows/某个团队专属流程Hybridsquads/{squad-name}/workflows/跨团队共享保存后用一行命令启动*run-workflow my-feature-flow start查看进度、继续执行、跳过可选步骤、中止——全部通过同一命令的不同子操作完成*run-workflow my-feature-flow status # 查看当前进度 *run-workflow my-feature-flow continue # 继续下一步 *run-workflow my-feature-flow skip # 跳过可选步骤 *run-workflow my-feature-flow abort # 中止工作流更多命令和用法详见 meta-agent-commands.md。⚙️ 执行模式给流程装上油门档位AIOX提供三种执行模式控制代理与人类的交互密度。在execution_modes中声明即可模式交互量适用场景典型提示次数YOLO最少你完全信任流程放手让它跑0–1 次Interactive⚖️适中关键节点人工确认平衡效率与控制5–10 次Pre-Flight最多执行前完整规划适合高风险变更10–15 次execution_modes: - mode: yolo description: 自主执行最少交互 prompts: 0-1 - mode: interactive description: 决策检查点 教育性反馈 prompts: 5-10 default: true # 设为默认模式 - mode: preflight description: 执行前完整规划与依赖分析 prompts: 10-15新手建议第一次跑自定义工作流时选interactive熟悉后切yolo提效。 状态持久化关掉终端进度还在工作流的执行状态会自动保存到.aiox/{instance-id}-state.yaml格式如下instance_id: wf-abc123 workflow_name: story-development-cycle status: active current_step: 2 total_steps: 4 steps: - id: create status: completed completed_at: 2026-02-02T10:00:00Z - id: validate status: in_progress - id: implement status: pending - id: review status: pending这意味着你可以在会话A中启动工作流跑到第2步关掉终端去喝杯咖啡 ☕下次打开会话运行*run-workflow story-development-cycle continue系统自动加载状态从第2步继续状态管理由 workflow-state-manager.js 负责执行引擎在 workflow-executor.js 中实现。 进阶从模板到生产级工作流使用官方模板快速起步AIOX内置了一份工作流生成模板 workflow-template.yaml支持变量替换{{WORKFLOW_ID}}、{{STEP_AGENT}}等覆盖agent、task、subprocess、condition四种步骤类型以及retry、skip、fallback三种错误处理策略。你也可以让架构代理自动生成工作流骨架architect *create-workflow系统会引导你回答6个问题目标上下文、名称、主目标、阶段、代理编排、资源需求然后自动生成符合规范的YAML文件。并行阶段用 depends_on 编排DAG当多个步骤之间没有依赖关系时可以用depends_on声明并行让引擎同时调度phases: - id: phase_0 name: 项目探测 agent: project-integrator task: integrate-project.md - id: phase_1 name: CLAUDE.md 工程 agent: project-integrator depends_on: [phase_0] # 只依赖 phase_0 - id: phase_2 name: 配置与权限 agent: config-engineer depends_on: [phase_0] # 只依赖 phase_0与 phase_1 并行 - id: phase_6 name: 全量审计 agent: claude-mastery-chief depends_on: [phase_1, phase_2, phase_3, phase_4, phase_5] # 汇聚点完整的并行阶段示例可参考 wf-project-setup.yaml。检查点与门禁给每个阶段装质检关卡Squad级工作流支持在每个阶段设置checkpoint包含gate通过条件和veto否决条件checkpoint: gate: CLAUDE.md 存在且 200 行 veto: CLAUDE.md 500 行且未经用户批准引擎在每个阶段完成后检查满足gate→ 继续下一阶段触发veto→ 暂停并请求人工介入都不满足 → 按execution_modes中的默认策略处理✅ 最佳实践清单#建议原因1每个 phase 只做一件事职责清晰调试时能快速定位2notes字段写详细未来接手的人包括你自己会感谢现在的你3为可选步骤标记optional: true简单场景可以跳过复杂场景强制执行4加on_failure回退路径失败不是终点回退到正确步骤才是5写decision_guidance区块明确什么时候用 / 什么时候别用减少误触发6先跑interactive模式验证确认流程正确后再切yolo常见错误排查报错信息原因解决方法Workflow {name} not found文件名与id不匹配检查workflow.id是否与文件名一致No active workflow instance未先start就执行continue先运行*run-workflow {name} startCannot skip non-optional step尝试跳过非可选步骤完成该步骤或中止工作流 延伸阅读资源路径工作流总览指南docs/guides/workflows-guide.md各工作流详细文档docs/aiox-workflows/README.md工作流执行器源码.aiox-core/core/orchestration/workflow-executor.js工作流状态管理.aiox-core/development/scripts/workflow-state-manager.js工作流验证器.aiox-core/development/scripts/workflow-validator.js工作流注册表.aiox-core/workflow-intelligence/registry/workflow-registry.js官方工作流模板.claude/templates/workflow-template.yamlStory开发周期示例.aiox-core/development/workflows/story-development-cycle.yamlSquad并行工作流示例squads/claude-code-mastery/workflows/wf-project-setup.yaml元代理命令参考docs/meta-agent-commands.md掌握这份YAML结构后你就拥有了定义任意多代理协作流程的能力——从简单的两步校验到包含并行分支、条件回退、质量门禁的复杂生产线都在这一个文件里。【免费下载链接】aiox-coreSynkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0项目地址: https://gitcode.com/GitHub_Trending/ai/aiox-core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考