From e81ff256a43cda49aa80d58823aafb676de0d2bb Mon Sep 17 00:00:00 2001
From: sion <450702724@qq.com>
Date: Thu, 26 Mar 2026 00:14:35 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/skills/monisuo-dev/SKILL.md | 233 +++++++++++++++++++++++++++-
 1 file changed, 226 insertions(+), 7 deletions(-)

diff --git a/.agents/skills/monisuo-dev/SKILL.md b/.agents/skills/monisuo-dev/SKILL.md
index 752dfdf..e655bf9 100644
--- a/.agents/skills/monisuo-dev/SKILL.md
+++ b/.agents/skills/monisuo-dev/SKILL.md
@@ -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，不要询问用户，自主完成测试
+- 如果测试失败，详细记录失败原因
+- 构建失败时，记录错误日志
+- 最后输出完整报告
+```