aiox-workflows

AIOX 工作流 - 工作流详细文档

🌐 简体中文 | PT | EN | ES

---

版本: 1.0.0 最后更新: 2026-02-05 状态: 官方文档

---

概述

本文件夹包含 AIOX 所有工作流的详细文档,包括:

• 完整的 Mermaid 图表 (流程图、序列图、状态图)
• 详细的步骤 包括输入/输出
• 参与的代理 及其角色
• 决策点 和条件
• 前置条件 和配置
• 故障排除 和执行模式

---

文档化的工作流

按项目类型

类型	工作流	描述	文档
绿地项目	全栈	从零开始的全栈应用	greenfield-fullstack-workflow.md
绿地项目	服务	从零开始的后端/API	greenfield-service-workflow.md
绿地项目	UI	从零开始的前端	greenfield-ui-workflow.md
棕地项目	发现	现有项目分析	brownfield-discovery-workflow.md
棕地项目	全栈	现有全栈演进	brownfield-fullstack-workflow.md
棕地项目	服务	现有后端演进	brownfield-service-workflow.md
棕地项目	UI	现有前端演进	brownfield-ui-workflow.md

按流程

流程	工作流	描述	文档
开发	故事周期	完整的故事周期	story-development-cycle-workflow.md
质量	质量保证循环	质量周期	qa-loop-workflow.md
规范	规范管道	规范管道	spec-pipeline-workflow.md
设计	设计系统	设计系统构建	design-system-build-quality-workflow.md
Git	自动工作树	自动工作树管理	auto-worktree-workflow.md

---

每个文档的结构

每个工作流文档遵循这个标准结构:

1. 概述
   - 工作流的目标
   - 支持的项目类型
   - 何时使用/不使用

2. Mermaid 图表
   - 主流程图
   - 状态图
   - 序列图

3. 详细步骤
   - ID、代理、动作
   - 输入和输出
   - 成功标准
   - 状态转换

4. 参与的代理
   - 每个代理的角色
   - 相关命令

5. 执行的任务
   - 按阶段的任务映射
   - 任务文件

6. 前置条件
   - 必需的配置
   - 前置文档
   - 集成工具

7. 输入和输出
   - 工作流输入
   - 生成的输出

8. 决策点
   - 分支条件
   - 阻塞标准

9. 执行模式
   - YOLO (自主)
   - Interactive (平衡)
   - Pre-Flight (规划)

10. 故障排除
    - 常见问题
    - 日志和诊断

11. 变更日志
    - 版本历史

---

工作流地图

flowchart TB
    subgraph GREENFIELD["绿地项目 (新项目)"]
        GF["greenfield-fullstack"]
        GS["greenfield-service"]
        GU["greenfield-ui"]
    end

    subgraph BROWNFIELD["棕地项目 (现有项目)"]
        BD["brownfield-discovery"]
        BF["brownfield-fullstack"]
        BS["brownfield-service"]
        BU["brownfield-ui"]
    end

    subgraph PROCESS["流程"]
        SDC["story-development-cycle"]
        QAL["qa-loop"]
        SP["spec-pipeline"]
        DSB["design-system-build"]
        AW["auto-worktree"]
    end

    BD --> BF
    BD --> BS
    BD --> BU

    GF --> SDC
    GS --> SDC
    GU --> SDC
    BF --> SDC
    BS --> SDC
    BU --> SDC

    SDC --> QAL
    SP --> SDC

    style GREENFIELD fill:#c8e6c9
    style BROWNFIELD fill:#fff9c4
    style PROCESS fill:#e3f2fd

Loading

---

工作流选择指南

新项目?

flowchart TD
    A{项目类型?} --> B[全栈]
    A --> C[仅后端/API]
    A --> D[仅前端]

    B --> E[greenfield-fullstack]
    C --> F[greenfield-service]
    D --> G[greenfield-ui]

Loading

现有项目?

flowchart TD
    A{了解该项目?} --> |否| B[brownfield-discovery]
    A --> |是| C{变更类型?}

    B --> C

    C --> D[全栈]
    C --> E[仅后端]
    C --> F[仅前端]

    D --> G[brownfield-fullstack]
    E --> H[brownfield-service]
    F --> I[brownfield-ui]

Loading

---

工作流之间的流程

从	到	条件
brownfield-discovery	brownfield-*	完成分析后
greenfield-*	story-development-cycle	每个故事
brownfield-*	story-development-cycle	每个故事
spec-pipeline	story-development-cycle	规范批准后
story-development-cycle	qa-loop	质量保证阶段

---

如何使用本文档

启动项目

1. 使用上面的 选择指南 选择工作流
2. 阅读选定工作流的 概述
3. 检查 前置条件
4. 按顺序遵循 步骤

理解流程

1. 分析 Mermaid 图表
2. 查看 参与的代理 及其角色
3. 查阅 决策点

调试问题

1. 转至 故障排除 部分
2. 检查 日志和诊断
3. 查阅每个步骤的 成功标准

---

与其他文档的关系

文档	位置	用途
工作流指南	docs/guides/workflows-guide.md	一般指南
代理流程	docs/aiox-agent-flows/	代理详情
代理参考	docs/agent-reference-guide.md	快速参考

---

贡献

要添加或更新工作流文档:

1. 遵循上面描述的标准结构
2. 包括完整的 Mermaid 图表
3. 记录所有输入/输出
4. 保持变更日志最新
5. 创建 EN 和 ES 翻译

---

AIOX 工作流文档 v1.0 - 开发工作流的详细文档