Fullstack Dev Workflow

文档驱动全栈AI自动化开发工作流

核心定位

构建技术栈智能调研、文档全链路驱动、变更自动同步、全节点可校验、全版本可追溯的全栈应用自动化开发体系。

文档索引（按需引入）

核心规范文档

模板文档

阶段概览

核心特性

1. 前端设计集成 ui-ux-pro-max 技能

阶段2前端设计必须使用 ui-ux-pro-max 技能进行高质量设计：

• UI风格选择：50+预设风格
• 色彩方案：161种配色方案
• 字体搭配：57种字体组合
• 响应式布局适配：移动端/平板/桌面端
• UX交互规范：99项UX准则
• 图表类型选择：25种图表类型

使用方式：调用 Skill 工具激活 ui-ux-pro-max 技能

2. 扩展文档目录支持

根据项目类型启用扩展文档目录：

3. 每阶段强制完成检查

每个阶段完成后必须生成检查报告：

• docs/phase-check-reports/phase-1-check.md - 需求文档完整性检查
• docs/phase-check-reports/phase-2-check.md - 设计文档完整性检查
• docs/phase-check-reports/phase-3-check.md - 开发代码完整性检查
• docs/phase-check-reports/phase-4-check.md - 测试验收完整性检查
• docs/phase-check-reports/phase-5-check.md - 变更闭环完整性检查

4. ⚠️ 技术栈 Skills 自动搜索（强制执行）

这是阶段-1完成后必须执行的步骤，不可跳过！

⚠️ 强制流程：阶段-1完成 → 自动搜索技术栈Skills → 用户确认 → 安装Skills → 进入阶段0

执行步骤：

1. 解析 AGENTS.md：从生成的 AGENTS.md 中提取所有锁定的技术栈
2. 遍历技术栈：对每项技术执行 /find-skills <技术关键词> 搜索
3. 汇总结果：收集所有搜索到的相关 Skills
4. 用户确认：使用 AskUserQuestion 让用户选择需要引入的 Skills
5. 安装 Skills：安装用户选定的 Skills，确保后续开发符合最佳实践

关键提醒：

• 🔴 新项目必须执行此步骤，否则后续开发可能缺乏技术栈规范指导
• 🔴 阶段-1准出校验要求：已完成技术栈 Skills 搜索，用户已确认是否引入
• 🔴 若搜索无结果：仍需报告搜索结果为空，让用户确认后继续

快速使用示例

# 新项目完整流程
"我要开发一个AI知识库问答系统，请帮我完成从技术选型到开发的完整流程"

# 阶段-1：技术栈调研
"请为我调研适合开发电商后台管理系统的技术栈，我倾向使用TypeScript"

# 老项目初始化
"这是一个已有的React项目，请按阶段0搭建文档驱动开发体系"

# 阶段3：开发前生成计划
"请为用户模块开发生成实施计划"

# 阶段5：需求变更
"请按阶段5处理需求变更：用户模块增加头像上传功能"

工作流程图

flowchart TB
    A[启动] --> B{项目类型判断}
    B -->|新项目| C[阶段-1: 技术栈调研]
    B -->|老项目| D[阶段0: 项目初始化]

    C --> C1[解析需求定位项目]
    C1 --> C2[AskUserQuestion: 选择主语言]
    C2 --> C3[技术栈智能调研]
    C3 --> C4[用户确认技术栈]
    C4 --> C5[生成技术选型报告]
    C5 --> C6[生成AGENTS.md]
    C6 --> C7[自动搜索技术栈Skills]

    C7 --> C8[解析AGENTS.md技术栈]
    C8 --> C9[执行find-skills搜索]
    C9 --> C10[用户确认引入Skills]
    C10 --> D

    D --> D1{项目类型}
    D1 -->|新项目| D2[定义全局规范]
    D1 -->|老项目| D3[分析现有代码]
    D2 --> D5[搭建docs体系]
    D3 --> D4[生成AGENTS.md]
    D4 --> D5
    D5 --> D6[搭建依赖矩阵]
    D6 --> D7[首次备份v1.0.0]

    D7 --> E[阶段1: 需求标准化]
    E --> E1[需求拆解分配ID]
    E1 --> E2[生成prd/srs.md]
    E2 --> E3[分模块需求文档]
    E3 --> E4[更新依赖矩阵]

    E4 --> F[阶段2: 架构设计]
    F --> F1[系统架构设计]
    F --> F2[前端UI设计]
    F --> F3[后端接口设计]
    F1 --> FX[架构设计文档]
    F2 --> FX
    F3 --> FX

    FX --> G[阶段3: 模块化开发]
    G --> G1[生成实施计划PLAN]
    G1 --> G2[用户确认计划]
    G2 --> G3[前置校验文档]
    G3 --> G4[标记计划执行中]
    G4 --> G5[前端开发]
    G4 --> G6[后端开发]
    G4 --> G8[CLI开发]
    G4 --> G9[XXX开发]
    G5 --> G7[单元测试]
    G6 --> G7
    G7 --> G8[归档计划]

    G8 --> H[阶段4: 集成测试]
    H --> H1[集成联调]
    H1 --> H2[全量测试]
    H2 --> H3[上线交付]

    H3 --> I{需求变更?}
    I -->|有变更| J[阶段5: 变更闭环]
    J --> J1[备份影响分析]
    J1 --> J2[文档同步]
    J2 --> J3[代码变更]
    J3 --> G
    I -->|无变更| K[完成]

⚠️ 技术栈 Skill 自动发现（阶段-1 后强制执行）

🔴 重要提醒：此步骤是阶段-1准出的强制条件，必须执行！ 若未执行此步骤，阶段-1视为未完成，不得进入阶段0！

在阶段-1技术栈确定后，必须自动搜索并引入相关技术栈规范 Skill，确保开发符合最佳实践。

执行时机（强制）

⏰ 必须执行时间点：
阶段-1完成 → AGENTS.md 生成 → 立即执行技术栈Skills搜索 → 用户确认 → 安装 → 进入阶段0

禁止跳过此步骤！即使搜索结果为空，也需向用户报告。

使用 find-skills 指令

# 基本搜索语法
/find-skills <技术关键词>

# 示例：搜索前端框架相关 skills
/find-skills react
/find-skills vue
/find-skills nextjs
/find-skills typescript

# 示例：搜索后端框架相关 skills
/find-skills fastapi
/find-skills nestjs
/find-skills spring-boot
/find-skills golang

# 示例：搜索数据库相关 skills
/find-skills postgresql
/find-skills prisma
/find-skills mongodb

# 示例：搜索 AI 相关 skills
/find-skills langchain
/find-skills langgraph
/find-skills rag

自动搜索映射表

根据 AGENTS.md 中锁定的技术栈，自动执行对应搜索：

执行流程

阶段-1完成 → 解析AGENTS.md技术栈 → 遍历技术栈清单 → 
对每项技术执行 /find-skills → 评估搜索结果 → 
AskUserQuestion确认引入哪些skills → 安装选定的skills → 
进入阶段0

Skill 引入确认

搜索到相关 skills 后，使用 AskUserQuestion 让用户确认：

找到以下技术栈相关 Skills：
1. [skill-name-1] - 描述
2. [skill-name-2] - 描述
3. [skill-name-3] - 描述

请选择需要引入的 Skills：
□ skill-name-1 (推荐)
□ skill-name-2
□ skill-name-3
□ 全部引入
□ 跳过

执行入口流程

启动时执行：

1. 判断项目类型（新项目/老项目）→ 参考 global-rules.md
2. 根据项目类型选择起始阶段 → 参考 workflow-phases.md
3. 🔴 新项目：阶段-1完成后必须自动搜索技术栈 skills → 使用 /find-skills 指令（强制步骤，不可跳过）
4. 按需引入相关模板文档执行

⚠️ 执行检查清单（AI必须自检）

在执行阶段-1时，AI必须确认以下检查项：

禁止跳过检查项！所有强制项必须满足才能进入阶段0。