绿地全栈工作流

版本: 1.0.0 类型: 绿地项目 最后更新: 2026-02-04 源文件: .aiox-core/development/workflows/greenfield-fullstack.yaml

概述

绿地全栈工作流 是 AIOX 从概念到开发的主要工作流,用于构建全栈应用。本工作流既支持复杂项目的全面规划,也支持简单项目的快速原型设计。

支持的项目类型

类型	描述
`web-app`	现代网络应用
`saas`	软件即服务
`enterprise-app`	企业应用
`prototype`	原型和概念验证
`mvp`	最小可行产品

何时使用本工作流

构建生产就绪的应用
多团队成员项目
复杂功能需求
需要全面文档
长期维护预期
企业或客户应用

工作流总体图表

flowchart TB
    subgraph PHASE0["第 0 阶段: 环境引导"]
        A[开始: 绿地项目] --> A1{环境就绪?}
        A1 -->|否| A2["@devops: *environment-bootstrap"]
        A2 --> A3[CLIs 已安装 + GitHub 仓库已创建]
        A1 -->|是| A3
    end

    subgraph PHASE1["第 1 阶段: 发现和规划"]
        A3 --> B["@analyst: project-brief.md"]
        B --> C["@pm: prd.md"]
        C --> D["@ux-expert: front-end-spec.md"]
        D --> D2{生成 v0 提示?}
        D2 -->|是| D3["@ux-expert: 创建 v0 提示"]
        D2 -->|否| E["@architect: fullstack-architecture.md"]
        D3 --> D4[用户: 在 v0/Lovable 中生成 UI]
        D4 --> E
        E --> F{架构建议更改 PRD?}
        F -->|是| G["@pm: 更新 prd.md"]
        F -->|否| H["@po: 验证所有工件"]
        G --> H
        H --> I{PO 发现问题?}
        I -->|是| J[返回相关代理进行更正]
        I -->|否| K_GATE[第 1 阶段完成]
        J --> H
    end

    subgraph PHASE2["第 2 阶段: 文档分片"]
        K_GATE --> K["@po: 分片文档"]
        K --> K1[创建: source-tree, tech-stack, coding-standards]
    end

    subgraph PHASE3["第 3 阶段: 开发循环"]
        K1 --> L["@sm: 创建故事"]
        L --> M{审阅故事草稿?}
        M -->|是| N["@analyst/@pm: 审阅和批准故事"]
        M -->|否| O["@dev: 实施故事"]
        N --> O
        O --> P{质量保证审阅?}
        P -->|是| Q["@qa: 审阅实现"]
        P -->|否| R{更多故事?}
        Q --> S{QA 发现问题?}
        S -->|是| T["@dev: 解决 QA 反馈"]
        S -->|否| R
        T --> Q
        R -->|是| L
        R -->|否| U{史诗回顾?}
        U -->|是| V["@po: 史诗回顾"]
        U -->|否| W[项目完成]
        V --> W
    end

    %% 可选路径
    B -.-> B1[可选: 头脑风暴]
    B -.-> B2[可选: 市场研究]
    D -.-> D1[可选: 用户研究]
    E -.-> E1[可选: 技术研究]

    %% 样式
    style A2 fill:#FF6B6B,color:#fff
    style A3 fill:#FF6B6B,color:#fff
    style W fill:#90EE90
    style K fill:#ADD8E6
    style K1 fill:#ADD8E6
    style L fill:#ADD8E6
    style O fill:#ADD8E6
    style D3 fill:#E6E6FA
    style D4 fill:#E6E6FA
    style B fill:#FFE4B5
    style C fill:#FFE4B5
    style D fill:#FFE4B5
    style E fill:#FFE4B5
    style N fill:#F0E68C
    style Q fill:#F0E68C
    style V fill:#F0E68C

工作流阶段

颜色说明

颜色	含义
红色 (#FF6B6B)	环境引导
浅橙色 (#FFE4B5)	规划和文档
浅蓝色 (#ADD8E6)	开发和分片
浅紫色 (#E6E6FA)	AI 生成 UI
黄色 (#F0E68C)	审阅和验证
绿色 (#90EE90)	完成

第 0 阶段: 环境引导

目标

在启动项目规划前配置开发环境。

详细图表

flowchart TD
    subgraph FASE0["第 0 阶段: 环境引导"]
        START([开始]) --> CHECK{环境就绪?}

        CHECK -->|验证| ENV_REPORT[".aiox/environment-report.json 存在?"]
        ENV_REPORT -->|是| SKIP[跳过引导]
        ENV_REPORT -->|否| BOOTSTRAP

        subgraph BOOTSTRAP["@devops: *environment-bootstrap"]
            B1[检测操作系统]
            B2[CLIs 审计]
            B3[交互式安装]
            B4[服务身份验证]
            B5[Git 仓库初始化]
            B6[项目结构搭建]
            B7[环境报告生成]

            B1 --> B2 --> B3 --> B4 --> B5 --> B6 --> B7
        end

        SKIP --> DONE
        B7 --> DONE([第 0 阶段完成])
    end

详细步骤

步骤	代理	任务	输入	输出	必需
1	@devops (Gage)	`environment-bootstrap.md`	`project_name`, `project_path`, `github_org`	`.aiox/config.yaml`, `.aiox/environment-report.json`, `.gitignore`, `README.md`, `package.json`	是

创建的工件

文件	描述
`.aiox/config.yaml`	AIOX 项目配置
`.aiox/environment-report.json`	完整的环境报告
`.gitignore`	Git 忽略规则
`README.md`	初始项目文档
`package.json`	NPM 配置

验证/安装的 CLIs

类别	工具	必需
必需	git	是
必需	gh (GitHub CLI)	是
必需	node	是
必需	npm	是
基础设施	supabase	推荐
基础设施	railway	可选
基础设施	docker	推荐
质量	coderabbit	推荐
可选	pnpm	可选
可选	bun	可选

跳过条件

仅在项目已有 .aiox/environment-report.json 时跳过
切换机器或新团队成员加入时重新执行

第 1 阶段: 发现和规划

目标

创建所有规划工件: 项目简报、PRD、规范和架构。

详细图表

flowchart TD
    subgraph FASE1["第 1 阶段: 发现和规划"]
        ENV_DONE([引导完成]) --> ANALYST

        subgraph ANALYST["@analyst: Atlas"]
            A1[可选头脑风暴]
            A2[可选市场研究]
            A3[创建项目简报]
            A1 -.-> A3
            A2 -.-> A3
        end

        ANALYST --> |project-brief.md| PM

        subgraph PM["@pm: Morgan"]
            P1[审阅项目简报]
            P2[使用 prd-tmpl 创建 PRD]
            P1 --> P2
        end

        PM --> |prd.md| UX

        subgraph UX["@ux-expert: Uma"]
            U1[可选用户研究]
            U2[创建前端规范]
            U3{生成 v0 提示?}
            U4[为 v0/Lovable 创建提示]
            U1 -.-> U2
            U2 --> U3
            U3 -->|是| U4
        end

        UX --> |front-end-spec.md| ARCH

        subgraph ARCH["@architect: Aria"]
            AR1[可选技术研究]
            AR2[创建全栈架构]
            AR3{建议更改 PRD?}
            AR1 -.-> AR2
            AR2 --> AR3
        end

        AR3 -->|是| PM_UPDATE["@pm: 更新 PRD"]
        AR3 -->|否| PO
        PM_UPDATE --> PO

        subgraph PO["@po: Pax"]
            PO1[执行 po-master-checklist]
            PO2{发现问题?}
            PO1 --> PO2
        end

        PO2 -->|是| FIX[返回相关代理]
        FIX --> PO
        PO2 -->|否| DONE([第 1 阶段完成])
    end

详细步骤

步骤	代理	任务/模板	输入	输出	必需
1	@analyst (Atlas)	`project-brief-tmpl.yaml`	用户需求、研究	`project-brief.md`	是
2	@pm (Morgan)	`prd-tmpl.yaml`	`project-brief.md`	`prd.md`	是
3	@ux-expert (Uma)	`front-end-spec-tmpl.yaml`	`prd.md`	`front-end-spec.md`	是
4	@ux-expert (Uma)	`generate-ai-frontend-prompt.md`	`front-end-spec.md`	v0/Lovable 提示	可选
5	@architect (Aria)	`fullstack-architecture-tmpl.yaml`	`prd.md`, `front-end-spec.md`	`fullstack-architecture.md`	是
6	@pm (Morgan)	更新	`fullstack-architecture.md`	更新的 `prd.md`	条件
7	@po (Pax)	`po-master-checklist.md`	所有工件	验证	是

创建的工件

文档	责任人	位置
项目简报	@analyst	`docs/project-brief.md`
PRD	@pm	`docs/prd.md`
前端规范	@ux-expert	`docs/front-end-spec.md`
全栈架构	@architect	`docs/fullstack-architecture.md`

可选步骤

步骤	代理	描述
头脑风暴	@analyst	结构化的想法会议
市场研究	@analyst	市场和竞争对手分析
用户研究	@ux-expert	访谈和需求分析
技术研究	@architect	技术调查

第 2 阶段: 文档分片

目标

将 PRD 和架构分割成开发就绪的部分。

详细图表

flowchart TD
    subgraph FASE2["第 2 阶段: 文档分片"]
        PHASE1_DONE([第 1 阶段完成]) --> SHARD

        subgraph SHARD["@po: 分片文档"]
            S1[加载 docs/prd.md]
            S2[识别 2 级部分]
            S3[提取每个部分]
            S4[调整标题级别]
            S5[创建各个文件]
            S6[生成 index.md]

            S1 --> S2 --> S3 --> S4 --> S5 --> S6
        end

        SHARD --> OUTPUT

        subgraph OUTPUT["生成的工件"]
            O1[docs/prd/index.md]
            O2[docs/prd/*.md - 部分]
            O3[docs/architecture/source-tree.md]
            O4[docs/architecture/tech-stack.md]
            O5[docs/architecture/coding-standards.md]
        end

        OUTPUT --> DONE([第 2 阶段完成])
    end

详细步骤

步骤	代理	任务	输入	输出	必需
1	@po (Pax)	`shard-doc.md`	`docs/prd.md`	包含分片文件的 `docs/prd/` 文件夹	是

分片方法

自动 (推荐): 使用 md-tree explode {input} {output}
手动: 按 2 级标题 (##) 分割

创建的工件

文件	描述
`docs/prd/index.md`	包含所有部分链接的索引
`docs/prd/*.md`	PRD 的各个部分
`docs/architecture/source-tree.md`	项目目录结构
`docs/architecture/tech-stack.md`	技术堆栈
`docs/architecture/coding-standards.md`	代码标准

第 3 阶段: 开发循环

目标

通过质量保证审阅的迭代实施故事。

详细图表

flowchart TD
    subgraph FASE3["第 3 阶段: 开发循环"]
        PHASE2_DONE([第 2 阶段完成]) --> STORY_LOOP

        subgraph STORY_LOOP["故事循环"]
            SM["@sm: *draft"]
            REVIEW_Q{审阅草稿?}
            REVIEW["@analyst/@pm: 审阅故事"]
            DEV["@dev: *develop"]
            QA_Q{质量保证审阅?}
            QA["@qa: *review"]
            QA_ISSUES{发现问题?}
            FIX["@dev: *apply-qa-fixes"]
            MORE_Q{更多故事?}

            SM --> REVIEW_Q
            REVIEW_Q -->|是| REVIEW
            REVIEW_Q -->|否| DEV
            REVIEW --> DEV
            DEV --> QA_Q
            QA_Q -->|是| QA
            QA_Q -->|否| MORE_Q
            QA --> QA_ISSUES
            QA_ISSUES -->|是| FIX
            QA_ISSUES -->|否| MORE_Q
            FIX --> QA
            MORE_Q -->|是| SM
        end

        MORE_Q -->|否| RETRO_Q{回顾?}
        RETRO_Q -->|是| RETRO["@po: 史诗回顾"]
        RETRO_Q -->|否| DONE
        RETRO --> DONE([项目完成])
    end

详细步骤

步骤	代理	任务	输入	输出	必需
1	@sm (River)	`sm-create-next-story.md`	分片的文档	`{epic}.{story}.story.md`	是
2	@analyst/@pm	审阅	故事草稿	批准的故事	可选
3	@dev (Dex)	`dev-develop-story.md`	批准的故事	实现	是
4	@qa (Quinn)	`qa-review-story.md`	实现	质量保证反馈	可选
5	@dev (Dex)	`apply-qa-fixes.md`	质量保证反馈	应用的更正	条件
6	@po (Pax)	回顾	完成的史诗	回顾	可选

故事循环

stateDiagram-v2
    [*] --> Draft: @sm 创建故事
    Draft --> Approved: 可选审阅
    Draft --> InProgress: Dev 接受
    Approved --> InProgress: Dev 启动
    InProgress --> Review: Dev 完成
    Review --> InProgress: QA 发现问题
    Review --> Done: QA 批准
    Done --> [*]

故事状态

状态	描述	下一步
Draft	SM 创建的故事	审阅或开发
Approved	审阅和批准的故事	开发
In Progress	开发中	质量保证审阅
Review	等待审阅	质量保证或更正
Done	完成和批准	下一个故事

参与的代理

代理表

代理	ID	图标	原型	责任
Gage	@devops	⚡	操作员	环境引导、Git 推送、发布、CI/CD
Atlas	@analyst	🔍	解码器	市场研究、头脑风暴、项目简报
Morgan	@pm	📋	策略师	PRD、产品策略、史诗
Uma	@ux-expert	🎨	移情者	前端规范、UX、设计系统
Aria	@architect	🏛️	愿景者	全栈架构、技术决策
Pax	@po	🎯	平衡者	工件验证、待办事项、分片
River	@sm	🌊	促进者	故事创建、冲刺规划
Dex	@dev	💻	建设者	代码实现、测试
Quinn	@qa	✅	守卫者	质量审阅、测试、关卡

代理间交互图表

graph LR
    subgraph 规划
        ANALYST[🔍 Atlas<br>@analyst]
        PM[📋 Morgan<br>@pm]
        UX[🎨 Uma<br>@ux-expert]
        ARCH[🏛️ Aria<br>@architect]
    end

    subgraph 治理
        PO[🎯 Pax<br>@po]
        SM[🌊 River<br>@sm]
    end

    subgraph 执行
        DEV[💻 Dex<br>@dev]
        QA[✅ Quinn<br>@qa]
        DEVOPS[⚡ Gage<br>@devops]
    end

    ANALYST -->|project-brief| PM
    PM -->|prd| UX
    UX -->|front-end-spec| ARCH
    ARCH -->|架构| PO
    PO -->|故事| SM
    SM -->|故事| DEV
    DEV -->|实现| QA
    QA -->|反馈| DEV
    DEV -->|就绪| DEVOPS

    PM -.->|更新 PRD| ARCH
    PO -.->|验证| PM
    PO -.->|验证| ARCH

执行的任务

完整任务列表

阶段	任务	代理	文件
0	环境引导	@devops	`environment-bootstrap.md`
1	创建文档	@analyst、@pm、@ux-expert、@architect	`create-doc.md`
1	促进头脑风暴	@analyst	`facilitate-brainstorming-session.md`
1	深入研究提示	@analyst、@pm、@architect	`create-deep-research-prompt.md`
1	生成 AI 前端提示	@ux-expert	`generate-ai-frontend-prompt.md`
1	执行检查列表	@po	`execute-checklist.md`
2	分片文档	@po	`shard-doc.md`
3	创建下一个故事	@sm	`sm-create-next-story.md`
3	开发故事	@dev	`dev-develop-story.md`
3	审阅故事	@qa	`qa-review-story.md`
3	应用质量保证修复	@dev	`apply-qa-fixes.md`

使用的模板

模板	代理	目的
`project-brief-tmpl.yaml`	@analyst	项目简报结构
`prd-tmpl.yaml`	@pm	PRD 结构
`front-end-spec-tmpl.yaml`	@ux-expert	前端规范
`fullstack-architecture-tmpl.yaml`	@architect	完整架构
`story-tmpl.yaml`	@sm	用户故事模板

使用的检查列表

检查列表	代理	用途
`po-master-checklist.md`	@po	所有工件验证
`story-draft-checklist.md`	@sm	故事草稿质量
`story-dod-checklist.md`	@dev	完成定义

前置条件

系统要求

要求	最少	推荐
Windows	10 1809+	11
macOS	12+	14+
Linux	Ubuntu 20.04+	Ubuntu 22.04+
Node.js	18.x	20.x
Git	2.x	2.43+

必需工具

工具	验证命令	安装
Git	`git --version`	本地系统
GitHub CLI	`gh --version`	`winget install GitHub.cli`
Node.js	`node --version`	`winget install OpenJS.NodeJS.LTS`
npm	`npm --version`	包含在 Node.js 中

必需的身份验证

服务	登录命令	验证
GitHub	`gh auth login`	`gh auth status`
Supabase	`supabase login`	`supabase projects list`
Railway	`railway login`	`railway whoami`

输入和输出

数据流

flowchart LR
    subgraph 输入
        I1[用户需求]
        I2[市场研究]
        I3[用户反馈]
    end

    subgraph 阶段0["阶段 0"]
        E1[.aiox/config.yaml]
        E2[GitHub 仓库]
    end

    subgraph 阶段1["阶段 1"]
        P1[project-brief.md]
        P2[prd.md]
        P3[front-end-spec.md]
        P4[fullstack-architecture.md]
    end

    subgraph 阶段2["阶段 2"]
        S1[docs/prd/*.md]
        S2[source-tree.md]
        S3[tech-stack.md]
        S4[coding-standards.md]
    end

    subgraph 阶段3["阶段 3"]
        D1[故事 .md]
        D2[源代码]
        D3[测试]
    end

    subgraph 输出
        O1[完整应用]
        O2[文档]
        O3[自动化测试]
    end

    I1 --> E1
    I2 --> P1
    I3 --> P1

    E1 --> P1
    E2 --> P1
    P1 --> P2
    P2 --> P3
    P3 --> P4

    P2 --> S1
    P4 --> S2
    P4 --> S3
    P4 --> S4

    S1 --> D1
    S2 --> D2
    S3 --> D2
    S4 --> D2
    D1 --> D2
    D2 --> D3

    D2 --> O1
    D1 --> O2
    D3 --> O3

按阶段的输入/输出矩阵

阶段	输入	输出
0	项目名、GitHub 组织	AIOX 配置、Git 仓库、文件夹结构
1	需求、研究	简报、PRD、规范、架构
2	PRD、架构	分片文档、索引
3	故事、分片文档	代码、测试、应用

决策点

决策表

阶段	决策点	选项	标准
0	环境就绪?	跳过/执行引导	`.aiox/environment-report.json` 存在
1	生成 v0 提示?	是/否	用户想要 AI UI 生成
1	架构建议更改?	更新 PRD/继续	架构师建议
1	PO 发现问题?	更正/批准	检查列表结果
3	审阅故事草稿?	审阅/跳过 dev	故事复杂性
3	质量保证审阅?	是/否	故事关键性
3	更多故事?	继续/完成	史诗待办事项
3	回顾?	是/否	史诗完成

决策流程图

flowchart TD
    D1{环境就绪?}
    D1 -->|检查 .aiox/environment-report.json| D1_CHECK
    D1_CHECK -->|存在| SKIP[跳过第 0 阶段]
    D1_CHECK -->|不存在| RUN[执行引导]

    D2{生成 v0 提示?}
    D2 -->|用户想要 UI 生成| D2_YES[生成提示]
    D2 -->|不必要| D2_NO[转到架构]

    D3{PRD 中的更改?}
    D3 -->|架构师推荐| D3_YES[更新 PRD]
    D3 -->|不必要| D3_NO[继续验证]

    D4{发现问题?}
    D4 -->|PO 发现问题| D4_YES[与代理更正]
    D4 -->|一切正常| D4_NO[批准和继续]

故障排除

常见问题

第 0 阶段: 环境引导

问题	原因	解决方案
`winget` 未识别	Windows 过期	更新 Windows 或使用 `choco`/`scoop`
`gh auth login` 失败	连接或代理	检查互联网、配置代理
仓库权限被拒	Token 作用域不足	使用 `--scopes repo,workflow` 重新认证
Docker 不启动	服务停止	启动 Docker Desktop

第 1 阶段: 规划

问题	原因	解决方案
模板未找到	路径错误	检查 `.aiox-core/development/templates/`
PRD 与架构冲突	需求分歧	召开 PM 和 Architect 会议对齐
检查列表失败	工件不完整	返回相关代理

第 2 阶段: 分片

问题	原因	解决方案
`md-tree` 未找到	未安装	`npm install -g @kayvan/markdown-tree-parser`
未检测到部分	格式错误	检查文档中的 `##` 标题
内容丢失	代码块中的 `##`	使用正确解析的手动方法

第 3 阶段: 开发

问题	原因	解决方案
故事不完整	SM 跳过字段	执行 `story-draft-checklist`
测试失败	代码损坏	@dev 执行 `*run-tests`
QA 阻止	CRITICAL 问题	在继续前与 @dev 解决
Epic 未在 ClickUp 中找到	Task 未创建	使用正确标签创建 Epic

诊断命令

# 检查环境
cat .aiox/environment-report.json

# 检查 CLIs
git --version && gh --version && node --version

# 检查身份验证
gh auth status
supabase projects list
railway whoami

# 检查项目结构
ls -la .aiox/
ls -la docs/

切换提示

阶段间转换

从	到	切换提示
阶段 0	阶段 1	"环境引导完成! Git 仓库已创建,CLIs 已验证,项目结构就绪。使用 @analyst 在新聊天中开始创建项目简报。"
@analyst	@pm	"项目简报完成。将其保存为项目中的 `docs/project-brief.md`,然后创建 PRD。"
@pm	@ux-expert	"PRD 就绪。将其保存为项目中的 `docs/prd.md`,然后创建 UI/UX 规范。"
@ux-expert	@architect	"UI/UX 规范完成。将其保存为项目中的 `docs/front-end-spec.md`,然后创建全栈架构。"
@architect	@po	"架构完成。将其保存为 `docs/fullstack-architecture.md`。您建议对 PRD 故事进行更改或需要新故事吗?"
阶段 1	阶段 2	"所有规划工件已验证。现在为开发分片文档: @po → *shard-doc docs/prd.md"
阶段 2	阶段 3	"文档已分片! source-tree.md、tech-stack.md、coding-standards.md 已创建。开始开发: @sm → *draft"
完成	-	"所有故事已实施和审阅。项目的开发阶段完成!"

参考

类型	文件	描述
工作流	`.aiox-core/development/workflows/greenfield-fullstack.yaml`	工作流定义
任务	`.aiox-core/development/tasks/environment-bootstrap.md`	环境引导
任务	`.aiox-core/development/tasks/shard-doc.md`	文档分片
任务	`.aiox-core/development/tasks/sm-create-next-story.md`	故事创建
代理	`.aiox-core/development/agents/*.md`	代理定义
模板	`.aiox-core/development/templates/*.yaml`	文档模板
检查列表	`.aiox-core/development/checklists/*.md`	验证检查列表

外部文档

资源	URL
GitHub CLI	https://cli.github.com/manual/
Supabase CLI	https://supabase.com/docs/guides/cli
Railway CLI	https://docs.railway.app/reference/cli-api
CodeRabbit	https://coderabbit.ai/docs

版本历史

版本	日期	更改
1.0.0	2026-02-04	初始完整文档

维护者: AIOX 开发团队 最后审阅: 2026-02-04

FilesExpand file tree

greenfield-fullstack-workflow.md

Latest commit

History

greenfield-fullstack-workflow.md

File metadata and controls

绿地全栈工作流

概述

支持的项目类型

何时使用本工作流

工作流总体图表

工作流阶段

颜色说明

第 0 阶段: 环境引导

目标

详细图表

详细步骤

创建的工件

验证/安装的 CLIs

跳过条件

第 1 阶段: 发现和规划

目标

详细图表

详细步骤

创建的工件

可选步骤

第 2 阶段: 文档分片

目标

详细图表

详细步骤

分片方法

创建的工件

第 3 阶段: 开发循环

目标

详细图表

详细步骤

故事循环

故事状态

参与的代理

代理表

代理间交互图表

执行的任务

完整任务列表

使用的模板

使用的检查列表

前置条件

系统要求

必需工具

必需的身份验证

输入和输出

数据流

按阶段的输入/输出矩阵

决策点

决策表

决策流程图

故障排除

常见问题

第 0 阶段: 环境引导

第 1 阶段: 规划

第 2 阶段: 分片

第 3 阶段: 开发

诊断命令

切换提示

阶段间转换

参考

相关文件

外部文档

版本历史