141 lines
3.9 KiB
Markdown
141 lines
3.9 KiB
Markdown
---
|
||
name: monisuo-dev
|
||
description: Monisuo 项目结构化开发流程。需求分析 → 架构设计 → 开发 → 测试构建。
|
||
---
|
||
|
||
# Monisuo 开发工作流
|
||
|
||
## 流程概览
|
||
|
||
```
|
||
Phase 1: 需求定义 → Phase 1.5: 架构设计 → Phase 2: 模块化开发 → [启动 Agent] → Phase 3-4: 测试+构建
|
||
↑ │
|
||
└──────────────────────── Bug 修复 ←─────────────────────────────────────────┘
|
||
```
|
||
|
||
**Phase 1-1.5-2 在主对话完成，Phase 3-4 启动独立 Agent。**
|
||
|
||
---
|
||
|
||
## Phase 1: 需求定义
|
||
|
||
将用户需求结构化为 Feature Spec，输出到 `docs/features/[feature-name].md`。
|
||
|
||
### Feature Spec 结构
|
||
|
||
```markdown
|
||
# [功能名称]
|
||
|
||
## 概述
|
||
功能名称 / 优先级(P0-P2) / 业务背景(痛点→方案→收益)
|
||
|
||
## 用户故事
|
||
作为 [角色]，我希望 [行为]，以便 [目的]
|
||
|
||
## 功能列表
|
||
- [ ] 功能点1
|
||
- [ ] 功能点2
|
||
|
||
## 技术方案（Phase 1.5 填充）
|
||
### API 设计
|
||
### 数据模型
|
||
### 技术决策
|
||
|
||
## 测试用例
|
||
- [ ] 正常 / 异常 / 边界
|
||
|
||
## 验收标准
|
||
```
|
||
|
||
### 执行步骤
|
||
1. 与用户确认需求，识别关键场景和约束
|
||
2. 创建 `docs/features/[feature-name].md`，填充概述、用户故事、功能列表、测试用例
|
||
3. 与用户评审确认
|
||
|
||
---
|
||
|
||
## Phase 1.5: 架构设计
|
||
|
||
编码前确定技术方案。**必须先探索代码库再设计。**
|
||
|
||
### 执行步骤
|
||
|
||
1. **探索现有代码库**
|
||
- Glob/Grep/Read 扫描相关模块，理解现有模式和架构
|
||
- 识别可复用的组件、Service、工具类
|
||
- 确认集成点
|
||
|
||
2. **定义 API 契约** — 方法、路径、请求/响应体，写入 Spec 的「API 设计」
|
||
|
||
3. **设计数据模型** — 表结构、Entity/DTO/VO 映射，写入 Spec 的「数据模型」
|
||
|
||
4. **记录技术决策** — 选型理由、模块职责、关键约束，写入 Spec 的「技术决策」
|
||
|
||
### 完成标准
|
||
- 已扫描现有代码，无重复造轮子
|
||
- API 契约完整，前后端可并行开发
|
||
- 数据模型与现有表结构兼容
|
||
|
||
---
|
||
|
||
## Phase 2: 模块化开发
|
||
|
||
依据 Spec 中的 API 契约和数据模型，自底向上开发：
|
||
|
||
```
|
||
1. 数据层 → 2. 后端 API → 3. 前端实现
|
||
DDL/Entity Controller/Service Model/Provider/UI
|
||
```
|
||
|
||
### 代码规范
|
||
- Flutter: `flutter analyze` 无错，用 AppSpacing/AppRadius/AppColorScheme，禁止硬编码颜色
|
||
- Java: Lombok 简化，资金变动方法加 `@Transactional(rollbackFor = Exception.class)`，RESTful 设计
|
||
|
||
---
|
||
|
||
## Phase 3-4: 测试与构建（独立 Agent）
|
||
|
||
Phase 2 完成后，启动独立 Agent 执行测试和构建。
|
||
|
||
### 启动 Agent
|
||
|
||
```
|
||
Agent(
|
||
description: "测试验证与构建",
|
||
prompt: |
|
||
你是 Monisuo 项目测试 Agent，独立完成以下任务，不要询问用户。
|
||
|
||
## 1. 读取 Spec
|
||
- 路径: docs/features/[feature-name].md
|
||
- 理解验收标准
|
||
|
||
## 2. 代码审查
|
||
- git diff 查看变更
|
||
- Flutter: flutter analyze, AppSpacing/AppRadius/AppColorScheme 规范
|
||
- Java: @Transactional 资金方法, 统一异常处理, RESTful 设计
|
||
|
||
## 3. 测试
|
||
- 后端: mvn test
|
||
- Flutter: cd flutter_monisuo && flutter test
|
||
- API: ./tests/api/test-[feature].sh（如存在）
|
||
|
||
## 4. 构建
|
||
- 后端: mvn clean package -DskipTests → target/monisuo-*.jar
|
||
- Flutter: cd flutter_monisuo && flutter build web --release --dart-define=ENV=prod → build/web/
|
||
|
||
## 5. 输出报告
|
||
| 项目 | 状态 | 备注 |
|
||
|------|------|------|
|
||
| 代码审查 | ✅/❌ | |
|
||
| 后端测试 | ✅/❌ | |
|
||
| Flutter 测试 | ✅/❌ | |
|
||
| 后端构建 | ✅/❌ | |
|
||
| Flutter 构建 | ✅/❌ | |
|
||
|
||
如有 Bug，列出：文件、原因、修复建议。返回主对话修复后重新验证。
|
||
)
|
||
```
|
||
|
||
### Bug 修复循环
|
||
Agent 发现 Bug → 主对话修复 → 重新启动 Agent 验证 → 全部通过
|