johsnon
279 lines
7.8 KiB
Markdown
279 lines
7.8 KiB
Markdown
# 第 2 阶段手册 — 基础与脚手架
|
||
|
||
> **时长**：3-5 天 | **智能体**：6 个 | **守门人**：DevOps 自动化师 + 证据收集者
|
||
|
||
---
|
||
|
||
## 目标
|
||
|
||
搭好后续所有工作的技术和运营基础。先把骨架立起来，再往上加肉。这个阶段结束后，每个开发者都有可用的开发环境、可部署的流水线、和可用的设计系统。
|
||
|
||
## 前提条件
|
||
|
||
- [ ] 第 1 阶段质量门禁通过（架构包已批准）
|
||
- [ ] 收到第 1 阶段交接包
|
||
- [ ] 所有架构文档已定稿
|
||
|
||
## 智能体激活顺序
|
||
|
||
### 工作流 A：基础设施（第 1-3 天，并行）
|
||
|
||
#### DevOps 自动化师 — CI/CD 流水线 + 基础设施
|
||
```
|
||
激活 DevOps 自动化师，为 [项目] 搭建基础设施。
|
||
|
||
输入：后端架构师系统架构 + 部署要求
|
||
交付要求：
|
||
1. CI/CD 流水线（GitHub Actions / GitLab CI）
|
||
- 安全扫描阶段
|
||
- 自动化测试阶段
|
||
- 构建和容器化阶段
|
||
- 部署阶段（蓝绿或金丝雀）
|
||
- 自动回滚能力
|
||
2. 基础设施即代码
|
||
- 环境配置（开发、预发布、生产）
|
||
- 容器编排配置
|
||
- 网络和安全配置
|
||
3. 环境配置
|
||
- 密钥管理
|
||
- 环境变量管理
|
||
- 多环境一致性
|
||
|
||
要创建的文件：
|
||
- .github/workflows/ci-cd.yml（或等效配置）
|
||
- infrastructure/（Terraform/CDK 模板）
|
||
- docker-compose.yml
|
||
- Dockerfile
|
||
|
||
格式：可运行的 CI/CD 流水线 + IaC 模板
|
||
时间线：3 天
|
||
```
|
||
|
||
#### 基础设施运维师 — 云基础设施 + 监控
|
||
```
|
||
激活基础设施运维师，为 [项目] 搭建监控。
|
||
|
||
输入：DevOps 自动化师基础设施 + 后端架构师架构
|
||
交付要求：
|
||
1. 云资源配置
|
||
- 计算、存储、网络资源
|
||
- 自动伸缩配置
|
||
- 负载均衡配置
|
||
2. 监控体系
|
||
- 应用指标（Prometheus/DataDog）
|
||
- 基础设施指标
|
||
- 自定义仪表盘（Grafana）
|
||
3. 日志和告警
|
||
- 集中式日志收集
|
||
- 关键阈值的告警规则
|
||
- 值班通知配置
|
||
4. 安全加固
|
||
- 防火墙规则
|
||
- SSL/TLS 配置
|
||
- 访问控制策略
|
||
|
||
格式：基础设施就绪报告 + 仪表盘访问入口
|
||
时间线：3 天
|
||
```
|
||
|
||
#### 工作室运营 — 流程搭建
|
||
```
|
||
激活工作室运营，为 [项目] 搭建流程。
|
||
|
||
输入：Sprint 排序师计划 + 项目牧羊人协调需求
|
||
交付要求：
|
||
1. Git 工作流
|
||
- 分支策略（GitFlow / 主干开发）
|
||
- PR 审核流程
|
||
- 合并策略
|
||
2. 沟通渠道
|
||
- 团队频道搭建
|
||
- 通知路由
|
||
- 状态更新节奏
|
||
3. 文档模板
|
||
- PR 模板
|
||
- Issue 模板
|
||
- 决策日志模板
|
||
4. 协作工具
|
||
- 项目看板搭建
|
||
- Sprint 追踪配置
|
||
|
||
格式：运营手册
|
||
时间线：2 天
|
||
```
|
||
|
||
### 工作流 B：应用基础（第 1-4 天，并行）
|
||
|
||
#### 前端开发者 — 项目脚手架 + 组件库
|
||
```
|
||
激活前端开发者，为 [项目] 搭建项目脚手架。
|
||
|
||
输入：UX 架构师 CSS 设计系统 + 品牌守护者品牌识别
|
||
交付要求：
|
||
1. 项目脚手架
|
||
- 框架搭建（React/Vue/Angular，按架构定）
|
||
- TypeScript 配置
|
||
- 构建工具（Vite/Webpack/Next.js）
|
||
- 测试框架（Jest/Vitest + Testing Library）
|
||
2. 设计系统实现
|
||
- UX 架构师的 CSS 设计 token
|
||
- 基础组件库（Button, Input, Card, Layout）
|
||
- 主题系统（亮色/暗色/跟随系统切换）
|
||
- 响应式工具
|
||
3. 应用外壳
|
||
- 路由搭建
|
||
- 布局组件（Header, Footer, Sidebar）
|
||
- 错误边界实现
|
||
- 加载状态
|
||
|
||
要创建的文件：
|
||
- src/（应用源码）
|
||
- src/components/（组件库）
|
||
- src/styles/（设计 token）
|
||
- src/layouts/（布局组件）
|
||
|
||
格式：可运行的应用骨架 + 组件库
|
||
时间线：3 天
|
||
```
|
||
|
||
#### 后端架构师 — 数据库 + API 基础
|
||
```
|
||
激活后端架构师，为 [项目] 搭建 API 基础。
|
||
|
||
输入：系统架构文档 + 数据库 Schema 设计
|
||
交付要求：
|
||
1. 数据库搭建
|
||
- Schema 部署（迁移脚本）
|
||
- 索引创建
|
||
- 开发用种子数据
|
||
- 连接池配置
|
||
2. API 骨架
|
||
- 框架搭建（Express/FastAPI 等）
|
||
- 按架构搭好路由结构
|
||
- 中间件体系（认证、校验、错误处理、CORS）
|
||
- 健康检查端点
|
||
3. 认证系统
|
||
- 认证提供商集成
|
||
- JWT/Session 管理
|
||
- 基于角色的访问控制骨架
|
||
4. 服务通信
|
||
- API 版本管理
|
||
- 请求/响应序列化
|
||
- 错误响应标准化
|
||
|
||
要创建的文件：
|
||
- api/ 或 server/（后端源码）
|
||
- migrations/（数据库迁移）
|
||
- docs/api-spec.yaml（OpenAPI 文档）
|
||
|
||
格式：可运行的 API 骨架 + 数据库 + 认证
|
||
时间线：4 天
|
||
```
|
||
|
||
#### UX 架构师 — CSS 系统实现
|
||
```
|
||
激活 UX 架构师，为 [项目] 实现 CSS 系统。
|
||
|
||
输入：品牌守护者品牌识别 + 自己第 1 阶段的 CSS 设计系统规范
|
||
交付要求：
|
||
1. 设计 Token 实现
|
||
- CSS 自定义属性（颜色、字体、间距）
|
||
- 品牌色板 + 语义化命名
|
||
- 响应式字体比例尺
|
||
2. 布局系统
|
||
- 容器系统（响应式断点）
|
||
- 网格模式（2 栏、3 栏、侧边栏）
|
||
- Flexbox 工具类
|
||
3. 主题系统
|
||
- 亮色主题变量
|
||
- 暗色主题变量
|
||
- 系统偏好检测
|
||
- 主题切换组件
|
||
- 主题间的平滑过渡
|
||
|
||
要创建/更新的文件：
|
||
- css/design-system.css（或框架中的等效文件）
|
||
- css/layout.css
|
||
- css/components.css
|
||
- js/theme-manager.js
|
||
|
||
格式：已实现的 CSS 设计系统 + 主题切换
|
||
时间线：2 天
|
||
```
|
||
|
||
## 验证检查点（第 4-5 天）
|
||
|
||
### 证据收集者验证
|
||
```
|
||
激活证据收集者，验证第 2 阶段基础搭建。
|
||
|
||
用截图证据验证以下项目：
|
||
1. CI/CD 流水线成功执行（展示流水线日志）
|
||
2. 应用骨架在浏览器中正常加载（桌面端截图）
|
||
3. 应用骨架在手机上正常加载（手机截图）
|
||
4. 主题切换正常工作（亮色 + 暗色截图）
|
||
5. API 健康检查有响应（curl 输出）
|
||
6. 数据库可访问（迁移状态）
|
||
7. 监控仪表盘在线（仪表盘截图）
|
||
8. 组件库可渲染（组件演示页面）
|
||
|
||
格式：证据包 + 截图
|
||
判定：通过 / 不通过，不通过时列出具体问题
|
||
```
|
||
|
||
## 质量门禁检查清单
|
||
|
||
| # | 标准 | 证据来源 | 状态 |
|
||
|---|------|---------|------|
|
||
| 1 | CI/CD 流水线能构建、测试和部署 | 流水线执行日志 | |
|
||
| 2 | 数据库 Schema 已部署，表和索引都建好了 | 迁移成功的输出 | |
|
||
| 3 | API 骨架在健康检查端点上有响应 | curl 响应证据 | |
|
||
| 4 | 前端骨架在浏览器中正常渲染 | 证据收集者截图 | |
|
||
| 5 | 监控仪表盘在显示指标 | 仪表盘截图 | |
|
||
| 6 | 设计系统 token 已实现 | 组件库演示 | |
|
||
| 7 | 主题切换可用（亮色/暗色/跟随系统） | 切换前后截图 | |
|
||
| 8 | Git 工作流和流程已文档化 | 工作室运营手册 | |
|
||
|
||
## 门禁决策
|
||
|
||
**需要双签**：DevOps 自动化师（基础设施层面）+ 证据收集者（视觉层面）
|
||
|
||
- **通过**：骨架应用可运行 + 完整 DevOps 流水线 → 激活第 3 阶段
|
||
- **不通过**：具体的基础设施或应用问题 → 修复后重新验证
|
||
|
||
## 交接给第 3 阶段
|
||
|
||
```markdown
|
||
## 第 2 阶段 → 第 3 阶段交接包
|
||
|
||
### 给所有开发智能体的：
|
||
- 可运行的 CI/CD 流水线（合并后自动部署）
|
||
- 设计系统 token 和组件库
|
||
- API 骨架 + 认证 + 健康检查
|
||
- 数据库 + Schema + 种子数据
|
||
- Git 工作流和 PR 流程
|
||
|
||
### 给证据收集者（持续 QA）的：
|
||
- 应用地址（开发、预发布）
|
||
- 截图采集方法
|
||
- 组件库参考
|
||
- 视觉验证用的品牌规范
|
||
|
||
### 给智能体编排者（管理开发-测试循环）的：
|
||
- Sprint 排序师的待办列表（来自第 1 阶段）
|
||
- 带验收标准的任务清单（来自第 1 阶段）
|
||
- 智能体分配矩阵（来自 NEXUS 策略）
|
||
- 各类任务的质量阈值
|
||
|
||
### 环境访问：
|
||
- 开发环境：[URL]
|
||
- 预发布环境：[URL]
|
||
- 监控仪表盘：[URL]
|
||
- CI/CD 流水线：[URL]
|
||
- API 文档：[URL]
|
||
```
|
||
|
||
---
|
||
|
||
*当骨架应用跑起来、CI/CD 流水线可用、证据收集者用截图验证了所有基础组件后，第 2 阶段结束。*
|