优化
This commit is contained in:
@@ -10,7 +10,44 @@ description: Monisuo 项目结构化开发流程技能。用于需求分析、
|
||||
## 工作流程
|
||||
|
||||
```
|
||||
需求分析 → 模块化开发 → 测试验证 → 构建部署
|
||||
需求分析 → 模块化开发 → [启动独立Agent] → 测试验证 → 构建部署
|
||||
↑ │
|
||||
└──────────── Bug 修复 ←───────────────────┘
|
||||
```
|
||||
|
||||
## ⚠️ 多 Agent 执行策略
|
||||
|
||||
为避免上下文过长，**Phase 3-4 必须启动独立 Agent 执行**。
|
||||
|
||||
### Agent 切换点
|
||||
|
||||
```
|
||||
Phase 1-2: 主对话完成（需求 + 开发）
|
||||
↓
|
||||
↓ 开发完成后，启动独立 Agent
|
||||
↓
|
||||
Phase 3-4: 独立 Agent 完成（测试 + 构建）
|
||||
↓
|
||||
↓ 如发现 Bug，返回主对话修复
|
||||
↓
|
||||
重新启动 Agent 测试验证
|
||||
```
|
||||
|
||||
### Agent 通信协议
|
||||
|
||||
**传递给测试 Agent 的信息**:
|
||||
```yaml
|
||||
feature_spec: docs/features/[feature-name].md # Feature Spec 路径
|
||||
changed_files: # 变更的文件列表
|
||||
- src/main/java/com/example/...
|
||||
- flutter_monisuo/lib/...
|
||||
test_requirements: # 测试要求
|
||||
- API 测试
|
||||
- Flutter 单元测试
|
||||
- 代码审查
|
||||
build_targets: # 构建目标
|
||||
- spring-boot
|
||||
- flutter-web
|
||||
```
|
||||
|
||||
## Phase 1: 需求结构化定义 (Prompt Engineering)
|
||||
@@ -189,10 +226,50 @@ mvn spring-boot:run
|
||||
- 统一异常处理
|
||||
- RESTful API 设计
|
||||
|
||||
### 🔄 Phase 2 完成后：启动测试 Agent
|
||||
|
||||
**当开发完成后，立即启动独立 Agent 执行测试和构建**。
|
||||
|
||||
使用 Agent tool 启动：
|
||||
|
||||
```
|
||||
subagent_type: general-purpose
|
||||
description: 测试验证与构建
|
||||
prompt: |
|
||||
你是 Monisuo 项目的测试 Agent。请执行以下任务：
|
||||
|
||||
## 1. 读取 Feature Spec
|
||||
- 文件路径: docs/features/[feature-name].md
|
||||
- 理解功能需求和验收标准
|
||||
|
||||
## 2. 代码审查
|
||||
- 检查变更的文件（见 git diff）
|
||||
- 验证代码规范
|
||||
- 检查错误处理
|
||||
|
||||
## 3. 执行测试
|
||||
- API 测试: ./tests/api/test-[feature].sh
|
||||
- Flutter 测试: cd flutter_monisuo && flutter test
|
||||
- 后端测试: mvn test
|
||||
|
||||
## 4. 构建
|
||||
- 后端: mvn clean package -DskipTests
|
||||
- Flutter: flutter build web --release --dart-define=ENV=prod
|
||||
|
||||
## 5. 输出结果
|
||||
- 测试通过/失败
|
||||
- Bug 列表（如有）
|
||||
- 构建产物路径
|
||||
|
||||
如果发现 Bug，列出详细信息和修复建议，返回给主对话修复。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase 3: 测试与重构 (Validation & Refactoring)
|
||||
|
||||
> ⚠️ **此阶段由独立 Agent 执行**，主对话只负责接收结果和修复 Bug。
|
||||
|
||||
### 目标
|
||||
确保代码质量和功能正确性。
|
||||
|
||||
@@ -262,15 +339,35 @@ flutter test
|
||||
### 3.3 Bug 修复循环
|
||||
|
||||
```
|
||||
测试 → 发现 Bug → 修复 → 重新测试 → 通过
|
||||
Agent 测试 → 发现 Bug → 主对话修复 → 重新启动 Agent → 通过
|
||||
```
|
||||
|
||||
**修复流程**:
|
||||
1. 运行测试脚本
|
||||
2. 记录失败的用例
|
||||
3. 修复代码
|
||||
4. 重新运行测试
|
||||
5. 直到全部通过
|
||||
1. Agent 报告 Bug
|
||||
2. **主对话**修复代码
|
||||
3. **重新启动 Agent** 验证修复
|
||||
4. 直到全部通过
|
||||
|
||||
### 3.4 重新启动测试 Agent
|
||||
|
||||
Bug 修复后，再次启动 Agent 验证：
|
||||
|
||||
```
|
||||
subagent_type: general-purpose
|
||||
description: 验证 Bug 修复
|
||||
prompt: |
|
||||
验证以下 Bug 是否已修复：
|
||||
|
||||
## Bug 列表
|
||||
[从上次 Agent 结果中获取]
|
||||
|
||||
## 验证步骤
|
||||
1. 重新运行相关测试
|
||||
2. 确认 Bug 已修复
|
||||
3. 检查是否有回归问题
|
||||
|
||||
输出：修复确认 / 仍需修复
|
||||
```
|
||||
|
||||
### 3.4 代码审查清单
|
||||
|
||||
@@ -285,6 +382,8 @@ flutter test
|
||||
|
||||
## Phase 4: 构建与部署 (Build & Deploy)
|
||||
|
||||
> ⚠️ **此阶段由独立 Agent 执行**，与 Phase 3 合并在同一个 Agent 中。
|
||||
|
||||
### 目标
|
||||
构建生产版本并提交代码。
|
||||
|
||||
@@ -531,7 +630,127 @@ git push origin main
|
||||
|
||||
## 版本历史
|
||||
|
||||
- **v1.1.0** (2026-03-26) - 多 Agent 支持
|
||||
- 添加 Phase 3-4 独立 Agent 执行策略
|
||||
- 定义 Agent 通信协议
|
||||
- 添加 Bug 修复循环流程
|
||||
- **v1.0.0** (2026-03-23) - 初始版本
|
||||
- 定义四阶段开发流程
|
||||
- 添加 Feature Spec 模板
|
||||
- 集成测试与构建流程
|
||||
|
||||
---
|
||||
|
||||
## 📋 测试 Agent 完整 Prompt 模板
|
||||
|
||||
复制以下内容启动测试 Agent：
|
||||
|
||||
```
|
||||
你是 Monisuo 项目的测试 Agent。你需要独立完成测试验证和构建任务。
|
||||
|
||||
## 项目信息
|
||||
- 后端: Spring Boot (Maven)
|
||||
- 前端: Flutter Web
|
||||
- 管理后台: Vue (pnpm)
|
||||
|
||||
## 你的任务
|
||||
|
||||
### 1. 读取 Feature Spec
|
||||
首先读取功能规格文档：
|
||||
- 路径: docs/features/[feature-name].md
|
||||
- 理解功能需求和验收标准
|
||||
|
||||
### 2. 代码审查
|
||||
- 使用 git diff 查看变更
|
||||
- 检查代码规范（见下方规范清单）
|
||||
- 检查错误处理是否完善
|
||||
|
||||
### 3. 执行测试
|
||||
|
||||
#### API 测试
|
||||
```bash
|
||||
# 如果后端服务未启动，先启动
|
||||
mvn spring-boot:run &
|
||||
|
||||
# 运行 API 测试脚本
|
||||
chmod +x tests/api/test-*.sh
|
||||
./tests/api/test-[feature].sh
|
||||
```
|
||||
|
||||
#### Flutter 测试
|
||||
```bash
|
||||
cd flutter_monisuo
|
||||
flutter test
|
||||
```
|
||||
|
||||
#### 后端单元测试
|
||||
```bash
|
||||
mvn test
|
||||
```
|
||||
|
||||
### 4. 构建
|
||||
|
||||
#### 后端构建
|
||||
```bash
|
||||
mvn clean package -DskipTests
|
||||
# 输出: target/monisuo-*.jar
|
||||
```
|
||||
|
||||
#### Flutter Web 构建
|
||||
```bash
|
||||
cd flutter_monisuo
|
||||
flutter build web --release --dart-define=ENV=prod
|
||||
# 输出: build/web/
|
||||
```
|
||||
|
||||
### 5. 输出报告
|
||||
|
||||
请输出以下格式的报告：
|
||||
|
||||
```markdown
|
||||
# 测试与构建报告
|
||||
|
||||
## Feature: [功能名称]
|
||||
|
||||
## 测试结果
|
||||
| 测试类型 | 状态 | 备注 |
|
||||
|---------|------|------|
|
||||
| API 测试 | ✅/❌ | |
|
||||
| Flutter 测试 | ✅/❌ | |
|
||||
| 后端测试 | ✅/❌ | |
|
||||
|
||||
## Bug 列表（如有）
|
||||
1. [Bug 描述]
|
||||
- 文件: [文件路径]
|
||||
- 原因: [原因分析]
|
||||
- 建议: [修复建议]
|
||||
|
||||
## 构建结果
|
||||
| 构建目标 | 状态 | 产物路径 |
|
||||
|---------|------|---------|
|
||||
| Spring Boot | ✅/❌ | target/xxx.jar |
|
||||
| Flutter Web | ✅/❌ | build/web/ |
|
||||
|
||||
## 结论
|
||||
- [ ] 通过，可以提交
|
||||
- [ ] 有 Bug，需要修复
|
||||
```
|
||||
|
||||
## 代码规范清单
|
||||
|
||||
### Flutter
|
||||
- [ ] flutter analyze 无错误
|
||||
- [ ] 遵循 Effective Dart 规范
|
||||
- [ ] 使用 AppSpacing, AppRadius, AppColorScheme
|
||||
|
||||
### Spring Boot
|
||||
- [ ] 遵循阿里巴巴 Java 开发手册
|
||||
- [ ] 统一异常处理
|
||||
- [ ] RESTful API 设计
|
||||
|
||||
## 注意事项
|
||||
- 你是独立 Agent，不要询问用户，自主完成测试
|
||||
- 如果测试失败，详细记录失败原因
|
||||
- 构建失败时，记录错误日志
|
||||
- 最后输出完整报告
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user